17dd252788645e940eada959bdde927426e2531c9Paul Duffin/* 27dd252788645e940eada959bdde927426e2531c9Paul Duffin * Copyright (C) 2011 The Guava Authors 37dd252788645e940eada959bdde927426e2531c9Paul Duffin * 47dd252788645e940eada959bdde927426e2531c9Paul Duffin * Licensed under the Apache License, Version 2.0 (the "License"); 57dd252788645e940eada959bdde927426e2531c9Paul Duffin * you may not use this file except in compliance with the License. 67dd252788645e940eada959bdde927426e2531c9Paul Duffin * You may obtain a copy of the License at 77dd252788645e940eada959bdde927426e2531c9Paul Duffin * 87dd252788645e940eada959bdde927426e2531c9Paul Duffin * http://www.apache.org/licenses/LICENSE-2.0 97dd252788645e940eada959bdde927426e2531c9Paul Duffin * 107dd252788645e940eada959bdde927426e2531c9Paul Duffin * Unless required by applicable law or agreed to in writing, software 117dd252788645e940eada959bdde927426e2531c9Paul Duffin * distributed under the License is distributed on an "AS IS" BASIS, 127dd252788645e940eada959bdde927426e2531c9Paul Duffin * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 137dd252788645e940eada959bdde927426e2531c9Paul Duffin * See the License for the specific language governing permissions and 147dd252788645e940eada959bdde927426e2531c9Paul Duffin * limitations under the License. 157dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 167dd252788645e940eada959bdde927426e2531c9Paul Duffin 177dd252788645e940eada959bdde927426e2531c9Paul Duffinpackage com.google.common.net; 187dd252788645e940eada959bdde927426e2531c9Paul Duffin 197dd252788645e940eada959bdde927426e2531c9Paul Duffinimport static com.google.common.base.CharMatcher.ASCII; 207dd252788645e940eada959bdde927426e2531c9Paul Duffinimport static com.google.common.base.CharMatcher.JAVA_ISO_CONTROL; 217dd252788645e940eada959bdde927426e2531c9Paul Duffinimport static com.google.common.base.Charsets.UTF_8; 227dd252788645e940eada959bdde927426e2531c9Paul Duffinimport static com.google.common.base.Preconditions.checkArgument; 237dd252788645e940eada959bdde927426e2531c9Paul Duffinimport static com.google.common.base.Preconditions.checkNotNull; 247dd252788645e940eada959bdde927426e2531c9Paul Duffinimport static com.google.common.base.Preconditions.checkState; 257dd252788645e940eada959bdde927426e2531c9Paul Duffin 267dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.annotations.Beta; 277dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.annotations.GwtCompatible; 287dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.Ascii; 297dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.CharMatcher; 307dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.Function; 317dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.Joiner; 327dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.Joiner.MapJoiner; 337dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.Objects; 347dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.base.Optional; 357dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.ImmutableListMultimap; 367dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.ImmutableMultiset; 377dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.ImmutableSet; 387dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.Iterables; 397dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.Maps; 407dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.Multimap; 417dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.collect.Multimaps; 427dd252788645e940eada959bdde927426e2531c9Paul Duffin 437dd252788645e940eada959bdde927426e2531c9Paul Duffinimport java.nio.charset.Charset; 447dd252788645e940eada959bdde927426e2531c9Paul Duffinimport java.nio.charset.IllegalCharsetNameException; 457dd252788645e940eada959bdde927426e2531c9Paul Duffinimport java.nio.charset.UnsupportedCharsetException; 467dd252788645e940eada959bdde927426e2531c9Paul Duffinimport java.util.Collection; 477dd252788645e940eada959bdde927426e2531c9Paul Duffinimport java.util.Map; 487dd252788645e940eada959bdde927426e2531c9Paul Duffinimport java.util.Map.Entry; 497dd252788645e940eada959bdde927426e2531c9Paul Duffin 507dd252788645e940eada959bdde927426e2531c9Paul Duffinimport javax.annotation.Nullable; 517dd252788645e940eada959bdde927426e2531c9Paul Duffinimport javax.annotation.concurrent.Immutable; 527dd252788645e940eada959bdde927426e2531c9Paul Duffin 537dd252788645e940eada959bdde927426e2531c9Paul Duffin/** 547dd252788645e940eada959bdde927426e2531c9Paul Duffin * Represents an <a href="http://en.wikipedia.org/wiki/Internet_media_type">Internet Media Type</a> 557dd252788645e940eada959bdde927426e2531c9Paul Duffin * (also known as a MIME Type or Content Type). This class also supports the concept of media ranges 567dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">defined by HTTP/1.1</a>. 577dd252788645e940eada959bdde927426e2531c9Paul Duffin * As such, the {@code *} character is treated as a wildcard and is used to represent any acceptable 587dd252788645e940eada959bdde927426e2531c9Paul Duffin * type or subtype value. A media type may not have wildcard type with a declared subtype. The 597dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@code *} character has no special meaning as part of a parameter. All values for type, subtype, 607dd252788645e940eada959bdde927426e2531c9Paul Duffin * parameter attributes or parameter values must be valid according to RFCs 617dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://www.ietf.org/rfc/rfc2045.txt">2045</a> and 627dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://www.ietf.org/rfc/rfc2046.txt">2046</a>. 637dd252788645e940eada959bdde927426e2531c9Paul Duffin * 647dd252788645e940eada959bdde927426e2531c9Paul Duffin * <p>All portions of the media type that are case-insensitive (type, subtype, parameter attributes) 657dd252788645e940eada959bdde927426e2531c9Paul Duffin * are normalized to lowercase. The value of the {@code charset} parameter is normalized to 667dd252788645e940eada959bdde927426e2531c9Paul Duffin * lowercase, but all others are left as-is. 677dd252788645e940eada959bdde927426e2531c9Paul Duffin * 687dd252788645e940eada959bdde927426e2531c9Paul Duffin * <p>Note that this specifically does <strong>not</strong> represent the value of the MIME 697dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@code Content-Type} header and as such has no support for header-specific considerations such as 707dd252788645e940eada959bdde927426e2531c9Paul Duffin * line folding and comments. 717dd252788645e940eada959bdde927426e2531c9Paul Duffin * 727dd252788645e940eada959bdde927426e2531c9Paul Duffin * <p>For media types that take a charset the predefined constants default to UTF-8 and have a 737dd252788645e940eada959bdde927426e2531c9Paul Duffin * "_UTF_8" suffix. To get a version without a character set, use {@link #withoutParameters}. 747dd252788645e940eada959bdde927426e2531c9Paul Duffin * 757dd252788645e940eada959bdde927426e2531c9Paul Duffin * @since 12.0 767dd252788645e940eada959bdde927426e2531c9Paul Duffin * 777dd252788645e940eada959bdde927426e2531c9Paul Duffin * @author Gregory Kick 787dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 797dd252788645e940eada959bdde927426e2531c9Paul Duffin@Beta 807dd252788645e940eada959bdde927426e2531c9Paul Duffin@GwtCompatible 817dd252788645e940eada959bdde927426e2531c9Paul Duffin@Immutable 827dd252788645e940eada959bdde927426e2531c9Paul Duffinpublic final class MediaType { 837dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String CHARSET_ATTRIBUTE = "charset"; 840888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static final ImmutableListMultimap<String, String> UTF_8_CONSTANT_PARAMETERS = 850888a09821a98ac0680fad765217302858e70fa4Paul Duffin ImmutableListMultimap.of(CHARSET_ATTRIBUTE, Ascii.toLowerCase(UTF_8.name())); 867dd252788645e940eada959bdde927426e2531c9Paul Duffin 877dd252788645e940eada959bdde927426e2531c9Paul Duffin /** Matcher for type, subtype and attributes. */ 887dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final CharMatcher TOKEN_MATCHER = ASCII.and(JAVA_ISO_CONTROL.negate()) 890888a09821a98ac0680fad765217302858e70fa4Paul Duffin .and(CharMatcher.isNot(' ')) 900888a09821a98ac0680fad765217302858e70fa4Paul Duffin .and(CharMatcher.noneOf("()<>@,;:\\\"/[]?=")); 910888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static final CharMatcher QUOTED_TEXT_MATCHER = ASCII 920888a09821a98ac0680fad765217302858e70fa4Paul Duffin .and(CharMatcher.noneOf("\"\\\r")); 937dd252788645e940eada959bdde927426e2531c9Paul Duffin /* 947dd252788645e940eada959bdde927426e2531c9Paul Duffin * This matches the same characters as linear-white-space from RFC 822, but we make no effort to 957dd252788645e940eada959bdde927426e2531c9Paul Duffin * enforce any particular rules with regards to line folding as stated in the class docs. 967dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 977dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final CharMatcher LINEAR_WHITE_SPACE = CharMatcher.anyOf(" \t\r\n"); 987dd252788645e940eada959bdde927426e2531c9Paul Duffin 997dd252788645e940eada959bdde927426e2531c9Paul Duffin // TODO(gak): make these public? 1007dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String APPLICATION_TYPE = "application"; 1017dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String AUDIO_TYPE = "audio"; 1027dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String IMAGE_TYPE = "image"; 1037dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String TEXT_TYPE = "text"; 1047dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String VIDEO_TYPE = "video"; 1057dd252788645e940eada959bdde927426e2531c9Paul Duffin 1067dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final String WILDCARD = "*"; 1077dd252788645e940eada959bdde927426e2531c9Paul Duffin 1080888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static final Map<MediaType, MediaType> KNOWN_TYPES = Maps.newHashMap(); 1090888a09821a98ac0680fad765217302858e70fa4Paul Duffin 1100888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static MediaType createConstant(String type, String subtype) { 1110888a09821a98ac0680fad765217302858e70fa4Paul Duffin return addKnownType(new MediaType(type, subtype, ImmutableListMultimap.<String, String>of())); 1120888a09821a98ac0680fad765217302858e70fa4Paul Duffin } 1130888a09821a98ac0680fad765217302858e70fa4Paul Duffin 1140888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static MediaType createConstantUtf8(String type, String subtype) { 1150888a09821a98ac0680fad765217302858e70fa4Paul Duffin return addKnownType(new MediaType(type, subtype, UTF_8_CONSTANT_PARAMETERS)); 1160888a09821a98ac0680fad765217302858e70fa4Paul Duffin } 1170888a09821a98ac0680fad765217302858e70fa4Paul Duffin 1180888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static MediaType addKnownType(MediaType mediaType) { 1190888a09821a98ac0680fad765217302858e70fa4Paul Duffin KNOWN_TYPES.put(mediaType, mediaType); 1200888a09821a98ac0680fad765217302858e70fa4Paul Duffin return mediaType; 1210888a09821a98ac0680fad765217302858e70fa4Paul Duffin } 1220888a09821a98ac0680fad765217302858e70fa4Paul Duffin 1237dd252788645e940eada959bdde927426e2531c9Paul Duffin /* 1247dd252788645e940eada959bdde927426e2531c9Paul Duffin * The following constants are grouped by their type and ordered alphabetically by the constant 1257dd252788645e940eada959bdde927426e2531c9Paul Duffin * name within that type. The constant name should be a sensible identifier that is closest to the 1267dd252788645e940eada959bdde927426e2531c9Paul Duffin * "common name" of the media. This is often, but not necessarily the same as the subtype. 1277dd252788645e940eada959bdde927426e2531c9Paul Duffin * 1280888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Be sure to declare all constants with the type and subtype in all lowercase. For types that 1290888a09821a98ac0680fad765217302858e70fa4Paul Duffin * take a charset (e.g. all text/* types), default to UTF-8 and suffix the constant name with 1300888a09821a98ac0680fad765217302858e70fa4Paul Duffin * "_UTF_8". 1317dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 1327dd252788645e940eada959bdde927426e2531c9Paul Duffin 1337dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ANY_TYPE = createConstant(WILDCARD, WILDCARD); 1347dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ANY_TEXT_TYPE = createConstant(TEXT_TYPE, WILDCARD); 1357dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ANY_IMAGE_TYPE = createConstant(IMAGE_TYPE, WILDCARD); 1367dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ANY_AUDIO_TYPE = createConstant(AUDIO_TYPE, WILDCARD); 1377dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ANY_VIDEO_TYPE = createConstant(VIDEO_TYPE, WILDCARD); 1387dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ANY_APPLICATION_TYPE = createConstant(APPLICATION_TYPE, WILDCARD); 1397dd252788645e940eada959bdde927426e2531c9Paul Duffin 1407dd252788645e940eada959bdde927426e2531c9Paul Duffin /* text types */ 1410888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType CACHE_MANIFEST_UTF_8 = 1420888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstantUtf8(TEXT_TYPE, "cache-manifest"); 1437dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType CSS_UTF_8 = createConstantUtf8(TEXT_TYPE, "css"); 1447dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType CSV_UTF_8 = createConstantUtf8(TEXT_TYPE, "csv"); 1457dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType HTML_UTF_8 = createConstantUtf8(TEXT_TYPE, "html"); 1467dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType I_CALENDAR_UTF_8 = createConstantUtf8(TEXT_TYPE, "calendar"); 1477dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType PLAIN_TEXT_UTF_8 = createConstantUtf8(TEXT_TYPE, "plain"); 1487dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 1497dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://www.rfc-editor.org/rfc/rfc4329.txt">RFC 4329</a> declares 1507dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@link #JAVASCRIPT_UTF_8 application/javascript} to be the correct media type for JavaScript, 1517dd252788645e940eada959bdde927426e2531c9Paul Duffin * but this may be necessary in certain situations for compatibility. 1527dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 1537dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType TEXT_JAVASCRIPT_UTF_8 = createConstantUtf8(TEXT_TYPE, "javascript"); 1540888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 1550888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.iana.org/assignments/media-types/text/tab-separated-values"> 1560888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Tab separated values</a>. 1570888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 1580888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 15.0 1590888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 1600888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType TSV_UTF_8 = createConstantUtf8(TEXT_TYPE, "tab-separated-values"); 1617dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType VCARD_UTF_8 = createConstantUtf8(TEXT_TYPE, "vcard"); 1627dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType WML_UTF_8 = createConstantUtf8(TEXT_TYPE, "vnd.wap.wml"); 1637dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 1647dd252788645e940eada959bdde927426e2531c9Paul Duffin * As described in <a href="http://www.ietf.org/rfc/rfc3023.txt">RFC 3023</a>, this constant 1657dd252788645e940eada959bdde927426e2531c9Paul Duffin * ({@code text/xml}) is used for XML documents that are "readable by casual users." 1667dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@link #APPLICATION_XML_UTF_8} is provided for documents that are intended for applications. 1677dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 1687dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType XML_UTF_8 = createConstantUtf8(TEXT_TYPE, "xml"); 1697dd252788645e940eada959bdde927426e2531c9Paul Duffin 1707dd252788645e940eada959bdde927426e2531c9Paul Duffin /* image types */ 1717dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType BMP = createConstant(IMAGE_TYPE, "bmp"); 1720888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 1730888a09821a98ac0680fad765217302858e70fa4Paul Duffin * The media type for the <a href="http://en.wikipedia.org/wiki/Camera_Image_File_Format">Canon 1740888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Image File Format</a> ({@code crw} files), a widely-used "raw image" format for cameras. It is 1750888a09821a98ac0680fad765217302858e70fa4Paul Duffin * found in {@code /etc/mime.types}, e.g. in <href= 1760888a09821a98ac0680fad765217302858e70fa4Paul Duffin * "http://anonscm.debian.org/gitweb/?p=collab-maint/mime-support.git;a=blob;f=mime.types;hb=HEAD" 1770888a09821a98ac0680fad765217302858e70fa4Paul Duffin * >Debian 3.48-1</a>. 1780888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 1790888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 15.0 1800888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 1810888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType CRW = createConstant(IMAGE_TYPE, "x-canon-crw"); 1827dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType GIF = createConstant(IMAGE_TYPE, "gif"); 1837dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ICO = createConstant(IMAGE_TYPE, "vnd.microsoft.icon"); 1847dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType JPEG = createConstant(IMAGE_TYPE, "jpeg"); 1857dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType PNG = createConstant(IMAGE_TYPE, "png"); 1860888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 1870888a09821a98ac0680fad765217302858e70fa4Paul Duffin * The media type for the Photoshop File Format ({@code psd} files) as defined by <a href= 1880888a09821a98ac0680fad765217302858e70fa4Paul Duffin * "http://www.iana.org/assignments/media-types/image/vnd.adobe.photoshop">IANA</a>, and found in 1890888a09821a98ac0680fad765217302858e70fa4Paul Duffin * {@code /etc/mime.types}, e.g. <a href= 1900888a09821a98ac0680fad765217302858e70fa4Paul Duffin * "http://svn.apache.org/repos/asf/httpd/httpd/branches/1.3.x/conf/mime.types"></a> of the Apache 1910888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://httpd.apache.org/">HTTPD project</a>; for the specification, see 1920888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <href="http://www.adobe.com/devnet-apps/photoshop/fileformatashtml/PhotoshopFileFormats.htm"> 1930888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Adobe Photoshop Document Format</a> and <a href= 1940888a09821a98ac0680fad765217302858e70fa4Paul Duffin * "http://en.wikipedia.org/wiki/Adobe_Photoshop#File_format">Wikipedia</a>; this is the regular 1950888a09821a98ac0680fad765217302858e70fa4Paul Duffin * output/input of Photoshop (which can also export to various image formats; note that files with 1960888a09821a98ac0680fad765217302858e70fa4Paul Duffin * extension "PSB" are in a distinct but related format). 1970888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <p>This is a more recent replacement for the older, experimental type 1980888a09821a98ac0680fad765217302858e70fa4Paul Duffin * {@code x-photoshop}: <a href="http://tools.ietf.org/html/rfc2046#section-6">RFC-2046.6</a>. 1990888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 2000888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 15.0 2010888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 2020888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType PSD = createConstant(IMAGE_TYPE, "vnd.adobe.photoshop"); 2037dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType SVG_UTF_8 = createConstantUtf8(IMAGE_TYPE, "svg+xml"); 2047dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType TIFF = createConstant(IMAGE_TYPE, "tiff"); 2057dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType WEBP = createConstant(IMAGE_TYPE, "webp"); 2067dd252788645e940eada959bdde927426e2531c9Paul Duffin 2077dd252788645e940eada959bdde927426e2531c9Paul Duffin /* audio types */ 2087dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MP4_AUDIO = createConstant(AUDIO_TYPE, "mp4"); 2097dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MPEG_AUDIO = createConstant(AUDIO_TYPE, "mpeg"); 2107dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType OGG_AUDIO = createConstant(AUDIO_TYPE, "ogg"); 2117dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType WEBM_AUDIO = createConstant(AUDIO_TYPE, "webm"); 2127dd252788645e940eada959bdde927426e2531c9Paul Duffin 2137dd252788645e940eada959bdde927426e2531c9Paul Duffin /* video types */ 2147dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MP4_VIDEO = createConstant(VIDEO_TYPE, "mp4"); 2157dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MPEG_VIDEO = createConstant(VIDEO_TYPE, "mpeg"); 2167dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType OGG_VIDEO = createConstant(VIDEO_TYPE, "ogg"); 2177dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType QUICKTIME = createConstant(VIDEO_TYPE, "quicktime"); 2187dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType WEBM_VIDEO = createConstant(VIDEO_TYPE, "webm"); 2197dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType WMV = createConstant(VIDEO_TYPE, "x-ms-wmv"); 2207dd252788645e940eada959bdde927426e2531c9Paul Duffin 2217dd252788645e940eada959bdde927426e2531c9Paul Duffin /* application types */ 2227dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 2237dd252788645e940eada959bdde927426e2531c9Paul Duffin * As described in <a href="http://www.ietf.org/rfc/rfc3023.txt">RFC 3023</a>, this constant 2247dd252788645e940eada959bdde927426e2531c9Paul Duffin * ({@code application/xml}) is used for XML documents that are "unreadable by casual users." 2257dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@link #XML_UTF_8} is provided for documents that may be read by users. 2267dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 2277dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType APPLICATION_XML_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "xml"); 2287dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ATOM_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "atom+xml"); 2297dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType BZIP2 = createConstant(APPLICATION_TYPE, "x-bzip2"); 2300888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 2310888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Media type for <a href="http://en.wikipedia.org/wiki/Embedded_OpenType">Embedded OpenType</a> 2320888a09821a98ac0680fad765217302858e70fa4Paul Duffin * fonts. This is 2330888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.iana.org/assignments/media-types/application/vnd.ms-fontobject">registered 2340888a09821a98ac0680fad765217302858e70fa4Paul Duffin * </a> with the IANA. 2350888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 2360888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 17.0 2370888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 2380888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType EOT = createConstant(APPLICATION_TYPE, "vnd.ms-fontobject"); 2390888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 2400888a09821a98ac0680fad765217302858e70fa4Paul Duffin * As described in the <a href="http://idpf.org/epub">International Digital Publishing Forum</a> 2410888a09821a98ac0680fad765217302858e70fa4Paul Duffin * EPUB is the distribution and interchange format standard for digital publications and 2420888a09821a98ac0680fad765217302858e70fa4Paul Duffin * documents. This media type is defined in the 2430888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.idpf.org/epub/30/spec/epub30-ocf.html">EPUB Open Container Format</a> 2440888a09821a98ac0680fad765217302858e70fa4Paul Duffin * specification. 2450888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 2460888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 15.0 2470888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 2480888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType EPUB = createConstant(APPLICATION_TYPE, "epub+zip"); 2497dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType FORM_DATA = createConstant(APPLICATION_TYPE, 2507dd252788645e940eada959bdde927426e2531c9Paul Duffin "x-www-form-urlencoded"); 2517dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 2520888a09821a98ac0680fad765217302858e70fa4Paul Duffin * As described in <a href="https://www.rsa.com/rsalabs/node.asp?id=2138">PKCS #12: Personal 2530888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Information Exchange Syntax Standard</a>, PKCS #12 defines an archive file format for storing 2540888a09821a98ac0680fad765217302858e70fa4Paul Duffin * many cryptography objects as a single file. 2550888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 2560888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 15.0 2570888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 2580888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType KEY_ARCHIVE = createConstant(APPLICATION_TYPE, "pkcs12"); 2590888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 2607dd252788645e940eada959bdde927426e2531c9Paul Duffin * This is a non-standard media type, but is commonly used in serving hosted binary files as it is 2617dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://code.google.com/p/browsersec/wiki/Part2#Survey_of_content_sniffing_behaviors"> 2627dd252788645e940eada959bdde927426e2531c9Paul Duffin * known not to trigger content sniffing in current browsers</a>. It <i>should not</i> be used in 2637dd252788645e940eada959bdde927426e2531c9Paul Duffin * other situations as it is not specified by any RFC and does not appear in the <a href= 2647dd252788645e940eada959bdde927426e2531c9Paul Duffin * "http://www.iana.org/assignments/media-types">/IANA MIME Media Types</a> list. Consider 2657dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@link #OCTET_STREAM} for binary data that is not being served to a browser. 2667dd252788645e940eada959bdde927426e2531c9Paul Duffin * 2677dd252788645e940eada959bdde927426e2531c9Paul Duffin * 2687dd252788645e940eada959bdde927426e2531c9Paul Duffin * @since 14.0 2697dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 2707dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType APPLICATION_BINARY = createConstant(APPLICATION_TYPE, "binary"); 2717dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType GZIP = createConstant(APPLICATION_TYPE, "x-gzip"); 2720888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 2730888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.rfc-editor.org/rfc/rfc4329.txt">RFC 4329</a> declares this to be the 2740888a09821a98ac0680fad765217302858e70fa4Paul Duffin * correct media type for JavaScript, but {@link #TEXT_JAVASCRIPT_UTF_8 text/javascript} may be 2750888a09821a98ac0680fad765217302858e70fa4Paul Duffin * necessary in certain situations for compatibility. 2760888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 2770888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType JAVASCRIPT_UTF_8 = 2780888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstantUtf8(APPLICATION_TYPE, "javascript"); 2797dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType JSON_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "json"); 2807dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType KML = createConstant(APPLICATION_TYPE, "vnd.google-earth.kml+xml"); 2817dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType KMZ = createConstant(APPLICATION_TYPE, "vnd.google-earth.kmz"); 2827dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MBOX = createConstant(APPLICATION_TYPE, "mbox"); 2837dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MICROSOFT_EXCEL = createConstant(APPLICATION_TYPE, "vnd.ms-excel"); 2840888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType MICROSOFT_POWERPOINT = 2850888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstant(APPLICATION_TYPE, "vnd.ms-powerpoint"); 2867dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType MICROSOFT_WORD = createConstant(APPLICATION_TYPE, "msword"); 2877dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType OCTET_STREAM = createConstant(APPLICATION_TYPE, "octet-stream"); 2887dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType OGG_CONTAINER = createConstant(APPLICATION_TYPE, "ogg"); 2897dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType OOXML_DOCUMENT = createConstant(APPLICATION_TYPE, 2907dd252788645e940eada959bdde927426e2531c9Paul Duffin "vnd.openxmlformats-officedocument.wordprocessingml.document"); 2917dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType OOXML_PRESENTATION = createConstant(APPLICATION_TYPE, 2927dd252788645e940eada959bdde927426e2531c9Paul Duffin "vnd.openxmlformats-officedocument.presentationml.presentation"); 2930888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType OOXML_SHEET = 2940888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstant(APPLICATION_TYPE, "vnd.openxmlformats-officedocument.spreadsheetml.sheet"); 2950888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType OPENDOCUMENT_GRAPHICS = 2960888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstant(APPLICATION_TYPE, "vnd.oasis.opendocument.graphics"); 2970888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType OPENDOCUMENT_PRESENTATION = 2980888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstant(APPLICATION_TYPE, "vnd.oasis.opendocument.presentation"); 2990888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType OPENDOCUMENT_SPREADSHEET = 3000888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstant(APPLICATION_TYPE, "vnd.oasis.opendocument.spreadsheet"); 3010888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType OPENDOCUMENT_TEXT = 3020888a09821a98ac0680fad765217302858e70fa4Paul Duffin createConstant(APPLICATION_TYPE, "vnd.oasis.opendocument.text"); 3037dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType PDF = createConstant(APPLICATION_TYPE, "pdf"); 3047dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType POSTSCRIPT = createConstant(APPLICATION_TYPE, "postscript"); 3050888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 3060888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://tools.ietf.org/html/draft-rfernando-protocol-buffers-00">Protocol buffers</a> 3070888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 3080888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 15.0 3090888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 3100888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType PROTOBUF = createConstant(APPLICATION_TYPE, "protobuf"); 3117dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType RDF_XML_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "rdf+xml"); 3127dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType RTF_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "rtf"); 3130888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 3140888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Media type for SFNT fonts (which includes 3150888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://en.wikipedia.org/wiki/TrueType/">TrueType</a> and 3160888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://en.wikipedia.org/wiki/OpenType/">OpenType</a> fonts). This is 3170888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.iana.org/assignments/media-types/application/font-sfnt">registered</a> 3180888a09821a98ac0680fad765217302858e70fa4Paul Duffin * with the IANA. 3190888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 3200888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 17.0 3210888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 3220888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType SFNT = createConstant(APPLICATION_TYPE, "font-sfnt"); 3237dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType SHOCKWAVE_FLASH = createConstant(APPLICATION_TYPE, 3247dd252788645e940eada959bdde927426e2531c9Paul Duffin "x-shockwave-flash"); 3257dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType SKETCHUP = createConstant(APPLICATION_TYPE, "vnd.sketchup.skp"); 3267dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType TAR = createConstant(APPLICATION_TYPE, "x-tar"); 3270888a09821a98ac0680fad765217302858e70fa4Paul Duffin /** 3280888a09821a98ac0680fad765217302858e70fa4Paul Duffin * Media type for the 3290888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://en.wikipedia.org/wiki/Web_Open_Font_Format">Web Open Font Format</a> (WOFF) 3300888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.w3.org/TR/WOFF/">defined</a> by the W3C. This is 3310888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <a href="http://www.iana.org/assignments/media-types/application/font-woff">registered</a> 3320888a09821a98ac0680fad765217302858e70fa4Paul Duffin * with the IANA. 3330888a09821a98ac0680fad765217302858e70fa4Paul Duffin * 3340888a09821a98ac0680fad765217302858e70fa4Paul Duffin * @since 17.0 3350888a09821a98ac0680fad765217302858e70fa4Paul Duffin */ 3360888a09821a98ac0680fad765217302858e70fa4Paul Duffin public static final MediaType WOFF = createConstant(APPLICATION_TYPE, "font-woff"); 3377dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType XHTML_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "xhtml+xml"); 3387dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 3397dd252788645e940eada959bdde927426e2531c9Paul Duffin * Media type for Extensible Resource Descriptors. This is not yet registered with the IANA, but 3407dd252788645e940eada959bdde927426e2531c9Paul Duffin * it is specified by OASIS in the 3417dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://docs.oasis-open.org/xri/xrd/v1.0/cd02/xrd-1.0-cd02.html"> XRD definition</a> 3427dd252788645e940eada959bdde927426e2531c9Paul Duffin * and implemented in projects such as 3437dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://code.google.com/p/webfinger/">WebFinger</a>. 3447dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 3457dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType XRD_UTF_8 = createConstantUtf8(APPLICATION_TYPE, "xrd+xml"); 3467dd252788645e940eada959bdde927426e2531c9Paul Duffin public static final MediaType ZIP = createConstant(APPLICATION_TYPE, "zip"); 3477dd252788645e940eada959bdde927426e2531c9Paul Duffin 3487dd252788645e940eada959bdde927426e2531c9Paul Duffin private final String type; 3497dd252788645e940eada959bdde927426e2531c9Paul Duffin private final String subtype; 3507dd252788645e940eada959bdde927426e2531c9Paul Duffin private final ImmutableListMultimap<String, String> parameters; 3517dd252788645e940eada959bdde927426e2531c9Paul Duffin 3520888a09821a98ac0680fad765217302858e70fa4Paul Duffin private MediaType(String type, String subtype, 3530888a09821a98ac0680fad765217302858e70fa4Paul Duffin ImmutableListMultimap<String, String> parameters) { 3547dd252788645e940eada959bdde927426e2531c9Paul Duffin this.type = type; 3557dd252788645e940eada959bdde927426e2531c9Paul Duffin this.subtype = subtype; 3567dd252788645e940eada959bdde927426e2531c9Paul Duffin this.parameters = parameters; 3577dd252788645e940eada959bdde927426e2531c9Paul Duffin } 3587dd252788645e940eada959bdde927426e2531c9Paul Duffin 3597dd252788645e940eada959bdde927426e2531c9Paul Duffin /** Returns the top-level media type. For example, {@code "text"} in {@code "text/plain"}. */ 3607dd252788645e940eada959bdde927426e2531c9Paul Duffin public String type() { 3617dd252788645e940eada959bdde927426e2531c9Paul Duffin return type; 3627dd252788645e940eada959bdde927426e2531c9Paul Duffin } 3637dd252788645e940eada959bdde927426e2531c9Paul Duffin 3647dd252788645e940eada959bdde927426e2531c9Paul Duffin /** Returns the media subtype. For example, {@code "plain"} in {@code "text/plain"}. */ 3657dd252788645e940eada959bdde927426e2531c9Paul Duffin public String subtype() { 3667dd252788645e940eada959bdde927426e2531c9Paul Duffin return subtype; 3677dd252788645e940eada959bdde927426e2531c9Paul Duffin } 3687dd252788645e940eada959bdde927426e2531c9Paul Duffin 3697dd252788645e940eada959bdde927426e2531c9Paul Duffin /** Returns a multimap containing the parameters of this media type. */ 3707dd252788645e940eada959bdde927426e2531c9Paul Duffin public ImmutableListMultimap<String, String> parameters() { 3717dd252788645e940eada959bdde927426e2531c9Paul Duffin return parameters; 3727dd252788645e940eada959bdde927426e2531c9Paul Duffin } 3737dd252788645e940eada959bdde927426e2531c9Paul Duffin 3747dd252788645e940eada959bdde927426e2531c9Paul Duffin private Map<String, ImmutableMultiset<String>> parametersAsMap() { 3757dd252788645e940eada959bdde927426e2531c9Paul Duffin return Maps.transformValues(parameters.asMap(), 3767dd252788645e940eada959bdde927426e2531c9Paul Duffin new Function<Collection<String>, ImmutableMultiset<String>>() { 3770888a09821a98ac0680fad765217302858e70fa4Paul Duffin @Override public ImmutableMultiset<String> apply(Collection<String> input) { 3787dd252788645e940eada959bdde927426e2531c9Paul Duffin return ImmutableMultiset.copyOf(input); 3797dd252788645e940eada959bdde927426e2531c9Paul Duffin } 3807dd252788645e940eada959bdde927426e2531c9Paul Duffin }); 3817dd252788645e940eada959bdde927426e2531c9Paul Duffin } 3827dd252788645e940eada959bdde927426e2531c9Paul Duffin 3837dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 3847dd252788645e940eada959bdde927426e2531c9Paul Duffin * Returns an optional charset for the value of the charset parameter if it is specified. 3857dd252788645e940eada959bdde927426e2531c9Paul Duffin * 3867dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalStateException if multiple charset values have been set for this media type 3877dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalCharsetNameException if a charset value is present, but illegal 3887dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws UnsupportedCharsetException if a charset value is present, but no support is available 3897dd252788645e940eada959bdde927426e2531c9Paul Duffin * in this instance of the Java virtual machine 3907dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 3917dd252788645e940eada959bdde927426e2531c9Paul Duffin public Optional<Charset> charset() { 3927dd252788645e940eada959bdde927426e2531c9Paul Duffin ImmutableSet<String> charsetValues = ImmutableSet.copyOf(parameters.get(CHARSET_ATTRIBUTE)); 3937dd252788645e940eada959bdde927426e2531c9Paul Duffin switch (charsetValues.size()) { 3947dd252788645e940eada959bdde927426e2531c9Paul Duffin case 0: 3957dd252788645e940eada959bdde927426e2531c9Paul Duffin return Optional.absent(); 3967dd252788645e940eada959bdde927426e2531c9Paul Duffin case 1: 3977dd252788645e940eada959bdde927426e2531c9Paul Duffin return Optional.of(Charset.forName(Iterables.getOnlyElement(charsetValues))); 3987dd252788645e940eada959bdde927426e2531c9Paul Duffin default: 3997dd252788645e940eada959bdde927426e2531c9Paul Duffin throw new IllegalStateException("Multiple charset values defined: " + charsetValues); 4007dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4017dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4027dd252788645e940eada959bdde927426e2531c9Paul Duffin 4037dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 4047dd252788645e940eada959bdde927426e2531c9Paul Duffin * Returns a new instance with the same type and subtype as this instance, but without any 4057dd252788645e940eada959bdde927426e2531c9Paul Duffin * parameters. 4067dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 4077dd252788645e940eada959bdde927426e2531c9Paul Duffin public MediaType withoutParameters() { 4087dd252788645e940eada959bdde927426e2531c9Paul Duffin return parameters.isEmpty() ? this : create(type, subtype); 4097dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4107dd252788645e940eada959bdde927426e2531c9Paul Duffin 4117dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 4127dd252788645e940eada959bdde927426e2531c9Paul Duffin * <em>Replaces</em> all parameters with the given parameters. 4137dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4147dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if any parameter or value is invalid 4157dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 4167dd252788645e940eada959bdde927426e2531c9Paul Duffin public MediaType withParameters(Multimap<String, String> parameters) { 4177dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(type, subtype, parameters); 4187dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4197dd252788645e940eada959bdde927426e2531c9Paul Duffin 4207dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 4217dd252788645e940eada959bdde927426e2531c9Paul Duffin * <em>Replaces</em> all parameters with the given attribute with a single parameter with the 4227dd252788645e940eada959bdde927426e2531c9Paul Duffin * given value. If multiple parameters with the same attributes are necessary use 4237dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@link #withParameters}. Prefer {@link #withCharset} for setting the {@code charset} parameter 4247dd252788645e940eada959bdde927426e2531c9Paul Duffin * when using a {@link Charset} object. 4257dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4267dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if either {@code attribute} or {@code value} is invalid 4277dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 4287dd252788645e940eada959bdde927426e2531c9Paul Duffin public MediaType withParameter(String attribute, String value) { 4297dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(attribute); 4307dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(value); 4317dd252788645e940eada959bdde927426e2531c9Paul Duffin String normalizedAttribute = normalizeToken(attribute); 4327dd252788645e940eada959bdde927426e2531c9Paul Duffin ImmutableListMultimap.Builder<String, String> builder = ImmutableListMultimap.builder(); 4337dd252788645e940eada959bdde927426e2531c9Paul Duffin for (Entry<String, String> entry : parameters.entries()) { 4347dd252788645e940eada959bdde927426e2531c9Paul Duffin String key = entry.getKey(); 4357dd252788645e940eada959bdde927426e2531c9Paul Duffin if (!normalizedAttribute.equals(key)) { 4367dd252788645e940eada959bdde927426e2531c9Paul Duffin builder.put(key, entry.getValue()); 4377dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4387dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4397dd252788645e940eada959bdde927426e2531c9Paul Duffin builder.put(normalizedAttribute, normalizeParameterValue(normalizedAttribute, value)); 4407dd252788645e940eada959bdde927426e2531c9Paul Duffin MediaType mediaType = new MediaType(type, subtype, builder.build()); 4417dd252788645e940eada959bdde927426e2531c9Paul Duffin // Return one of the constants if the media type is a known type. 4427dd252788645e940eada959bdde927426e2531c9Paul Duffin return Objects.firstNonNull(KNOWN_TYPES.get(mediaType), mediaType); 4437dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4447dd252788645e940eada959bdde927426e2531c9Paul Duffin 4457dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 4467dd252788645e940eada959bdde927426e2531c9Paul Duffin * Returns a new instance with the same type and subtype as this instance, with the 4477dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@code charset} parameter set to the {@link Charset#name name} of the given charset. Only one 4487dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@code charset} parameter will be present on the new instance regardless of the number set on 4497dd252788645e940eada959bdde927426e2531c9Paul Duffin * this one. 4507dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4517dd252788645e940eada959bdde927426e2531c9Paul Duffin * <p>If a charset must be specified that is not supported on this JVM (and thus is not 4527dd252788645e940eada959bdde927426e2531c9Paul Duffin * representable as a {@link Charset} instance, use {@link #withParameter}. 4537dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 4547dd252788645e940eada959bdde927426e2531c9Paul Duffin public MediaType withCharset(Charset charset) { 4557dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(charset); 4567dd252788645e940eada959bdde927426e2531c9Paul Duffin return withParameter(CHARSET_ATTRIBUTE, charset.name()); 4577dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4587dd252788645e940eada959bdde927426e2531c9Paul Duffin 4597dd252788645e940eada959bdde927426e2531c9Paul Duffin /** Returns true if either the type or subtype is the wildcard. */ 4607dd252788645e940eada959bdde927426e2531c9Paul Duffin public boolean hasWildcard() { 4617dd252788645e940eada959bdde927426e2531c9Paul Duffin return WILDCARD.equals(type) || WILDCARD.equals(subtype); 4627dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4637dd252788645e940eada959bdde927426e2531c9Paul Duffin 4647dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 4657dd252788645e940eada959bdde927426e2531c9Paul Duffin * Returns {@code true} if this instance falls within the range (as defined by 4667dd252788645e940eada959bdde927426e2531c9Paul Duffin * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html">the HTTP Accept header</a>) 4677dd252788645e940eada959bdde927426e2531c9Paul Duffin * given by the argument according to three criteria: 4687dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4697dd252788645e940eada959bdde927426e2531c9Paul Duffin * <ol> 4707dd252788645e940eada959bdde927426e2531c9Paul Duffin * <li>The type of the argument is the wildcard or equal to the type of this instance. 4717dd252788645e940eada959bdde927426e2531c9Paul Duffin * <li>The subtype of the argument is the wildcard or equal to the subtype of this instance. 4727dd252788645e940eada959bdde927426e2531c9Paul Duffin * <li>All of the parameters present in the argument are present in this instance. 4737dd252788645e940eada959bdde927426e2531c9Paul Duffin * </ol> 4747dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4750888a09821a98ac0680fad765217302858e70fa4Paul Duffin * <p>For example: <pre> {@code 4767dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(PLAIN_TEXT_UTF_8) // true 4777dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(HTML_UTF_8) // false 4787dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(ANY_TYPE) // true 4797dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(ANY_TEXT_TYPE) // true 4807dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(ANY_IMAGE_TYPE) // false 4817dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(ANY_TEXT_TYPE.withCharset(UTF_8)) // true 4827dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.withoutParameters().is(ANY_TEXT_TYPE.withCharset(UTF_8)) // false 4837dd252788645e940eada959bdde927426e2531c9Paul Duffin * PLAIN_TEXT_UTF_8.is(ANY_TEXT_TYPE.withCharset(UTF_16)) // false}</pre> 4847dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4857dd252788645e940eada959bdde927426e2531c9Paul Duffin * <p>Note that while it is possible to have the same parameter declared multiple times within a 4867dd252788645e940eada959bdde927426e2531c9Paul Duffin * media type this method does not consider the number of occurrences of a parameter. For 4877dd252788645e940eada959bdde927426e2531c9Paul Duffin * example, {@code "text/plain; charset=UTF-8"} satisfies 4887dd252788645e940eada959bdde927426e2531c9Paul Duffin * {@code "text/plain; charset=UTF-8; charset=UTF-8"}. 4897dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 4907dd252788645e940eada959bdde927426e2531c9Paul Duffin public boolean is(MediaType mediaTypeRange) { 4917dd252788645e940eada959bdde927426e2531c9Paul Duffin return (mediaTypeRange.type.equals(WILDCARD) || mediaTypeRange.type.equals(this.type)) 4927dd252788645e940eada959bdde927426e2531c9Paul Duffin && (mediaTypeRange.subtype.equals(WILDCARD) || mediaTypeRange.subtype.equals(this.subtype)) 4937dd252788645e940eada959bdde927426e2531c9Paul Duffin && this.parameters.entries().containsAll(mediaTypeRange.parameters.entries()); 4947dd252788645e940eada959bdde927426e2531c9Paul Duffin } 4957dd252788645e940eada959bdde927426e2531c9Paul Duffin 4967dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 4977dd252788645e940eada959bdde927426e2531c9Paul Duffin * Creates a new media type with the given type and subtype. 4987dd252788645e940eada959bdde927426e2531c9Paul Duffin * 4997dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if type or subtype is invalid or if a wildcard is used for the 5007dd252788645e940eada959bdde927426e2531c9Paul Duffin * type, but not the subtype. 5017dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5027dd252788645e940eada959bdde927426e2531c9Paul Duffin public static MediaType create(String type, String subtype) { 5030888a09821a98ac0680fad765217302858e70fa4Paul Duffin return create(type, subtype, ImmutableListMultimap.<String, String>of()); 5047dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5057dd252788645e940eada959bdde927426e2531c9Paul Duffin 5067dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 5077dd252788645e940eada959bdde927426e2531c9Paul Duffin * Creates a media type with the "application" type and the given subtype. 5087dd252788645e940eada959bdde927426e2531c9Paul Duffin * 5097dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if subtype is invalid 5107dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5117dd252788645e940eada959bdde927426e2531c9Paul Duffin static MediaType createApplicationType(String subtype) { 5127dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(APPLICATION_TYPE, subtype); 5137dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5147dd252788645e940eada959bdde927426e2531c9Paul Duffin 5157dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 5167dd252788645e940eada959bdde927426e2531c9Paul Duffin * Creates a media type with the "audio" type and the given subtype. 5177dd252788645e940eada959bdde927426e2531c9Paul Duffin * 5187dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if subtype is invalid 5197dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5207dd252788645e940eada959bdde927426e2531c9Paul Duffin static MediaType createAudioType(String subtype) { 5217dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(AUDIO_TYPE, subtype); 5227dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5237dd252788645e940eada959bdde927426e2531c9Paul Duffin 5247dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 5257dd252788645e940eada959bdde927426e2531c9Paul Duffin * Creates a media type with the "image" type and the given subtype. 5267dd252788645e940eada959bdde927426e2531c9Paul Duffin * 5277dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if subtype is invalid 5287dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5297dd252788645e940eada959bdde927426e2531c9Paul Duffin static MediaType createImageType(String subtype) { 5307dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(IMAGE_TYPE, subtype); 5317dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5327dd252788645e940eada959bdde927426e2531c9Paul Duffin 5337dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 5347dd252788645e940eada959bdde927426e2531c9Paul Duffin * Creates a media type with the "text" type and the given subtype. 5357dd252788645e940eada959bdde927426e2531c9Paul Duffin * 5367dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if subtype is invalid 5377dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5387dd252788645e940eada959bdde927426e2531c9Paul Duffin static MediaType createTextType(String subtype) { 5397dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(TEXT_TYPE, subtype); 5407dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5417dd252788645e940eada959bdde927426e2531c9Paul Duffin 5427dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 5437dd252788645e940eada959bdde927426e2531c9Paul Duffin * Creates a media type with the "video" type and the given subtype. 5447dd252788645e940eada959bdde927426e2531c9Paul Duffin * 5457dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if subtype is invalid 5467dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5477dd252788645e940eada959bdde927426e2531c9Paul Duffin static MediaType createVideoType(String subtype) { 5487dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(VIDEO_TYPE, subtype); 5497dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5507dd252788645e940eada959bdde927426e2531c9Paul Duffin 5510888a09821a98ac0680fad765217302858e70fa4Paul Duffin private static MediaType create(String type, String subtype, 5520888a09821a98ac0680fad765217302858e70fa4Paul Duffin Multimap<String, String> parameters) { 5537dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(type); 5547dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(subtype); 5557dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(parameters); 5567dd252788645e940eada959bdde927426e2531c9Paul Duffin String normalizedType = normalizeToken(type); 5577dd252788645e940eada959bdde927426e2531c9Paul Duffin String normalizedSubtype = normalizeToken(subtype); 5587dd252788645e940eada959bdde927426e2531c9Paul Duffin checkArgument(!WILDCARD.equals(normalizedType) || WILDCARD.equals(normalizedSubtype), 5597dd252788645e940eada959bdde927426e2531c9Paul Duffin "A wildcard type cannot be used with a non-wildcard subtype"); 5607dd252788645e940eada959bdde927426e2531c9Paul Duffin ImmutableListMultimap.Builder<String, String> builder = ImmutableListMultimap.builder(); 5617dd252788645e940eada959bdde927426e2531c9Paul Duffin for (Entry<String, String> entry : parameters.entries()) { 5627dd252788645e940eada959bdde927426e2531c9Paul Duffin String attribute = normalizeToken(entry.getKey()); 5637dd252788645e940eada959bdde927426e2531c9Paul Duffin builder.put(attribute, normalizeParameterValue(attribute, entry.getValue())); 5647dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5657dd252788645e940eada959bdde927426e2531c9Paul Duffin MediaType mediaType = new MediaType(normalizedType, normalizedSubtype, builder.build()); 5667dd252788645e940eada959bdde927426e2531c9Paul Duffin // Return one of the constants if the media type is a known type. 5677dd252788645e940eada959bdde927426e2531c9Paul Duffin return Objects.firstNonNull(KNOWN_TYPES.get(mediaType), mediaType); 5687dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5697dd252788645e940eada959bdde927426e2531c9Paul Duffin 5707dd252788645e940eada959bdde927426e2531c9Paul Duffin private static String normalizeToken(String token) { 5717dd252788645e940eada959bdde927426e2531c9Paul Duffin checkArgument(TOKEN_MATCHER.matchesAllOf(token)); 5727dd252788645e940eada959bdde927426e2531c9Paul Duffin return Ascii.toLowerCase(token); 5737dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5747dd252788645e940eada959bdde927426e2531c9Paul Duffin 5757dd252788645e940eada959bdde927426e2531c9Paul Duffin private static String normalizeParameterValue(String attribute, String value) { 5767dd252788645e940eada959bdde927426e2531c9Paul Duffin return CHARSET_ATTRIBUTE.equals(attribute) ? Ascii.toLowerCase(value) : value; 5777dd252788645e940eada959bdde927426e2531c9Paul Duffin } 5787dd252788645e940eada959bdde927426e2531c9Paul Duffin 5797dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 5807dd252788645e940eada959bdde927426e2531c9Paul Duffin * Parses a media type from its string representation. 5817dd252788645e940eada959bdde927426e2531c9Paul Duffin * 5827dd252788645e940eada959bdde927426e2531c9Paul Duffin * @throws IllegalArgumentException if the input is not parsable 5837dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 5847dd252788645e940eada959bdde927426e2531c9Paul Duffin public static MediaType parse(String input) { 5857dd252788645e940eada959bdde927426e2531c9Paul Duffin checkNotNull(input); 5867dd252788645e940eada959bdde927426e2531c9Paul Duffin Tokenizer tokenizer = new Tokenizer(input); 5877dd252788645e940eada959bdde927426e2531c9Paul Duffin try { 5887dd252788645e940eada959bdde927426e2531c9Paul Duffin String type = tokenizer.consumeToken(TOKEN_MATCHER); 5897dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeCharacter('/'); 5907dd252788645e940eada959bdde927426e2531c9Paul Duffin String subtype = tokenizer.consumeToken(TOKEN_MATCHER); 5917dd252788645e940eada959bdde927426e2531c9Paul Duffin ImmutableListMultimap.Builder<String, String> parameters = ImmutableListMultimap.builder(); 5927dd252788645e940eada959bdde927426e2531c9Paul Duffin while (tokenizer.hasMore()) { 5937dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeCharacter(';'); 5947dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeTokenIfPresent(LINEAR_WHITE_SPACE); 5957dd252788645e940eada959bdde927426e2531c9Paul Duffin String attribute = tokenizer.consumeToken(TOKEN_MATCHER); 5967dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeCharacter('='); 5977dd252788645e940eada959bdde927426e2531c9Paul Duffin final String value; 5987dd252788645e940eada959bdde927426e2531c9Paul Duffin if ('"' == tokenizer.previewChar()) { 5997dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeCharacter('"'); 6007dd252788645e940eada959bdde927426e2531c9Paul Duffin StringBuilder valueBuilder = new StringBuilder(); 6017dd252788645e940eada959bdde927426e2531c9Paul Duffin while ('"' != tokenizer.previewChar()) { 6027dd252788645e940eada959bdde927426e2531c9Paul Duffin if ('\\' == tokenizer.previewChar()) { 6037dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeCharacter('\\'); 6047dd252788645e940eada959bdde927426e2531c9Paul Duffin valueBuilder.append(tokenizer.consumeCharacter(ASCII)); 6057dd252788645e940eada959bdde927426e2531c9Paul Duffin } else { 6067dd252788645e940eada959bdde927426e2531c9Paul Duffin valueBuilder.append(tokenizer.consumeToken(QUOTED_TEXT_MATCHER)); 6077dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6087dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6097dd252788645e940eada959bdde927426e2531c9Paul Duffin value = valueBuilder.toString(); 6107dd252788645e940eada959bdde927426e2531c9Paul Duffin tokenizer.consumeCharacter('"'); 6117dd252788645e940eada959bdde927426e2531c9Paul Duffin } else { 6127dd252788645e940eada959bdde927426e2531c9Paul Duffin value = tokenizer.consumeToken(TOKEN_MATCHER); 6137dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6147dd252788645e940eada959bdde927426e2531c9Paul Duffin parameters.put(attribute, value); 6157dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6167dd252788645e940eada959bdde927426e2531c9Paul Duffin return create(type, subtype, parameters.build()); 6177dd252788645e940eada959bdde927426e2531c9Paul Duffin } catch (IllegalStateException e) { 6180888a09821a98ac0680fad765217302858e70fa4Paul Duffin throw new IllegalArgumentException("Could not parse '" + input + "'", e); 6197dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6207dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6217dd252788645e940eada959bdde927426e2531c9Paul Duffin 6227dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final class Tokenizer { 6237dd252788645e940eada959bdde927426e2531c9Paul Duffin final String input; 6247dd252788645e940eada959bdde927426e2531c9Paul Duffin int position = 0; 6257dd252788645e940eada959bdde927426e2531c9Paul Duffin 6267dd252788645e940eada959bdde927426e2531c9Paul Duffin Tokenizer(String input) { 6277dd252788645e940eada959bdde927426e2531c9Paul Duffin this.input = input; 6287dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6297dd252788645e940eada959bdde927426e2531c9Paul Duffin 6307dd252788645e940eada959bdde927426e2531c9Paul Duffin String consumeTokenIfPresent(CharMatcher matcher) { 6317dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(hasMore()); 6327dd252788645e940eada959bdde927426e2531c9Paul Duffin int startPosition = position; 6337dd252788645e940eada959bdde927426e2531c9Paul Duffin position = matcher.negate().indexIn(input, startPosition); 6347dd252788645e940eada959bdde927426e2531c9Paul Duffin return hasMore() ? input.substring(startPosition, position) : input.substring(startPosition); 6357dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6367dd252788645e940eada959bdde927426e2531c9Paul Duffin 6377dd252788645e940eada959bdde927426e2531c9Paul Duffin String consumeToken(CharMatcher matcher) { 6387dd252788645e940eada959bdde927426e2531c9Paul Duffin int startPosition = position; 6397dd252788645e940eada959bdde927426e2531c9Paul Duffin String token = consumeTokenIfPresent(matcher); 6407dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(position != startPosition); 6417dd252788645e940eada959bdde927426e2531c9Paul Duffin return token; 6427dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6437dd252788645e940eada959bdde927426e2531c9Paul Duffin 6447dd252788645e940eada959bdde927426e2531c9Paul Duffin char consumeCharacter(CharMatcher matcher) { 6457dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(hasMore()); 6467dd252788645e940eada959bdde927426e2531c9Paul Duffin char c = previewChar(); 6477dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(matcher.matches(c)); 6487dd252788645e940eada959bdde927426e2531c9Paul Duffin position++; 6497dd252788645e940eada959bdde927426e2531c9Paul Duffin return c; 6507dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6517dd252788645e940eada959bdde927426e2531c9Paul Duffin 6527dd252788645e940eada959bdde927426e2531c9Paul Duffin char consumeCharacter(char c) { 6537dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(hasMore()); 6547dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(previewChar() == c); 6557dd252788645e940eada959bdde927426e2531c9Paul Duffin position++; 6567dd252788645e940eada959bdde927426e2531c9Paul Duffin return c; 6577dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6587dd252788645e940eada959bdde927426e2531c9Paul Duffin 6597dd252788645e940eada959bdde927426e2531c9Paul Duffin char previewChar() { 6607dd252788645e940eada959bdde927426e2531c9Paul Duffin checkState(hasMore()); 6617dd252788645e940eada959bdde927426e2531c9Paul Duffin return input.charAt(position); 6627dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6637dd252788645e940eada959bdde927426e2531c9Paul Duffin 6647dd252788645e940eada959bdde927426e2531c9Paul Duffin boolean hasMore() { 6657dd252788645e940eada959bdde927426e2531c9Paul Duffin return (position >= 0) && (position < input.length()); 6667dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6677dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6687dd252788645e940eada959bdde927426e2531c9Paul Duffin 6690888a09821a98ac0680fad765217302858e70fa4Paul Duffin @Override public boolean equals(@Nullable Object obj) { 6707dd252788645e940eada959bdde927426e2531c9Paul Duffin if (obj == this) { 6717dd252788645e940eada959bdde927426e2531c9Paul Duffin return true; 6727dd252788645e940eada959bdde927426e2531c9Paul Duffin } else if (obj instanceof MediaType) { 6737dd252788645e940eada959bdde927426e2531c9Paul Duffin MediaType that = (MediaType) obj; 6740888a09821a98ac0680fad765217302858e70fa4Paul Duffin return this.type.equals(that.type) 6750888a09821a98ac0680fad765217302858e70fa4Paul Duffin && this.subtype.equals(that.subtype) 6760888a09821a98ac0680fad765217302858e70fa4Paul Duffin // compare parameters regardless of order 6777dd252788645e940eada959bdde927426e2531c9Paul Duffin && this.parametersAsMap().equals(that.parametersAsMap()); 6787dd252788645e940eada959bdde927426e2531c9Paul Duffin } else { 6797dd252788645e940eada959bdde927426e2531c9Paul Duffin return false; 6807dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6817dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6827dd252788645e940eada959bdde927426e2531c9Paul Duffin 6830888a09821a98ac0680fad765217302858e70fa4Paul Duffin @Override public int hashCode() { 6847dd252788645e940eada959bdde927426e2531c9Paul Duffin return Objects.hashCode(type, subtype, parametersAsMap()); 6857dd252788645e940eada959bdde927426e2531c9Paul Duffin } 6867dd252788645e940eada959bdde927426e2531c9Paul Duffin 6877dd252788645e940eada959bdde927426e2531c9Paul Duffin private static final MapJoiner PARAMETER_JOINER = Joiner.on("; ").withKeyValueSeparator("="); 6887dd252788645e940eada959bdde927426e2531c9Paul Duffin 6897dd252788645e940eada959bdde927426e2531c9Paul Duffin /** 6907dd252788645e940eada959bdde927426e2531c9Paul Duffin * Returns the string representation of this media type in the format described in <a 6917dd252788645e940eada959bdde927426e2531c9Paul Duffin * href="http://www.ietf.org/rfc/rfc2045.txt">RFC 2045</a>. 6927dd252788645e940eada959bdde927426e2531c9Paul Duffin */ 6930888a09821a98ac0680fad765217302858e70fa4Paul Duffin @Override public String toString() { 6947dd252788645e940eada959bdde927426e2531c9Paul Duffin StringBuilder builder = new StringBuilder().append(type).append('/').append(subtype); 6957dd252788645e940eada959bdde927426e2531c9Paul Duffin if (!parameters.isEmpty()) { 6967dd252788645e940eada959bdde927426e2531c9Paul Duffin builder.append("; "); 6977dd252788645e940eada959bdde927426e2531c9Paul Duffin Multimap<String, String> quotedParameters = Multimaps.transformValues(parameters, 6987dd252788645e940eada959bdde927426e2531c9Paul Duffin new Function<String, String>() { 6990888a09821a98ac0680fad765217302858e70fa4Paul Duffin @Override public String apply(String value) { 7007dd252788645e940eada959bdde927426e2531c9Paul Duffin return TOKEN_MATCHER.matchesAllOf(value) ? value : escapeAndQuote(value); 7017dd252788645e940eada959bdde927426e2531c9Paul Duffin } 7027dd252788645e940eada959bdde927426e2531c9Paul Duffin }); 7037dd252788645e940eada959bdde927426e2531c9Paul Duffin PARAMETER_JOINER.appendTo(builder, quotedParameters.entries()); 7047dd252788645e940eada959bdde927426e2531c9Paul Duffin } 7057dd252788645e940eada959bdde927426e2531c9Paul Duffin return builder.toString(); 7067dd252788645e940eada959bdde927426e2531c9Paul Duffin } 7077dd252788645e940eada959bdde927426e2531c9Paul Duffin 7087dd252788645e940eada959bdde927426e2531c9Paul Duffin private static String escapeAndQuote(String value) { 7097dd252788645e940eada959bdde927426e2531c9Paul Duffin StringBuilder escaped = new StringBuilder(value.length() + 16).append('"'); 7107dd252788645e940eada959bdde927426e2531c9Paul Duffin for (char ch : value.toCharArray()) { 7117dd252788645e940eada959bdde927426e2531c9Paul Duffin if (ch == '\r' || ch == '\\' || ch == '"') { 7127dd252788645e940eada959bdde927426e2531c9Paul Duffin escaped.append('\\'); 7137dd252788645e940eada959bdde927426e2531c9Paul Duffin } 7147dd252788645e940eada959bdde927426e2531c9Paul Duffin escaped.append(ch); 7157dd252788645e940eada959bdde927426e2531c9Paul Duffin } 7167dd252788645e940eada959bdde927426e2531c9Paul Duffin return escaped.append('"').toString(); 7177dd252788645e940eada959bdde927426e2531c9Paul Duffin } 7187dd252788645e940eada959bdde927426e2531c9Paul Duffin 7197dd252788645e940eada959bdde927426e2531c9Paul Duffin} 720