ContentType (Java EE 5)

This class represents a MIME ContentType value. It provides methods to parse a ContentType string into individual components and to generate a MIME style ContentType string.

Version:

1.10, 07/05/04

Author:

John Mani

public ContentType()
无参数构造方法。

英文文档：

ContentType

public ContentType()

No-arg Constructor.

public ContentType(String primaryType, String subType, ParameterList list)
构造方法。

primaryType	基本类型
subType	en subType
list	en ParameterList

英文文档：

ContentType

public ContentType(String primaryType,
                   String subType,
                   ParameterList list)

Constructor.

Parameters:

primaryType - primary type

subType - subType

list - ParameterList

public ContentType(String s) throws ParseException
带有 Content-Type 字符串的构造方法。String 被解析为它的组成部分：primaryType、subType 和参数。如果解析失败，则抛出 ParseException。

s	Content-Type 字符串。
Throws	ParseException: 如果解析失败。

英文文档：

ContentType

public ContentType(String s)
            throws ParseException

Constructor that takes a Content-Type string. The String is parsed into its constituents: primaryType, subType and parameters. A ParseException is thrown if the parse fails.

Parameters:

s - the Content-Type string.

Throws:

ParseException - if the parse fails.

public String getPrimaryType()
返回基本类型。

return

基本类型

英文文档：

getPrimaryType

public String getPrimaryType()

Return the primary type.

Returns:

the primary type

public String getSubType()
返回 subType。

return

subType

英文文档：

getSubType

public String getSubType()

Return the subType.

Returns:

the subType

public String getBaseType()
返回 MIME 类型的字符串，不带参数。返回的值通常是 primaryType、'/' 字符和 secondaryType 连接而成的字符串。

return

类型

英文文档：

getBaseType

public String getBaseType()

Return the MIME type string, without the parameters. The returned value is basically the concatenation of the primaryType, the '/' character and the secondaryType.

Returns:

the type

public String getParameter(String name)
返回指定的参数值。如果此参数不存在，则返回 null。

return

参数值

英文文档：

getParameter

public String getParameter(String name)

Return the specified parameter value. Returns null if this parameter is absent.

Returns:

parameter value

public ParameterList getParameterList()
返回保存所有可用参数的 ParameterList 对象。如果没有任何参数可用，则返回 null。

return

en ParameterList

英文文档：

getParameterList

public ParameterList getParameterList()

Return a ParameterList object that holds all the available parameters. Returns null if no parameters are available.

Returns:

ParameterList

public void setPrimaryType(String primaryType)
设置基本类型。重写现有的基本类型。

primaryType

基本类型

英文文档：

setPrimaryType

public void setPrimaryType(String primaryType)

Set the primary type. Overrides existing primary type.

Parameters:

primaryType - primary type

public void setSubType(String subType)
设置 subType。替换现有的 subType。

subType

subType

英文文档：

setSubType

public void setSubType(String subType)

Set the subType. Replaces the existing subType.

Parameters:

subType - the subType

public void setParameter(String name, String value)
设置指定的参数。如果此参数已经存在，则使用此新值替代它。

name	参数名称
value	参数值

英文文档：

setParameter

public void setParameter(String name,
                         String value)

Set the specified parameter. If this parameter already exists, it is replaced by this new value.

Parameters:

name - parameter name

value - parameter value

public void setParameterList(ParameterList list)
设置一个新的 ParameterList。

list	en ParameterList

英文文档：

setParameterList

public void setParameterList(ParameterList list)

Set a new ParameterList.

Parameters:

list - ParameterList

public String toString()
获取此 Content-Type 的 RFC2045 样式的字符串表示形式。如果转换失败，则返回 null。

return

RFC2045 样式字符串

英文文档：

toString

public String toString()

Retrieve a RFC2045 style string representation of this Content-Type. Returns null if the conversion failed.

Overrides:

toString in class Object

Returns:

RFC2045 style string

public boolean match(ContentType cType)
匹配指定的 ContentType 对象。此方法仅比较 primaryType 和 subType。忽略两个操作数的参数。

例如，当比较 ContentType 的 "text/plain" 和 "text/plain; charset=foobar" 时，此方法将返回 true。 如果任一操作数的 subType 是特殊字符 '*'，则匹配过程中将忽略 subtype。例如，当比较 ContentType 的 "text/plain" 和 "text/*" 时，此方法将返回 true。

cType

与此比较的 ContentType

英文文档：

match

public boolean match(ContentType cType)

Match with the specified ContentType object. This method compares only the primaryType and subType . The parameters of both operands are ignored.

For example, this method will return true when comparing the ContentTypes for "text/plain" and "text/plain; charset=foobar". If the subType of either operand is the special character '*', then the subtype is ignored during the match. For example, this method will return true when comparing the ContentTypes for "text/plain" and "text/*"

Parameters:

cType - ContentType to compare this against

public boolean match(String s)
匹配指定的内容类型字符串。此方法仅比较 primaryType 和 subType。忽略两个操作数的参数。

例如，当比较 ContentType 的 "text/plain" 和 "text/plain; charset=foobar" 时，此方法将返回 true。 如果任一操作数的 subType 是特殊字符 '*'，则匹配过程中将忽略 subtype。例如，当比较 ContentType 的 "text/plain" 和 "text/*" 时，此方法将返回 true。

英文文档：

match

public boolean match(String s)

Match with the specified content-type string. This method compares only the primaryType and subType . The parameters of both operands are ignored.

For example, this method will return true when comparing the ContentType for "text/plain" with "text/plain; charset=foobar". If the subType of either operand is the special character '*', then the subtype is ignored during the match. For example, this method will return true when comparing the ContentType for "text/plain" with "text/*"

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.