bayou.mime

Class ContentType

java.lang.Object

bayou.mime.ContentType

public class ContentType
extends Object

Content-Type of MIME body.

A ContentType contains type, subtype, and parameters. The type, subtype, and parameter names are all converted to lower case.

The Content-Type header is originally defined in RFC2045. This implementation follows RFC2616 §14.17 Content-Type.

This class is immutable.

Field Summary

Fields

Modifier and Type	Field and Description
static ContentType	text_plain ContentType of "text/plain".
static ContentType	text_plain_US_ASCII ContentType of "text/plain;charset=US-ASCII".
static ContentType	text_plain_ISO88591 ContentType of "text/plain;charset=ISO-8859-1".
static ContentType	text_plain_UTF_8 ContentType of "text/plain;charset=UTF-8".
static ContentType	text_html_UTF_8 ContentType of "text/html;charset=UTF-8".
static ContentType	application_octet_stream ContentType of ""application/octet-stream"".
static ContentType	json ContentType of "application/json".
static ContentType	json_UTF_8 ContentType of "application/json;charset=UTF-8".

Constructor Summary

Constructors

Constructor and Description
ContentType(String type, String subtype) Create a ContentType, with no parameters.
ContentType(String type, String subtype, String parameterName, String parameterValue) Create a ContentType, with a single parameter.
ContentType(String type, String subtype, Map<String,String> parameters) Create a ContentType.

Method Summary

Instance Methods
String	type() The type, in lower case.
String	subtype() The subtype, in lower case.
String	types() The type and subtype, joined by "/".
Map<String,String>	params() The parameters as a Map.
String	param(String name) Get the value of the parameter with the name.
String	toString() The string form of this ContentType, for example, "text/html;charset=UTF-8".
Static Method
ContentType	parse(String contentTypeString) Parse a string into a ContentType.

Methods inherited from class java.lang.Object

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

Field Detail

text_plain

public static final ContentType text_plain

ContentType of "text/plain".

text_plain_US_ASCII

public static final ContentType text_plain_US_ASCII

ContentType of "text/plain;charset=US-ASCII".

text_plain_ISO88591

public static final ContentType text_plain_ISO88591

ContentType of "text/plain;charset=ISO-8859-1".

text_plain_UTF_8

public static final ContentType text_plain_UTF_8

ContentType of "text/plain;charset=UTF-8".

text_html_UTF_8

public static final ContentType text_html_UTF_8

ContentType of "text/html;charset=UTF-8".

application_octet_stream

public static final ContentType application_octet_stream

ContentType of ""application/octet-stream"".

json

public static final ContentType json

ContentType of "application/json".

json_UTF_8

public static final ContentType json_UTF_8

ContentType of "application/json;charset=UTF-8".

Constructor Detail

ContentType

public ContentType(String type,
                   String subtype)

Create a ContentType, with no parameters.

ContentType

public ContentType(String type,
                   String subtype,
                   String parameterName,
                   String parameterValue)

Create a ContentType, with a single parameter.

ContentType

public ContentType(String type,
                   String subtype,
                   Map<String,String> parameters)

Create a ContentType.

Method Detail

type

public String type()

The type, in lower case.

CAUTION: This does not include the subtype. For both type and subtype, see types().

subtype

public String subtype()

The subtype, in lower case.

types

public String types()

The type and subtype, joined by "/". Example return value: "text/plain". Always in lower case.

params

public Map<String,String> params()

The parameters as a Map.

The returned Map is immutable with only lower-case keys.

param

public String param(String name)

Get the value of the parameter with the name.

The name should be in lower-case.

toString

public String toString()

The string form of this ContentType, for example, "text/html;charset=UTF-8".

Overrides:

toString in class Object

parse

public static ContentType parse(String contentTypeString)
                         throws IllegalArgumentException

Parse a string into a ContentType.

Example input string: "application/x-www-form-urlencoded"

Throws:

IllegalArgumentException - if the input string is not a valid Content-Type value.