public class

BasicHeaderValueParser

extends Object
implements HeaderValueParser
java.lang.Object
   ↳ org.apache.http.message.BasicHeaderValueParser

Class Overview

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

Summary

Fields
public static final BasicHeaderValueParser DEFAULT A default instance of this class, for use as default or fallback.
Public Constructors
BasicHeaderValueParser()
Public Methods
final static HeaderElement[] parseElements(String value, HeaderValueParser parser)
Parses elements with the given parser.
HeaderElement[] parseElements(CharArrayBuffer buffer, ParserCursor cursor)
Parses a header value into elements.
final static HeaderElement parseHeaderElement(String value, HeaderValueParser parser)
Parses an element with the given parser.
HeaderElement parseHeaderElement(CharArrayBuffer buffer, ParserCursor cursor)
Parses a single header element.
NameValuePair parseNameValuePair(CharArrayBuffer buffer, ParserCursor cursor, char[] delimiters)
NameValuePair parseNameValuePair(CharArrayBuffer buffer, ParserCursor cursor)
Parses a name=value specification, where the = and value are optional.
final static NameValuePair parseNameValuePair(String value, HeaderValueParser parser)
Parses a name-value-pair with the given parser.
NameValuePair[] parseParameters(CharArrayBuffer buffer, ParserCursor cursor)
Parses a list of name-value pairs.
final static NameValuePair[] parseParameters(String value, HeaderValueParser parser)
Parses parameters with the given parser.
Protected Methods
HeaderElement createHeaderElement(String name, String value, NameValuePair[] params)
Creates a header element.
NameValuePair createNameValuePair(String name, String value)
Creates a name-value pair.
[Expand]
Inherited Methods
From class java.lang.Object
From interface org.apache.http.message.HeaderValueParser

Fields

public static final BasicHeaderValueParser DEFAULT

A default instance of this class, for use as default or fallback. Note that BasicHeaderValueParser 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.

Public Constructors

public BasicHeaderValueParser ()

Public Methods

public static final HeaderElement[] parseElements (String value, HeaderValueParser parser)

Parses elements with the given parser.

Parameters
value the header value to parse
parser the parser to use, or null for default
Returns
  • array holding the header elements, never null

public HeaderElement[] parseElements (CharArrayBuffer buffer, ParserCursor cursor)

Parses a header value into elements. Parse errors are indicated as RuntimeException.

Some HTTP headers (such as the set-cookie header) have values that can be decomposed into multiple elements. In order to be processed by this parser, such headers must be in the following form:

 header  = [ element ] *( "," [ element ] )
 element = name [ "=" [ value ] ] *( ";" [ param ] )
 param   = name [ "=" [ value ] ]

 name    = token
 value   = ( token | quoted-string )

 token         = 1*<any char except "=", ",", ";", <"> and
                       white space>
 quoted-string = <"> *( text | quoted-char ) <">
 text          = any char except <">
 quoted-char   = "\" char
 

Any amount of white space is allowed between any part of the header, element or param and is ignored. A missing value in any element or param will be stored as the empty String; if the "=" is also missing null will be stored instead.

Parameters
buffer buffer holding the header value to parse
cursor the parser cursor containing the current position and the bounds within the buffer for the parsing operation
Returns
  • an array holding all elements of the header value

public static final HeaderElement parseHeaderElement (String value, HeaderValueParser parser)

Parses an element with the given parser.

Parameters
value the header element to parse
parser the parser to use, or null for default
Returns
  • the parsed header element

public HeaderElement parseHeaderElement (CharArrayBuffer buffer, ParserCursor cursor)

Parses a single header element. A header element consist of a semicolon-separate list of name=value definitions.

Parameters
buffer buffer holding the element to parse
cursor the parser cursor containing the current position and the bounds within the buffer for the parsing operation
Returns
  • the parsed element

public NameValuePair parseNameValuePair (CharArrayBuffer buffer, ParserCursor cursor, char[] delimiters)

public NameValuePair parseNameValuePair (CharArrayBuffer buffer, ParserCursor cursor)

Parses a name=value specification, where the = and value are optional.

Parameters
buffer the buffer holding the name-value pair to parse
cursor the parser cursor containing the current position and the bounds within the buffer for the parsing operation
Returns
  • the name-value pair, where the value is null if no value is specified

public static final NameValuePair parseNameValuePair (String value, HeaderValueParser parser)

Parses a name-value-pair with the given parser.

Parameters
value the NVP to parse
parser the parser to use, or null for default
Returns
  • the parsed name-value pair

public NameValuePair[] parseParameters (CharArrayBuffer buffer, ParserCursor cursor)

Parses a list of name-value pairs. These lists are used to specify parameters to a header element. Parse errors are indicated as ParseException.

Parameters
buffer buffer holding the name-value list to parse
cursor the parser cursor containing the current position and the bounds within the buffer for the parsing operation
Returns
  • an array holding all items of the name-value list

public static final NameValuePair[] parseParameters (String value, HeaderValueParser parser)

Parses parameters with the given parser.

Parameters
value the parameter list to parse
parser the parser to use, or null for default
Returns
  • array holding the parameters, never null

Protected Methods

protected HeaderElement createHeaderElement (String name, String value, NameValuePair[] params)

Creates a header element. Called from parseHeaderElement(String, HeaderValueParser).

Returns
  • a header element representing the argument

protected NameValuePair createNameValuePair (String name, String value)

Creates a name-value pair. Called from parseNameValuePair(String, HeaderValueParser).

Parameters
name the name
value the value, or null
Returns
  • a name-value pair representing the arguments