MediaType (Guava: Google Core Libraries for Java 27.0.1-android API)

java.lang.Object
- com.google.common.net.MediaType

```
@Beta
 @GwtCompatible
 @Immutable
public final class MediaType
extends Object
```
Represents an Internet Media Type (also known as a MIME Type or Content Type). This class also supports the concept of media ranges defined by HTTP/1.1. As such, the * character is treated as a wildcard and is used to represent any acceptable type or subtype value. A media type may not have wildcard type with a declared subtype. The * character has no special meaning as part of a parameter. All values for type, subtype, parameter attributes or parameter values must be valid according to RFCs 2045 and 2046.
All portions of the media type that are case-insensitive (type, subtype, parameter attributes) are normalized to lowercase. The value of the charset parameter is normalized to lowercase, but all others are left as-is.
Note that this specifically does not represent the value of the MIME Content-Type header and as such has no support for header-specific considerations such as line folding and comments.
For media types that take a charset the predefined constants default to UTF-8 and have a "_UTF_8" suffix. To get a version without a character set, use withoutParameters().

Since:

12.0

Author:

Gregory Kick

Field Summary

Fields
Modifier and Type	Field and Description
`static MediaType`	`AAC_AUDIO` Media type for Advanced Audio Coding.
`static MediaType`	`ANY_APPLICATION_TYPE`
`static MediaType`	`ANY_AUDIO_TYPE`
`static MediaType`	`ANY_IMAGE_TYPE`
`static MediaType`	`ANY_TEXT_TYPE`
`static MediaType`	`ANY_TYPE`
`static MediaType`	`ANY_VIDEO_TYPE`
`static MediaType`	`APPLE_MOBILE_CONFIG` Media type for Apple over-the-air mobile configuration profiles.
`static MediaType`	`APPLE_PASSBOOK` Media type for Apple Passbook.
`static MediaType`	`APPLICATION_BINARY` This is a non-standard media type, but is commonly used in serving hosted binary files as it is known not to trigger content sniffing in current browsers.
`static MediaType`	`APPLICATION_XML_UTF_8` As described in RFC 3023, this constant (`application/xml`) is used for XML documents that are "unreadable by casual users." `XML_UTF_8` is provided for documents that may be read by users.
`static MediaType`	`ATOM_UTF_8`
`static MediaType`	`BASIC_AUDIO` Media type for Basic Audio, as defined by RFC 2046.
`static MediaType`	`BMP`
`static MediaType`	`BZIP2`
`static MediaType`	`CACHE_MANIFEST_UTF_8`
`static MediaType`	`CRW` The media type for the Canon Image File Format (`crw` files), a widely-used "raw image" format for cameras.
`static MediaType`	`CSS_UTF_8`
`static MediaType`	`CSV_UTF_8`
`static MediaType`	`DART_UTF_8` Media type for dart files.
`static MediaType`	`EOT` Media type for Embedded OpenType fonts.
`static MediaType`	`EPUB` As described in the International Digital Publishing Forum EPUB is the distribution and interchange format standard for digital publications and documents.
`static MediaType`	`FLV_VIDEO` Media type for Flash video.
`static MediaType`	`FORM_DATA`
`static MediaType`	`GIF`
`static MediaType`	`GZIP`
`static MediaType`	`HAL_JSON` Media type for the JSON Hypertext Application Language (HAL) documents.
`static MediaType`	`HTML_UTF_8`
`static MediaType`	`I_CALENDAR_UTF_8`
`static MediaType`	`ICO`
`static MediaType`	`JAVASCRIPT_UTF_8` RFC 4329 declares this to be the correct media type for JavaScript, but `text/javascript` may be necessary in certain situations for compatibility.
`static MediaType`	`JPEG`
`static MediaType`	`JSON_UTF_8`
`static MediaType`	`KEY_ARCHIVE` As described in PKCS #12: Personal Information Exchange Syntax Standard, PKCS #12 defines an archive file format for storing many cryptography objects as a single file.
`static MediaType`	`KML` Media type for OGC KML (Keyhole Markup Language).
`static MediaType`	`KMZ` Media type for OGC KML (Keyhole Markup Language), compressed using the ZIP format into KMZ archives.
`static MediaType`	`L16_AUDIO` Media type for L16 audio, as defined by RFC 2586.
`static MediaType`	`L24_AUDIO` Media type for L24 audio, as defined by RFC 3190.
`static MediaType`	`MANIFEST_JSON_UTF_8` Media type for the Manifest for a web application.
`static MediaType`	`MBOX` Media type for the mbox database format.
`static MediaType`	`MICROSOFT_EXCEL`
`static MediaType`	`MICROSOFT_POWERPOINT`
`static MediaType`	`MICROSOFT_WORD`
`static MediaType`	`MP4_AUDIO`
`static MediaType`	`MP4_VIDEO`
`static MediaType`	`MPEG_AUDIO`
`static MediaType`	`MPEG_VIDEO`
`static MediaType`	`NACL_APPLICATION` Media type for NaCl applications.
`static MediaType`	`NACL_PORTABLE_APPLICATION` Media type for NaCl portable applications.
`static MediaType`	`OCTET_STREAM`
`static MediaType`	`OGG_AUDIO`
`static MediaType`	`OGG_CONTAINER`
`static MediaType`	`OGG_VIDEO`
`static MediaType`	`OOXML_DOCUMENT`
`static MediaType`	`OOXML_PRESENTATION`
`static MediaType`	`OOXML_SHEET`
`static MediaType`	`OPENDOCUMENT_GRAPHICS`
`static MediaType`	`OPENDOCUMENT_PRESENTATION`
`static MediaType`	`OPENDOCUMENT_SPREADSHEET`
`static MediaType`	`OPENDOCUMENT_TEXT`
`static MediaType`	`PDF`
`static MediaType`	`PLAIN_TEXT_UTF_8`
`static MediaType`	`PNG`
`static MediaType`	`POSTSCRIPT`
`static MediaType`	`PROTOBUF` Protocol buffers
`static MediaType`	`PSD` The media type for the Photoshop File Format (`psd` files) as defined by IANA, and found in `/etc/mime.types`, e.g.
`static MediaType`	`QUICKTIME`
`static MediaType`	`RDF_XML_UTF_8`
`static MediaType`	`RTF_UTF_8`
`static MediaType`	`SFNT` Media type for SFNT fonts (which includes TrueType and OpenType fonts).
`static MediaType`	`SHOCKWAVE_FLASH`
`static MediaType`	`SKETCHUP`
`static MediaType`	`SOAP_XML_UTF_8` As described in RFC 3902, this constant (`application/soap+xml`) is used to identify SOAP 1.2 message envelopes that have been serialized with XML 1.0.
`static MediaType`	`SVG_UTF_8`
`static MediaType`	`TAR`
`static MediaType`	`TEXT_JAVASCRIPT_UTF_8` RFC 4329 declares `application/javascript` to be the correct media type for JavaScript, but this may be necessary in certain situations for compatibility.
`static MediaType`	`THREE_GPP_VIDEO` Media type for the 3GP multimedia container format.
`static MediaType`	`THREE_GPP2_VIDEO` Media type for the 3G2 multimedia container format.
`static MediaType`	`TIFF`
`static MediaType`	`TSV_UTF_8` Tab separated values.
`static MediaType`	`VCARD_UTF_8`
`static MediaType`	`VND_REAL_AUDIO` Media type for Real Audio.
`static MediaType`	`VND_WAVE_AUDIO` Media type for WAVE format, as defined by RFC 2361.
`static MediaType`	`VORBIS_AUDIO` Media type for Vorbis Audio, as defined by RFC 5215.
`static MediaType`	`VTT_UTF_8` As described in the VTT spec, this is used for Web Video Text Tracks (WebVTT) files, used with the HTML5 track element.
`static MediaType`	`WASM_APPLICATION` Media type for WASM applications.
`static MediaType`	`WAX_AUDIO` Media type for Windows Media metafiles.
`static MediaType`	`WEBM_AUDIO`
`static MediaType`	`WEBM_VIDEO`
`static MediaType`	`WEBP`
`static MediaType`	`WMA_AUDIO` Media type for Windows Media Audio.
`static MediaType`	`WML_UTF_8`
`static MediaType`	`WMV`
`static MediaType`	`WOFF` Media type for the Web Open Font Format (WOFF) defined by the W3C.
`static MediaType`	`WOFF2` Media type for the Web Open Font Format (WOFF) version 2 defined by the W3C.
`static MediaType`	`XHTML_UTF_8`
`static MediaType`	`XML_UTF_8` As described in RFC 3023, this constant (`text/xml`) is used for XML documents that are "readable by casual users." `APPLICATION_XML_UTF_8` is provided for documents that are intended for applications.
`static MediaType`	`XRD_UTF_8` Media type for Extensible Resource Descriptors.
`static MediaType`	`ZIP`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Optional<Charset>`	`charset()` Returns an optional charset for the value of the charset parameter if it is specified.
`static MediaType`	`create(String type, String subtype)` Creates a new media type with the given type and subtype.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`int`	`hashCode()` Returns a hash code value for the object.
`boolean`	`hasWildcard()` Returns true if either the type or subtype is the wildcard.
`boolean`	`is(MediaType mediaTypeRange)` Returns `true` if this instance falls within the range (as defined by the HTTP Accept header) given by the argument according to three criteria: The type of the argument is the wildcard or equal to the type of this instance.
`ImmutableListMultimap<String,String>`	`parameters()` Returns a multimap containing the parameters of this media type.
`static MediaType`	`parse(String input)` Parses a media type from its string representation.
`String`	`subtype()` Returns the media subtype.
`String`	`toString()` Returns the string representation of this media type in the format described in RFC 2045.
`String`	`type()` Returns the top-level media type.
`MediaType`	`withCharset(Charset charset)` Returns a new instance with the same type and subtype as this instance, with the `charset` parameter set to the `name` of the given charset.
`MediaType`	`withoutParameters()` Returns a new instance with the same type and subtype as this instance, but without any parameters.
`MediaType`	`withParameter(String attribute, String value)` Replaces all parameters with the given attribute with a single parameter with the given value.
`MediaType`	`withParameters(Multimap<String,String> parameters)` Replaces all parameters with the given parameters.
`MediaType`	`withParameters(String attribute, Iterable<String> values)` Replaces all parameters with the given attribute with parameters using the given values.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ANY_TYPE
```
public static final MediaType ANY_TYPE
```
  - ANY_TEXT_TYPE
```
public static final MediaType ANY_TEXT_TYPE
```
  - ANY_IMAGE_TYPE
```
public static final MediaType ANY_IMAGE_TYPE
```
  - ANY_AUDIO_TYPE
```
public static final MediaType ANY_AUDIO_TYPE
```
  - ANY_VIDEO_TYPE
```
public static final MediaType ANY_VIDEO_TYPE
```
  - ANY_APPLICATION_TYPE
```
public static final MediaType ANY_APPLICATION_TYPE
```
  - CACHE_MANIFEST_UTF_8
```
public static final MediaType CACHE_MANIFEST_UTF_8
```
  - CSS_UTF_8
```
public static final MediaType CSS_UTF_8
```
  - CSV_UTF_8
```
public static final MediaType CSV_UTF_8
```
  - HTML_UTF_8
```
public static final MediaType HTML_UTF_8
```
  - I_CALENDAR_UTF_8
```
public static final MediaType I_CALENDAR_UTF_8
```
  - PLAIN_TEXT_UTF_8
```
public static final MediaType PLAIN_TEXT_UTF_8
```
  - TEXT_JAVASCRIPT_UTF_8
```
public static final MediaType TEXT_JAVASCRIPT_UTF_8
```
    RFC 4329 declares application/javascript to be the correct media type for JavaScript, but this may be necessary in certain situations for compatibility.
  - TSV_UTF_8
```
public static final MediaType TSV_UTF_8
```
    Tab separated values.
    
    Since:
    
    15.0
  - VCARD_UTF_8
```
public static final MediaType VCARD_UTF_8
```
  - WML_UTF_8
```
public static final MediaType WML_UTF_8
```
  - XML_UTF_8
```
public static final MediaType XML_UTF_8
```
    As described in RFC 3023, this constant (text/xml) is used for XML documents that are "readable by casual users." APPLICATION_XML_UTF_8 is provided for documents that are intended for applications.
  - VTT_UTF_8
```
public static final MediaType VTT_UTF_8
```
    As described in the VTT spec, this is used for Web Video Text Tracks (WebVTT) files, used with the HTML5 track element.
    
    Since:
    
    20.0
  - BMP
```
public static final MediaType BMP
```
  - CRW
```
public static final MediaType CRW
```
    The media type for the Canon Image File Format (crw files), a widely-used "raw image" format for cameras. It is found in /etc/mime.types, e.g. in Debian 3.48-1.
    
    Since:
    
    15.0
  - GIF
```
public static final MediaType GIF
```
  - ICO
```
public static final MediaType ICO
```
  - JPEG
```
public static final MediaType JPEG
```
  - PNG
```
public static final MediaType PNG
```
  - PSD
```
public static final MediaType PSD
```
    The media type for the Photoshop File Format (psd files) as defined by IANA, and found in /etc/mime.types, e.g. of the Apache HTTPD project; for the specification, see Adobe Photoshop Document Format and Wikipedia; this is the regular output/input of Photoshop (which can also export to various image formats; note that files with extension "PSB" are in a distinct but related format).
    This is a more recent replacement for the older, experimental type x-photoshop: RFC-2046.6.
    
    Since:
    
    15.0
  - SVG_UTF_8
```
public static final MediaType SVG_UTF_8
```
  - TIFF
```
public static final MediaType TIFF
```
  - WEBP
```
public static final MediaType WEBP
```
  - MP4_AUDIO
```
public static final MediaType MP4_AUDIO
```
  - MPEG_AUDIO
```
public static final MediaType MPEG_AUDIO
```
  - OGG_AUDIO
```
public static final MediaType OGG_AUDIO
```
  - WEBM_AUDIO
```
public static final MediaType WEBM_AUDIO
```
  - L16_AUDIO
```
public static final MediaType L16_AUDIO
```
    Media type for L16 audio, as defined by RFC 2586.
    
    Since:
    
    24.1
  - L24_AUDIO
```
public static final MediaType L24_AUDIO
```
    Media type for L24 audio, as defined by RFC 3190.
    
    Since:
    
    20.0
  - BASIC_AUDIO
```
public static final MediaType BASIC_AUDIO
```
    Media type for Basic Audio, as defined by RFC 2046.
    
    Since:
    
    20.0
  - AAC_AUDIO
```
public static final MediaType AAC_AUDIO
```
    Media type for Advanced Audio Coding. For more information, see Advanced Audio Coding.
    
    Since:
    
    20.0
  - VORBIS_AUDIO
```
public static final MediaType VORBIS_AUDIO
```
    Media type for Vorbis Audio, as defined by RFC 5215.
    
    Since:
    
    20.0
  - WMA_AUDIO
```
public static final MediaType WMA_AUDIO
```
    Media type for Windows Media Audio. For more information, see file name extensions for Windows Media metafiles.
    
    Since:
    
    20.0
  - WAX_AUDIO
```
public static final MediaType WAX_AUDIO
```
    Media type for Windows Media metafiles. For more information, see file name extensions for Windows Media metafiles.
    
    Since:
    
    20.0
  - VND_REAL_AUDIO
```
public static final MediaType VND_REAL_AUDIO
```
    Media type for Real Audio. For more information, see this link.
    
    Since:
    
    20.0
  - VND_WAVE_AUDIO
```
public static final MediaType VND_WAVE_AUDIO
```
    Media type for WAVE format, as defined by RFC 2361.
    
    Since:
    
    20.0
  - MP4_VIDEO
```
public static final MediaType MP4_VIDEO
```
  - MPEG_VIDEO
```
public static final MediaType MPEG_VIDEO
```
  - OGG_VIDEO
```
public static final MediaType OGG_VIDEO
```
  - QUICKTIME
```
public static final MediaType QUICKTIME
```
  - WEBM_VIDEO
```
public static final MediaType WEBM_VIDEO
```
  - WMV
```
public static final MediaType WMV
```
  - FLV_VIDEO
```
public static final MediaType FLV_VIDEO
```
    Media type for Flash video. For more information, see this link.
    
    Since:
    
    20.0
  - THREE_GPP_VIDEO
```
public static final MediaType THREE_GPP_VIDEO
```
    Media type for the 3GP multimedia container format. For more information, see 3GPP TS 26.244.
    
    Since:
    
    20.0
  - THREE_GPP2_VIDEO
```
public static final MediaType THREE_GPP2_VIDEO
```
    Media type for the 3G2 multimedia container format. For more information, see 3GPP2 C.S0050-B.
    
    Since:
    
    20.0
  - APPLICATION_XML_UTF_8
```
public static final MediaType APPLICATION_XML_UTF_8
```
    As described in RFC 3023, this constant (application/xml) is used for XML documents that are "unreadable by casual users." XML_UTF_8 is provided for documents that may be read by users.
  - ATOM_UTF_8
```
public static final MediaType ATOM_UTF_8
```
  - BZIP2
```
public static final MediaType BZIP2
```
  - DART_UTF_8
```
public static final MediaType DART_UTF_8
```
    Media type for dart files.
    
    Since:
    
    19.0
  - APPLE_PASSBOOK
```
public static final MediaType APPLE_PASSBOOK
```
    Media type for Apple Passbook.
    
    Since:
    
    19.0
  - EOT
```
public static final MediaType EOT
```
    Media type for Embedded OpenType fonts. This is registered with the IANA.
    
    Since:
    
    17.0
  - EPUB
```
public static final MediaType EPUB
```
    As described in the International Digital Publishing Forum EPUB is the distribution and interchange format standard for digital publications and documents. This media type is defined in the EPUB Open Container Format specification.
    
    Since:
    
    15.0
  - FORM_DATA
```
public static final MediaType FORM_DATA
```
  - KEY_ARCHIVE
```
public static final MediaType KEY_ARCHIVE
```
    As described in PKCS #12: Personal Information Exchange Syntax Standard, PKCS #12 defines an archive file format for storing many cryptography objects as a single file.
    
    Since:
    
    15.0
  - APPLICATION_BINARY
```
public static final MediaType APPLICATION_BINARY
```
    This is a non-standard media type, but is commonly used in serving hosted binary files as it is known not to trigger content sniffing in current browsers. It should not be used in other situations as it is not specified by any RFC and does not appear in the /IANA MIME Media Types list. Consider OCTET_STREAM for binary data that is not being served to a browser.
    
    Since:
    
    14.0
  - GZIP
```
public static final MediaType GZIP
```
  - HAL_JSON
```
public static final MediaType HAL_JSON
```
    Media type for the JSON Hypertext Application Language (HAL) documents.
    
    Since:
    
    26.0
  - JAVASCRIPT_UTF_8
```
public static final MediaType JAVASCRIPT_UTF_8
```
    RFC 4329 declares this to be the correct media type for JavaScript, but text/javascript may be necessary in certain situations for compatibility.
  - JSON_UTF_8
```
public static final MediaType JSON_UTF_8
```
  - MANIFEST_JSON_UTF_8
```
public static final MediaType MANIFEST_JSON_UTF_8
```
    Media type for the Manifest for a web application.
    
    Since:
    
    19.0
  - KML
```
public static final MediaType KML
```
    Media type for OGC KML (Keyhole Markup Language).
  - KMZ
```
public static final MediaType KMZ
```
    Media type for OGC KML (Keyhole Markup Language), compressed using the ZIP format into KMZ archives.
  - MBOX
```
public static final MediaType MBOX
```
    Media type for the mbox database format.
  - APPLE_MOBILE_CONFIG
```
public static final MediaType APPLE_MOBILE_CONFIG
```
    Media type for Apple over-the-air mobile configuration profiles.
    
    Since:
    
    18.0
  - MICROSOFT_EXCEL
```
public static final MediaType MICROSOFT_EXCEL
```
  - MICROSOFT_POWERPOINT
```
public static final MediaType MICROSOFT_POWERPOINT
```
  - MICROSOFT_WORD
```
public static final MediaType MICROSOFT_WORD
```
  - WASM_APPLICATION
```
public static final MediaType WASM_APPLICATION
```
    Media type for WASM applications. For more information see the Web Assembly overview.
    
    Since:
    
    27.0
  - NACL_APPLICATION
```
public static final MediaType NACL_APPLICATION
```
    Media type for NaCl applications. For more information see the Developer Guide for Native Client Application Structure.
    
    Since:
    
    20.0
  - NACL_PORTABLE_APPLICATION
```
public static final MediaType NACL_PORTABLE_APPLICATION
```
    Media type for NaCl portable applications. For more information see the Developer Guide for Native Client Application Structure.
    
    Since:
    
    20.0
  - OCTET_STREAM
```
public static final MediaType OCTET_STREAM
```
  - OGG_CONTAINER
```
public static final MediaType OGG_CONTAINER
```
  - OOXML_DOCUMENT
```
public static final MediaType OOXML_DOCUMENT
```
  - OOXML_PRESENTATION
```
public static final MediaType OOXML_PRESENTATION
```
  - OOXML_SHEET
```
public static final MediaType OOXML_SHEET
```
  - OPENDOCUMENT_GRAPHICS
```
public static final MediaType OPENDOCUMENT_GRAPHICS
```
  - OPENDOCUMENT_PRESENTATION
```
public static final MediaType OPENDOCUMENT_PRESENTATION
```
  - OPENDOCUMENT_SPREADSHEET
```
public static final MediaType OPENDOCUMENT_SPREADSHEET
```
  - OPENDOCUMENT_TEXT
```
public static final MediaType OPENDOCUMENT_TEXT
```
  - PDF
```
public static final MediaType PDF
```
  - POSTSCRIPT
```
public static final MediaType POSTSCRIPT
```
  - PROTOBUF
```
public static final MediaType PROTOBUF
```
    Protocol buffers
    
    Since:
    
    15.0
  - RDF_XML_UTF_8
```
public static final MediaType RDF_XML_UTF_8
```
  - RTF_UTF_8
```
public static final MediaType RTF_UTF_8
```
  - SFNT
```
public static final MediaType SFNT
```
    Media type for SFNT fonts (which includes TrueType and OpenType fonts). This is registered with the IANA.
    
    Since:
    
    17.0
  - SHOCKWAVE_FLASH
```
public static final MediaType SHOCKWAVE_FLASH
```
  - SKETCHUP
```
public static final MediaType SKETCHUP
```
  - SOAP_XML_UTF_8
```
public static final MediaType SOAP_XML_UTF_8
```
    As described in RFC 3902, this constant (application/soap+xml) is used to identify SOAP 1.2 message envelopes that have been serialized with XML 1.0.
    For SOAP 1.1 messages, see XML_UTF_8 per W3C Note on Simple Object Access Protocol (SOAP) 1.1
    
    Since:
    
    20.0
  - TAR
```
public static final MediaType TAR
```
  - WOFF
```
public static final MediaType WOFF
```
    Media type for the Web Open Font Format (WOFF) defined by the W3C. This is registered with the IANA.
    
    Since:
    
    17.0
  - WOFF2
```
public static final MediaType WOFF2
```
    Media type for the Web Open Font Format (WOFF) version 2 defined by the W3C.
    
    Since:
    
    20.0
  - XHTML_UTF_8
```
public static final MediaType XHTML_UTF_8
```
  - XRD_UTF_8
```
public static final MediaType XRD_UTF_8
```
    Media type for Extensible Resource Descriptors. This is not yet registered with the IANA, but it is specified by OASIS in the XRD definition and implemented in projects such as WebFinger.
  - ZIP
```
public static final MediaType ZIP
```
- Method Detail
  - type
```
public String type()
```
    Returns the top-level media type. For example, "text" in "text/plain".
  - subtype
```
public String subtype()
```
    Returns the media subtype. For example, "plain" in "text/plain".
  - parameters
```
public ImmutableListMultimap<String,String> parameters()
```
    Returns a multimap containing the parameters of this media type.
  - charset
```
public Optional<Charset> charset()
```
    Returns an optional charset for the value of the charset parameter if it is specified.
    
    Throws:
    
    IllegalStateException - if multiple charset values have been set for this media type
    
    IllegalCharsetNameException - if a charset value is present, but illegal
    
    UnsupportedCharsetException - if a charset value is present, but no support is available in this instance of the Java virtual machine
  - withoutParameters
```
public MediaType withoutParameters()
```
    Returns a new instance with the same type and subtype as this instance, but without any parameters.
  - withParameters
```
public MediaType withParameters(Multimap<String,String> parameters)
```
    Replaces all parameters with the given parameters.
    
    Throws:
    
    IllegalArgumentException - if any parameter or value is invalid
  - withParameters
```
public MediaType withParameters(String attribute,
                                Iterable<String> values)
