depends.org.apache.http.message

类 BasicHeaderValueFormatter

java.lang.Object

depends.org.apache.http.message.BasicHeaderValueFormatter

所有已实现的接口:

HeaderValueFormatter

@Immutable
public class BasicHeaderValueFormatter
extends java.lang.Object
implements HeaderValueFormatter

Basic implementation for formatting header value elements. Instances of this class are stateless and thread-safe. Derived classes are expected to maintain these properties.

从以下版本开始:

4.0

字段概要

字段

限定符和类型	字段和说明
static BasicHeaderValueFormatter	DEFAULT 已过时。 (4.3) use INSTANCE
static BasicHeaderValueFormatter	INSTANCE
static java.lang.String	SEPARATORS Special characters that can be used as separators in HTTP parameters.
static java.lang.String	UNSAFE_CHARS Unsafe special characters that must be escaped using the backslash character

构造器概要

构造器

构造器和说明
BasicHeaderValueFormatter()

方法概要

方法

限定符和类型	方法和说明
protected void	doFormatValue(CharArrayBuffer buffer, java.lang.String value, boolean quote) Actually formats the value of a name-value pair.
protected int	estimateElementsLen(HeaderElement[] elems) Estimates the length of formatted header elements.
protected int	estimateHeaderElementLen(HeaderElement elem) Estimates the length of a formatted header element.
protected int	estimateNameValuePairLen(NameValuePair nvp) Estimates the length of a formatted name-value pair.
protected int	estimateParametersLen(NameValuePair[] nvps) Estimates the length of formatted parameters.
CharArrayBuffer	formatElements(CharArrayBuffer charBuffer, HeaderElement[] elems, boolean quote) Formats an array of header elements.
static java.lang.String	formatElements(HeaderElement[] elems, boolean quote, HeaderValueFormatter formatter) Formats an array of header elements.
CharArrayBuffer	formatHeaderElement(CharArrayBuffer charBuffer, HeaderElement elem, boolean quote) Formats one header element.
static java.lang.String	formatHeaderElement(HeaderElement elem, boolean quote, HeaderValueFormatter formatter) Formats a header element.
CharArrayBuffer	formatNameValuePair(CharArrayBuffer charBuffer, NameValuePair nvp, boolean quote) Formats one name-value pair, where the value is optional.
static java.lang.String	formatNameValuePair(NameValuePair nvp, boolean quote, HeaderValueFormatter formatter) Formats a name-value pair.
CharArrayBuffer	formatParameters(CharArrayBuffer charBuffer, NameValuePair[] nvps, boolean quote) Formats the parameters of a header element.
static java.lang.String	formatParameters(NameValuePair[] nvps, boolean quote, HeaderValueFormatter formatter) Formats a set of parameters.
protected boolean	isSeparator(char ch) Checks whether a character is a separator.
protected boolean	isUnsafe(char ch) Checks whether a character is unsafe.

从类继承的方法 java.lang.Object

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

字段详细资料

DEFAULT

@Deprecated
public static final BasicHeaderValueFormatter DEFAULT

已过时。 (4.3) use INSTANCE

A default instance of this class, for use as default or fallback. Note that BasicHeaderValueFormatter is not a singleton, there can be many instances of the class itself and of derived classes. The instance here provides non-customized, default behavior.

INSTANCE

public static final BasicHeaderValueFormatter INSTANCE

SEPARATORS

public static final java.lang.String SEPARATORS

Special characters that can be used as separators in HTTP parameters. These special characters MUST be in a quoted string to be used within a parameter value .

另请参阅:

常量字段值

UNSAFE_CHARS

public static final java.lang.String UNSAFE_CHARS

Unsafe special characters that must be escaped using the backslash character

另请参阅:

常量字段值

构造器详细资料

BasicHeaderValueFormatter

public BasicHeaderValueFormatter()

方法详细资料

formatElements

public static java.lang.String formatElements(HeaderElement[] elems,
                              boolean quote,
                              HeaderValueFormatter formatter)

Formats an array of header elements.

参数:

elems - the header elements to format

quote - true to always format with quoted values, false to use quotes only when necessary

formatter - the formatter to use, or null for the default

返回:

the formatted header elements

formatElements

public CharArrayBuffer formatElements(CharArrayBuffer charBuffer,
                             HeaderElement[] elems,
                             boolean quote)

从接口复制的说明: HeaderValueFormatter

Formats an array of header elements.

指定者:

formatElements 在接口中 HeaderValueFormatter

参数:

charBuffer - the buffer to append to, or null to create a new buffer

elems - the header elements to format

quote - true to always format with quoted values, false to use quotes only when necessary

