freenet.support

Class MediaType

java.lang.Object

freenet.support.MediaType

public class MediaType
extends java.lang.Object

A media type denotes the content type of a document. A media consists of a top-level type, a subtype, and an optional list of key-value pairs. An example would be “audio/ogg” or “text/html; charset=utf-8.”

MediaTypes are immutable. The setter methods (e.g. setType(String) and setSubtype(String)) return new MediaType objects with the requested part changed and all other parts copied.

Media types are defined in RFC 2046.

Constructor Summary

Constructors

Constructor and Description
MediaType(java.lang.String mediaType) Creates a new media type by parsing the given string.
MediaType(java.lang.String type, java.lang.String subtype, java.util.Map<java.lang.String,java.lang.String> parameters) Creates a new media type.
MediaType(java.lang.String type, java.lang.String subtype, java.lang.String... parameters) Creates a new media type.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getCharsetRobust(java.lang.String expectedMimeType)
static java.lang.String	getCharsetRobustOrUTF(java.lang.String expectedMimeType)
java.lang.String	getParameter(java.lang.String name) Returns the value of the parameter with the given name.
java.util.LinkedHashMap<java.lang.String,java.lang.String>	getParameters()
java.lang.String	getPlainType() Get the base type without any parameters
java.lang.String	getSubtype() Returns the subtype of this media type.
java.lang.String	getType() Returns the top-level type of this media type.
MediaType	removeParameter(java.lang.String name) Creates a new media type that has the same top-level type, subtype, and parameters as this media type but has the parameter with the given name removed.
MediaType	setParameter(java.lang.String name, java.lang.String value) Creates a new media type that has the same top-level type, subtype, and parameters as this media type but has the parameter with the given name changed to the given value.
MediaType	setSubtype(java.lang.String subtype) Creates a new media type that has the same top-level type and parameters as this media type and the given subtype as subtype.
MediaType	setType(java.lang.String type) Creates a new media type that has the same subtype and parameters as this media type and the given type as top-level type.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MediaType

public MediaType(java.lang.String mediaType)
          throws java.lang.NullPointerException,
                 java.net.MalformedURLException

Creates a new media type by parsing the given string.

Parameters:

mediaType - The media type to parse

Throws:

java.lang.NullPointerException - if mediaType is null

java.net.MalformedURLException - if mediaType is incorrectly formatted, i.e. does not contain a slash, or a parameter does not contain an equals sign

MediaType

public MediaType(java.lang.String type,
                 java.lang.String subtype,
                 java.lang.String... parameters)
          throws java.lang.IllegalArgumentException

Creates a new media type.

Parameters:

type - The top-level type

subtype - The subtype

parameters - The parameters in key-value pairs, in the order key1, value1, key2, value2, …

Throws:

java.lang.IllegalArgumentException - if an invalid number of parameters is given (i.e. the number of parameters is odd)

MediaType

public MediaType(java.lang.String type,
                 java.lang.String subtype,
                 java.util.Map<java.lang.String,java.lang.String> parameters)

Creates a new media type.

Parameters:

type - The top-level type

subtype - The subtype

parameters - The parameters of the media type

Method Detail

getType

public java.lang.String getType()

Returns the top-level type of this media type.

Returns:

The top-level type

setType

public MediaType setType(java.lang.String type)

Creates a new media type that has the same subtype and parameters as this media type and the given type as top-level type.

Parameters:

type - The top-level type of the new media type

Returns:

The new media type

getSubtype

public java.lang.String getSubtype()

Returns the subtype of this media type.

Returns:

The subtype

setSubtype

public MediaType setSubtype(java.lang.String subtype)

Creates a new media type that has the same top-level type and parameters as this media type and the given subtype as subtype.

Parameters:

subtype - The subtype of the new media type

Returns:

The new media type

getParameter

public java.lang.String getParameter(java.lang.String name)

Returns the value of the parameter with the given name.

Parameters:

name - The name of the parameter

Returns:

The value of the parameter (or null if the media type does not have a parameter with the given name)

setParameter

public MediaType setParameter(java.lang.String name,
                              java.lang.String value)

Creates a new media type that has the same top-level type, subtype, and parameters as this media type but has the parameter with the given name changed to the given value.

Parameters:

name - The name of the parameter to change

value - The new value of the parameter. Null = delete parameter.

Returns:

The new media type

removeParameter

public MediaType removeParameter(java.lang.String name)

Creates a new media type that has the same top-level type, subtype, and parameters as this media type but has the parameter with the given name removed.

Parameters:

name - The name of the parameter to remove

Returns:

The new media type

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getCharsetRobust

public static java.lang.String getCharsetRobust(java.lang.String expectedMimeType)

getCharsetRobustOrUTF

public static java.lang.String getCharsetRobustOrUTF(java.lang.String expectedMimeType)

getParameters

public java.util.LinkedHashMap<java.lang.String,java.lang.String> getParameters()

getPlainType

public java.lang.String getPlainType()

Get the base type without any parameters