Home | History | Annotate | Download | only in net
      1 /*
      2  * Copyright (C) 2010 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package libcore.net;
     18 
     19 import java.io.File;
     20 import java.io.FileInputStream;
     21 import java.io.IOException;
     22 import java.io.InputStream;
     23 import java.util.HashMap;
     24 import java.util.Map;
     25 import java.util.Properties;
     26 
     27 /**
     28  * Utilities for dealing with MIME types.
     29  * Used to implement java.net.URLConnection and android.webkit.MimeTypeMap.
     30  */
     31 public final class MimeUtils {
     32     private static final Map<String, String> mimeTypeToExtensionMap = new HashMap<String, String>();
     33 
     34     private static final Map<String, String> extensionToMimeTypeMap = new HashMap<String, String>();
     35 
     36     static {
     37         // The following table is based on /etc/mime.types data minus
     38         // chemical/* MIME types and MIME types that don't map to any
     39         // file extensions. We also exclude top-level domain names to
     40         // deal with cases like:
     41         //
     42         // mail.google.com/a/google.com
     43         //
     44         // and "active" MIME types (due to potential security issues).
     45 
     46         // Note that this list is _not_ in alphabetical order and must not be sorted.
     47         // The "most popular" extension must come first, so that it's the one returned
     48         // by guessExtensionFromMimeType.
     49 
     50         add("application/andrew-inset", "ez");
     51         add("application/dsptype", "tsp");
     52         add("application/futuresplash", "spl");
     53         add("application/hta", "hta");
     54         add("application/mac-binhex40", "hqx");
     55         add("application/mac-compactpro", "cpt");
     56         add("application/mathematica", "nb");
     57         add("application/msaccess", "mdb");
     58         add("application/oda", "oda");
     59         add("application/ogg", "ogg");
     60         add("application/pdf", "pdf");
     61         add("application/pgp-keys", "key");
     62         add("application/pgp-signature", "pgp");
     63         add("application/pics-rules", "prf");
     64         add("application/rar", "rar");
     65         add("application/rdf+xml", "rdf");
     66         add("application/rss+xml", "rss");
     67         add("application/zip", "zip");
     68         add("application/vnd.android.package-archive", "apk");
     69         add("application/vnd.cinderella", "cdy");
     70         add("application/vnd.ms-pki.stl", "stl");
     71         add("application/vnd.oasis.opendocument.database", "odb");
     72         add("application/vnd.oasis.opendocument.formula", "odf");
     73         add("application/vnd.oasis.opendocument.graphics", "odg");
     74         add("application/vnd.oasis.opendocument.graphics-template", "otg");
     75         add("application/vnd.oasis.opendocument.image", "odi");
     76         add("application/vnd.oasis.opendocument.spreadsheet", "ods");
     77         add("application/vnd.oasis.opendocument.spreadsheet-template", "ots");
     78         add("application/vnd.oasis.opendocument.text", "odt");
     79         add("application/vnd.oasis.opendocument.text-master", "odm");
     80         add("application/vnd.oasis.opendocument.text-template", "ott");
     81         add("application/vnd.oasis.opendocument.text-web", "oth");
     82         add("application/vnd.google-earth.kml+xml", "kml");
     83         add("application/vnd.google-earth.kmz", "kmz");
     84         add("application/msword", "doc");
     85         add("application/msword", "dot");
     86         add("application/vnd.openxmlformats-officedocument.wordprocessingml.document", "docx");
     87         add("application/vnd.openxmlformats-officedocument.wordprocessingml.template", "dotx");
     88         add("application/vnd.ms-excel", "xls");
     89         add("application/vnd.ms-excel", "xlt");
     90         add("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "xlsx");
     91         add("application/vnd.openxmlformats-officedocument.spreadsheetml.template", "xltx");
     92         add("application/vnd.ms-powerpoint", "ppt");
     93         add("application/vnd.ms-powerpoint", "pot");
     94         add("application/vnd.ms-powerpoint", "pps");
     95         add("application/vnd.openxmlformats-officedocument.presentationml.presentation", "pptx");
     96         add("application/vnd.openxmlformats-officedocument.presentationml.template", "potx");
     97         add("application/vnd.openxmlformats-officedocument.presentationml.slideshow", "ppsx");
     98         add("application/vnd.rim.cod", "cod");
     99         add("application/vnd.smaf", "mmf");
    100         add("application/vnd.stardivision.calc", "sdc");
    101         add("application/vnd.stardivision.draw", "sda");
    102         add("application/vnd.stardivision.impress", "sdd");
    103         add("application/vnd.stardivision.impress", "sdp");
    104         add("application/vnd.stardivision.math", "smf");
    105         add("application/vnd.stardivision.writer", "sdw");
    106         add("application/vnd.stardivision.writer", "vor");
    107         add("application/vnd.stardivision.writer-global", "sgl");
    108         add("application/vnd.sun.xml.calc", "sxc");
    109         add("application/vnd.sun.xml.calc.template", "stc");
    110         add("application/vnd.sun.xml.draw", "sxd");
    111         add("application/vnd.sun.xml.draw.template", "std");
    112         add("application/vnd.sun.xml.impress", "sxi");
    113         add("application/vnd.sun.xml.impress.template", "sti");
    114         add("application/vnd.sun.xml.math", "sxm");
    115         add("application/vnd.sun.xml.writer", "sxw");
    116         add("application/vnd.sun.xml.writer.global", "sxg");
    117         add("application/vnd.sun.xml.writer.template", "stw");
    118         add("application/vnd.visio", "vsd");
    119         add("application/x-abiword", "abw");
    120         add("application/x-apple-diskimage", "dmg");
    121         add("application/x-bcpio", "bcpio");
    122         add("application/x-bittorrent", "torrent");
    123         add("application/x-cdf", "cdf");
    124         add("application/x-cdlink", "vcd");
    125         add("application/x-chess-pgn", "pgn");
    126         add("application/x-cpio", "cpio");
    127         add("application/x-debian-package", "deb");
    128         add("application/x-debian-package", "udeb");
    129         add("application/x-director", "dcr");
    130         add("application/x-director", "dir");
    131         add("application/x-director", "dxr");
    132         add("application/x-dms", "dms");
    133         add("application/x-doom", "wad");
    134         add("application/x-dvi", "dvi");
    135         add("application/x-flac", "flac");
    136         add("application/x-font", "pfa");
    137         add("application/x-font", "pfb");
    138         add("application/x-font", "gsf");
    139         add("application/x-font", "pcf");
    140         add("application/x-font", "pcf.Z");
    141         add("application/x-freemind", "mm");
    142         add("application/x-futuresplash", "spl");
    143         add("application/x-gnumeric", "gnumeric");
    144         add("application/x-go-sgf", "sgf");
    145         add("application/x-graphing-calculator", "gcf");
    146         add("application/x-gtar", "tgz");
    147         add("application/x-gtar", "gtar");
    148         add("application/x-gtar", "taz");
    149         add("application/x-hdf", "hdf");
    150         add("application/x-ica", "ica");
    151         add("application/x-internet-signup", "ins");
    152         add("application/x-internet-signup", "isp");
    153         add("application/x-iphone", "iii");
    154         add("application/x-iso9660-image", "iso");
    155         add("application/x-jmol", "jmz");
    156         add("application/x-kchart", "chrt");
    157         add("application/x-killustrator", "kil");
    158         add("application/x-koan", "skp");
    159         add("application/x-koan", "skd");
    160         add("application/x-koan", "skt");
    161         add("application/x-koan", "skm");
    162         add("application/x-kpresenter", "kpr");
    163         add("application/x-kpresenter", "kpt");
    164         add("application/x-kspread", "ksp");
    165         add("application/x-kword", "kwd");
    166         add("application/x-kword", "kwt");
    167         add("application/x-latex", "latex");
    168         add("application/x-lha", "lha");
    169         add("application/x-lzh", "lzh");
    170         add("application/x-lzx", "lzx");
    171         add("application/x-maker", "frm");
    172         add("application/x-maker", "maker");
    173         add("application/x-maker", "frame");
    174         add("application/x-maker", "fb");
    175         add("application/x-maker", "book");
    176         add("application/x-maker", "fbdoc");
    177         add("application/x-mif", "mif");
    178         add("application/x-ms-wmd", "wmd");
    179         add("application/x-ms-wmz", "wmz");
    180         add("application/x-msi", "msi");
    181         add("application/x-ns-proxy-autoconfig", "pac");
    182         add("application/x-nwc", "nwc");
    183         add("application/x-object", "o");
    184         add("application/x-oz-application", "oza");
    185         add("application/x-pkcs12", "p12");
    186         add("application/x-pkcs12", "pfx");
    187         add("application/x-pkcs7-certreqresp", "p7r");
    188         add("application/x-pkcs7-crl", "crl");
    189         add("application/x-quicktimeplayer", "qtl");
    190         add("application/x-shar", "shar");
    191         add("application/x-shockwave-flash", "swf");
    192         add("application/x-stuffit", "sit");
    193         add("application/x-sv4cpio", "sv4cpio");
    194         add("application/x-sv4crc", "sv4crc");
    195         add("application/x-tar", "tar");
    196         add("application/x-texinfo", "texinfo");
    197         add("application/x-texinfo", "texi");
    198         add("application/x-troff", "t");
    199         add("application/x-troff", "roff");
    200         add("application/x-troff-man", "man");
    201         add("application/x-ustar", "ustar");
    202         add("application/x-wais-source", "src");
    203         add("application/x-wingz", "wz");
    204         add("application/x-webarchive", "webarchive");
    205         add("application/x-webarchive-xml", "webarchivexml");
    206         add("application/x-x509-ca-cert", "crt");
    207         add("application/x-x509-user-cert", "crt");
    208         add("application/x-xcf", "xcf");
    209         add("application/x-xfig", "fig");
    210         add("application/xhtml+xml", "xhtml");
    211         add("audio/3gpp", "3gpp");
    212         add("audio/amr", "amr");
    213         add("audio/basic", "snd");
    214         add("audio/midi", "mid");
    215         add("audio/midi", "midi");
    216         add("audio/midi", "kar");
    217         add("audio/midi", "xmf");
    218         add("audio/mobile-xmf", "mxmf");
    219         // add ".mp3" first so it will be the default for guessExtensionFromMimeType
    220         add("audio/mpeg", "mp3");
    221         add("audio/mpeg", "mpga");
    222         add("audio/mpeg", "mpega");
    223         add("audio/mpeg", "mp2");
    224         add("audio/mpeg", "m4a");
    225         add("audio/mpegurl", "m3u");
    226         add("audio/prs.sid", "sid");
    227         add("audio/x-aiff", "aif");
    228         add("audio/x-aiff", "aiff");
    229         add("audio/x-aiff", "aifc");
    230         add("audio/x-gsm", "gsm");
    231         add("audio/x-mpegurl", "m3u");
    232         add("audio/x-ms-wma", "wma");
    233         add("audio/x-ms-wax", "wax");
    234         add("audio/x-pn-realaudio", "ra");
    235         add("audio/x-pn-realaudio", "rm");
    236         add("audio/x-pn-realaudio", "ram");
    237         add("audio/x-realaudio", "ra");
    238         add("audio/x-scpls", "pls");
    239         add("audio/x-sd2", "sd2");
    240         add("audio/x-wav", "wav");
    241         add("image/bmp", "bmp");
    242         add("image/gif", "gif");
    243         add("image/ico", "cur");
    244         add("image/ico", "ico");
    245         add("image/ief", "ief");
    246         add("image/jpeg", "jpeg");
    247         add("image/jpeg", "jpg");
    248         add("image/jpeg", "jpe");
    249         add("image/pcx", "pcx");
    250         add("image/png", "png");
    251         add("image/svg+xml", "svg");
    252         add("image/svg+xml", "svgz");
    253         add("image/tiff", "tiff");
    254         add("image/tiff", "tif");
    255         add("image/vnd.djvu", "djvu");
    256         add("image/vnd.djvu", "djv");
    257         add("image/vnd.wap.wbmp", "wbmp");
    258         add("image/x-cmu-raster", "ras");
    259         add("image/x-coreldraw", "cdr");
    260         add("image/x-coreldrawpattern", "pat");
    261         add("image/x-coreldrawtemplate", "cdt");
    262         add("image/x-corelphotopaint", "cpt");
    263         add("image/x-icon", "ico");
    264         add("image/x-jg", "art");
    265         add("image/x-jng", "jng");
    266         add("image/x-ms-bmp", "bmp");
    267         add("image/x-photoshop", "psd");
    268         add("image/x-portable-anymap", "pnm");
    269         add("image/x-portable-bitmap", "pbm");
    270         add("image/x-portable-graymap", "pgm");
    271         add("image/x-portable-pixmap", "ppm");
    272         add("image/x-rgb", "rgb");
    273         add("image/x-xbitmap", "xbm");
    274         add("image/x-xpixmap", "xpm");
    275         add("image/x-xwindowdump", "xwd");
    276         add("model/iges", "igs");
    277         add("model/iges", "iges");
    278         add("model/mesh", "msh");
    279         add("model/mesh", "mesh");
    280         add("model/mesh", "silo");
    281         add("text/calendar", "ics");
    282         add("text/calendar", "icz");
    283         add("text/comma-separated-values", "csv");
    284         add("text/css", "css");
    285         add("text/html", "htm");
    286         add("text/html", "html");
    287         add("text/h323", "323");
    288         add("text/iuls", "uls");
    289         add("text/mathml", "mml");
    290         // add ".txt" first so it will be the default for guessExtensionFromMimeType
    291         add("text/plain", "txt");
    292         add("text/plain", "asc");
    293         add("text/plain", "text");
    294         add("text/plain", "diff");
    295         add("text/plain", "po");     // reserve "pot" for vnd.ms-powerpoint
    296         add("text/richtext", "rtx");
    297         add("text/rtf", "rtf");
    298         add("text/texmacs", "ts");
    299         add("text/text", "phps");
    300         add("text/tab-separated-values", "tsv");
    301         add("text/xml", "xml");
    302         add("text/x-bibtex", "bib");
    303         add("text/x-boo", "boo");
    304         add("text/x-c++hdr", "hpp");
    305         add("text/x-c++hdr", "h++");
    306         add("text/x-c++hdr", "hxx");
    307         add("text/x-c++hdr", "hh");
    308         add("text/x-c++src", "cpp");
    309         add("text/x-c++src", "c++");
    310         add("text/x-c++src", "cc");
    311         add("text/x-c++src", "cxx");
    312         add("text/x-chdr", "h");
    313         add("text/x-component", "htc");
    314         add("text/x-csh", "csh");
    315         add("text/x-csrc", "c");
    316         add("text/x-dsrc", "d");
    317         add("text/x-haskell", "hs");
    318         add("text/x-java", "java");
    319         add("text/x-literate-haskell", "lhs");
    320         add("text/x-moc", "moc");
    321         add("text/x-pascal", "p");
    322         add("text/x-pascal", "pas");
    323         add("text/x-pcs-gcd", "gcd");
    324         add("text/x-setext", "etx");
    325         add("text/x-tcl", "tcl");
    326         add("text/x-tex", "tex");
    327         add("text/x-tex", "ltx");
    328         add("text/x-tex", "sty");
    329         add("text/x-tex", "cls");
    330         add("text/x-vcalendar", "vcs");
    331         add("text/x-vcard", "vcf");
    332         add("video/3gpp", "3gpp");
    333         add("video/3gpp", "3gp");
    334         add("video/3gpp", "3g2");
    335         add("video/dl", "dl");
    336         add("video/dv", "dif");
    337         add("video/dv", "dv");
    338         add("video/fli", "fli");
    339         add("video/m4v", "m4v");
    340         add("video/mpeg", "mpeg");
    341         add("video/mpeg", "mpg");
    342         add("video/mpeg", "mpe");
    343         add("video/mp4", "mp4");
    344         add("video/mpeg", "VOB");
    345         add("video/quicktime", "qt");
    346         add("video/quicktime", "mov");
    347         add("video/vnd.mpegurl", "mxu");
    348         add("video/x-la-asf", "lsf");
    349         add("video/x-la-asf", "lsx");
    350         add("video/x-mng", "mng");
    351         add("video/x-ms-asf", "asf");
    352         add("video/x-ms-asf", "asx");
    353         add("video/x-ms-wm", "wm");
    354         add("video/x-ms-wmv", "wmv");
    355         add("video/x-ms-wmx", "wmx");
    356         add("video/x-ms-wvx", "wvx");
    357         add("video/x-msvideo", "avi");
    358         add("video/x-sgi-movie", "movie");
    359         add("video/x-webex", "wrf");
    360         add("x-conference/x-cooltalk", "ice");
    361         add("x-epoc/x-sisx-app", "sisx");
    362         applyOverrides();
    363     }
    364 
    365     private static void add(String mimeType, String extension) {
    366         //
    367         // if we have an existing x --> y mapping, we do not want to
    368         // override it with another mapping x --> ?
    369         // this is mostly because of the way the mime-type map below
    370         // is constructed (if a mime type maps to several extensions
    371         // the first extension is considered the most popular and is
    372         // added first; we do not want to overwrite it later).
    373         //
    374         if (!mimeTypeToExtensionMap.containsKey(mimeType)) {
    375             mimeTypeToExtensionMap.put(mimeType, extension);
    376         }
    377         extensionToMimeTypeMap.put(extension, mimeType);
    378     }
    379 
    380     private static InputStream getContentTypesPropertiesStream() {
    381         // User override?
    382         String userTable = System.getProperty("content.types.user.table");
    383         if (userTable != null) {
    384             File f = new File(userTable);
    385             if (f.exists()) {
    386                 try {
    387                     return new FileInputStream(f);
    388                 } catch (IOException ignored) {
    389                 }
    390             }
    391         }
    392 
    393         // Standard location?
    394         File f = new File(System.getProperty("java.home"), "lib" + File.separator + "content-types.properties");
    395         if (f.exists()) {
    396             try {
    397                 return new FileInputStream(f);
    398             } catch (IOException ignored) {
    399             }
    400         }
    401 
    402         return null;
    403     }
    404 
    405     /**
    406      * This isn't what the RI does. The RI doesn't have hard-coded defaults, so supplying your
    407      * own "content.types.user.table" means you don't get any of the built-ins, and the built-ins
    408      * come from "$JAVA_HOME/lib/content-types.properties".
    409      */
    410     private static void applyOverrides() {
    411         // Get the appropriate InputStream to read overrides from, if any.
    412         InputStream stream = getContentTypesPropertiesStream();
    413         if (stream == null) {
    414             return;
    415         }
    416 
    417         try {
    418             try {
    419                 // Read the properties file...
    420                 Properties overrides = new Properties();
    421                 overrides.load(stream);
    422                 // And translate its mapping to ours...
    423                 for (Map.Entry<Object, Object> entry : overrides.entrySet()) {
    424                     String extension = (String) entry.getKey();
    425                     String mimeType = (String) entry.getValue();
    426                     add(mimeType, extension);
    427                 }
    428             } finally {
    429                 stream.close();
    430             }
    431         } catch (IOException ignored) {
    432         }
    433     }
    434 
    435     private MimeUtils() {
    436     }
    437 
    438     /**
    439      * Returns true if the given MIME type has an entry in the map.
    440      * @param mimeType A MIME type (i.e. text/plain)
    441      * @return True iff there is a mimeType entry in the map.
    442      */
    443     public static boolean hasMimeType(String mimeType) {
    444         if (mimeType == null || mimeType.isEmpty()) {
    445             return false;
    446         }
    447         return mimeTypeToExtensionMap.containsKey(mimeType);
    448     }
    449 
    450     /**
    451      * Returns the MIME type for the given extension.
    452      * @param extension A file extension without the leading '.'
    453      * @return The MIME type for the given extension or null iff there is none.
    454      */
    455     public static String guessMimeTypeFromExtension(String extension) {
    456         if (extension == null || extension.isEmpty()) {
    457             return null;
    458         }
    459         return extensionToMimeTypeMap.get(extension);
    460     }
    461 
    462     /**
    463      * Returns true if the given extension has a registered MIME type.
    464      * @param extension A file extension without the leading '.'
    465      * @return True iff there is an extension entry in the map.
    466      */
    467     public static boolean hasExtension(String extension) {
    468         if (extension == null || extension.isEmpty()) {
    469             return false;
    470         }
    471         return extensionToMimeTypeMap.containsKey(extension);
    472     }
    473 
    474     /**
    475      * Returns the registered extension for the given MIME type. Note that some
    476      * MIME types map to multiple extensions. This call will return the most
    477      * common extension for the given MIME type.
    478      * @param mimeType A MIME type (i.e. text/plain)
    479      * @return The extension for the given MIME type or null iff there is none.
    480      */
    481     public static String guessExtensionFromMimeType(String mimeType) {
    482         if (mimeType == null || mimeType.isEmpty()) {
    483             return null;
    484         }
    485         return mimeTypeToExtensionMap.get(mimeType);
    486     }
    487 }
    488