返回:

a buffer with the formatted header elements. If the buffer argument was not null, that buffer will be used and returned.

estimateElementsLen

protected int estimateElementsLen(HeaderElement[] elems)

Estimates the length of formatted header elements.

参数:

elems - the header elements to format, or null

返回:

a length estimate, in number of characters

formatHeaderElement

public static java.lang.String formatHeaderElement(HeaderElement elem,
                                   boolean quote,
                                   HeaderValueFormatter formatter)

Formats a header element.

参数:

elem - the header element to format

quote - true to always format with quoted values, false to use quotes only when necessary

formatter - the formatter to use, or null for the default

返回:

the formatted header element

formatHeaderElement

public CharArrayBuffer formatHeaderElement(CharArrayBuffer charBuffer,
                                  HeaderElement elem,
                                  boolean quote)

从接口复制的说明: HeaderValueFormatter

Formats one header element.

指定者:

formatHeaderElement 在接口中 HeaderValueFormatter

参数:

charBuffer - the buffer to append to, or null to create a new buffer

elem - the header element to format

quote - true to always format with quoted values, false to use quotes only when necessary

返回:

a buffer with the formatted header element. If the buffer argument was not null, that buffer will be used and returned.

estimateHeaderElementLen

protected int estimateHeaderElementLen(HeaderElement elem)

Estimates the length of a formatted header element.

参数:

elem - the header element to format, or null

返回:

a length estimate, in number of characters

formatParameters

public static java.lang.String formatParameters(NameValuePair[] nvps,
                                boolean quote,
                                HeaderValueFormatter formatter)

Formats a set of parameters.

参数:

nvps - the parameters to format

quote - true to always format with quoted values, false to use quotes only when necessary

formatter - the formatter to use, or null for the default

返回:

the formatted parameters

formatParameters

public CharArrayBuffer formatParameters(CharArrayBuffer charBuffer,
                               NameValuePair[] nvps,
                               boolean quote)

从接口复制的说明: HeaderValueFormatter

Formats the parameters of a header element. That's a list of name-value pairs, to be separated by semicolons. This method will not generate a leading semicolon.

指定者:

formatParameters 在接口中 HeaderValueFormatter

参数:

charBuffer - the buffer to append to, or null to create a new buffer

nvps - the parameters (name-value pairs) to format

quote - true to always format with quoted values, false to use quotes only when necessary

返回:

a buffer with the formatted parameters. If the buffer argument was not null, that buffer will be used and returned.

estimateParametersLen

protected int estimateParametersLen(NameValuePair[] nvps)

Estimates the length of formatted parameters.

参数:

nvps - the parameters to format, or null

返回:

a length estimate, in number of characters

formatNameValuePair

public static java.lang.String formatNameValuePair(NameValuePair nvp,
                                   boolean quote,
                                   HeaderValueFormatter formatter)

Formats a name-value pair.

参数:

nvp - the name-value pair to format

quote - true to always format with a quoted value, false to use quotes only when necessary

formatter - the formatter to use, or null for the default

返回:

the formatted name-value pair

formatNameValuePair

public CharArrayBuffer formatNameValuePair(CharArrayBuffer charBuffer,
                                  NameValuePair nvp,
                                  boolean quote)

从接口复制的说明: HeaderValueFormatter

Formats one name-value pair, where the value is optional.

指定者:

formatNameValuePair 在接口中 HeaderValueFormatter

参数:

charBuffer - the buffer to append to, or null to create a new buffer

nvp - the name-value pair to format

quote - true to always format with a quoted value, false to use quotes only when necessary

返回:

a buffer with the formatted name-value pair. If the buffer argument was not null, that buffer will be used and returned.

estimateNameValuePairLen

protected int estimateNameValuePairLen(NameValuePair nvp)

Estimates the length of a formatted name-value pair.

参数:

nvp - the name-value pair to format, or null

返回:

a length estimate, in number of characters

doFormatValue

protected void doFormatValue(CharArrayBuffer buffer,
                 java.lang.String value,
                 boolean quote)

Actually formats the value of a name-value pair. This does not include a leading = character. Called from formatNameValuePair.

参数:

buffer - the buffer to append to, never null

value - the value to append, never null

quote - true to always format with quotes, false to use quotes only when necessary

isSeparator

protected boolean isSeparator(char ch)

Checks whether a character is a separator.

参数:

ch - the character to check

返回:

true if the character is a separator, false otherwise

isUnsafe

protected boolean isUnsafe(char ch)

Checks whether a character is unsafe.

参数:

ch - the character to check

返回:

true if the character is unsafe, false otherwise