```
    Replaces all parameters with the given attribute with parameters using the given values. If there are no values, any existing parameters with the given attribute are removed.
    
    Throws:
    
    IllegalArgumentException - if either attribute or values is invalid
    
    Since:
    
    24.0
  - withParameter
```
public MediaType withParameter(String attribute,
                               String value)
```
    Replaces all parameters with the given attribute with a single parameter with the given value. If multiple parameters with the same attributes are necessary use withParameters(String, Iterable). Prefer withCharset(java.nio.charset.Charset) for setting the charset parameter when using a Charset object.
    
    Throws:
    
    IllegalArgumentException - if either attribute or value is invalid
  - withCharset
```
public MediaType withCharset(Charset charset)
```
    Returns a new instance with the same type and subtype as this instance, with the charset parameter set to the name of the given charset. Only one charset parameter will be present on the new instance regardless of the number set on this one.
    If a charset must be specified that is not supported on this JVM (and thus is not representable as a Charset instance, use withParameter(java.lang.String, java.lang.String).
  - hasWildcard
```
public boolean hasWildcard()
```
    Returns true if either the type or subtype is the wildcard.
  - is
```
public boolean is(MediaType mediaTypeRange)
```
    Returns true if this instance falls within the range (as defined by the HTTP Accept header) given by the argument according to three criteria:
    1. The type of the argument is the wildcard or equal to the type of this instance.
    2. The subtype of the argument is the wildcard or equal to the subtype of this instance.
    3. All of the parameters present in the argument are present in this instance.
    For example:
```
 PLAIN_TEXT_UTF_8.is(PLAIN_TEXT_UTF_8) // true
 PLAIN_TEXT_UTF_8.is(HTML_UTF_8) // false
 PLAIN_TEXT_UTF_8.is(ANY_TYPE) // true
 PLAIN_TEXT_UTF_8.is(ANY_TEXT_TYPE) // true
 PLAIN_TEXT_UTF_8.is(ANY_IMAGE_TYPE) // false
 PLAIN_TEXT_UTF_8.is(ANY_TEXT_TYPE.withCharset(UTF_8)) // true
 PLAIN_TEXT_UTF_8.withoutParameters().is(ANY_TEXT_TYPE.withCharset(UTF_8)) // false
 PLAIN_TEXT_UTF_8.is(ANY_TEXT_TYPE.withCharset(UTF_16)) // false
 
```
    Note that while it is possible to have the same parameter declared multiple times within a media type this method does not consider the number of occurrences of a parameter. For example, "text/plain; charset=UTF-8" satisfies "text/plain; charset=UTF-8; charset=UTF-8".
  - create
```
public static MediaType create(String type,
                               String subtype)
```
    Creates a new media type with the given type and subtype.
    
    Throws:
    
    IllegalArgumentException - if type or subtype is invalid or if a wildcard is used for the type, but not the subtype.
  - parse
```
public static MediaType parse(String input)
```
    Parses a media type from its string representation.
    
    Throws:
    
    IllegalArgumentException - if the input is not parsable
  - equals
```
public boolean equals(@NullableDecl
                      Object obj)
```
    Description copied from class: java.lang.Object
    Indicates whether some other object is "equal to" this one.
    The equals method implements an equivalence relation on non-null object references:
    - It is reflexive: for any non-null reference value x, x.equals(x) should return true.
    - It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
    - It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
    - It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
    - For any non-null reference value x, x.equals(null) should return false.
    The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).
    Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - the reference object with which to compare.
    
    Returns:
    
    true if this object is the same as the obj argument; false otherwise.
    
    See Also:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    Description copied from class: java.lang.Object
    Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.
    The general contract of hashCode is:
    - Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
    - If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
    - It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
    As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java™ programming language.)
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    a hash code value for this object.
    
    See Also:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Returns the string representation of this media type in the format described in RFC 2045.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a string representation of the object.

Class MediaType

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ANY_TYPE

ANY_TEXT_TYPE

ANY_IMAGE_TYPE

ANY_AUDIO_TYPE

ANY_VIDEO_TYPE

ANY_APPLICATION_TYPE

CACHE_MANIFEST_UTF_8

CSS_UTF_8

CSV_UTF_8

HTML_UTF_8

I_CALENDAR_UTF_8

PLAIN_TEXT_UTF_8

TEXT_JAVASCRIPT_UTF_8

TSV_UTF_8

VCARD_UTF_8

WML_UTF_8

XML_UTF_8

VTT_UTF_8

BMP

CRW

GIF

ICO

JPEG

PNG

PSD

SVG_UTF_8

TIFF

WEBP

MP4_AUDIO

MPEG_AUDIO

OGG_AUDIO

WEBM_AUDIO

L16_AUDIO

L24_AUDIO

BASIC_AUDIO

AAC_AUDIO

VORBIS_AUDIO

WMA_AUDIO

WAX_AUDIO

VND_REAL_AUDIO

VND_WAVE_AUDIO

MP4_VIDEO

MPEG_VIDEO

OGG_VIDEO

QUICKTIME

WEBM_VIDEO

WMV

FLV_VIDEO

THREE_GPP_VIDEO

THREE_GPP2_VIDEO

APPLICATION_XML_UTF_8

ATOM_UTF_8

BZIP2

DART_UTF_8

APPLE_PASSBOOK

EOT

EPUB

FORM_DATA

KEY_ARCHIVE

APPLICATION_BINARY

GZIP

HAL_JSON

JAVASCRIPT_UTF_8

JSON_UTF_8

MANIFEST_JSON_UTF_8

KML

KMZ

MBOX

APPLE_MOBILE_CONFIG

MICROSOFT_EXCEL

MICROSOFT_POWERPOINT

MICROSOFT_WORD

WASM_APPLICATION

NACL_APPLICATION

NACL_PORTABLE_APPLICATION