Package org.apache.http.message
Class BufferedHeader
- java.lang.Object
-
- org.apache.http.message.BufferedHeader
-
- All Implemented Interfaces:
java.io.Serializable
,java.lang.Cloneable
,FormattedHeader
,Header
,NameValuePair
public class BufferedHeader extends java.lang.Object implements FormattedHeader, java.lang.Cloneable, java.io.Serializable
This class represents a raw HTTP header whose content is parsed 'on demand' only when the header value needs to be consumed.- Since:
- 4.0
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description private CharArrayBuffer
buffer
The buffer containing the entire header line.private java.lang.String
name
Header name.private static long
serialVersionUID
private int
valuePos
The beginning of the header value in the buffer
-
Constructor Summary
Constructors Constructor Description BufferedHeader(CharArrayBuffer buffer)
Creates a new header from a buffer.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.Object
clone()
CharArrayBuffer
getBuffer()
Obtains the buffer with the formatted header.HeaderElement[]
getElements()
Parses the value.java.lang.String
getName()
Gets the name of this pair.java.lang.String
getValue()
Gets the value of this pair.int
getValuePos()
Obtains the start of the header value in thebuffer
.java.lang.String
toString()
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
name
private final java.lang.String name
Header name.
-
buffer
private final CharArrayBuffer buffer
The buffer containing the entire header line.
-
valuePos
private final int valuePos
The beginning of the header value in the buffer
-
-
Constructor Detail
-
BufferedHeader
public BufferedHeader(CharArrayBuffer buffer) throws ParseException
Creates a new header from a buffer. The name of the header will be parsed immediately, the value only if it is accessed.- Parameters:
buffer
- the buffer containing the header to represent- Throws:
ParseException
- in case of a parse error
-
-
Method Detail
-
getName
public java.lang.String getName()
Description copied from interface:NameValuePair
Gets the name of this pair.- Specified by:
getName
in interfaceNameValuePair
- Returns:
- the name of this pair, never
null
.
-
getValue
public java.lang.String getValue()
Description copied from interface:NameValuePair
Gets the value of this pair.- Specified by:
getValue
in interfaceNameValuePair
- Returns:
- the value of this pair, may be
null
.
-
getElements
public HeaderElement[] getElements() throws ParseException
Description copied from interface:Header
Parses the value.- Specified by:
getElements
in interfaceHeader
- Returns:
- an array of
HeaderElement
entries, may be empty, but is nevernull
- Throws:
ParseException
- in case of a parsing error
-
getValuePos
public int getValuePos()
Description copied from interface:FormattedHeader
Obtains the start of the header value in thebuffer
. By accessing the value in the buffer, creation of a temporary string can be avoided.- Specified by:
getValuePos
in interfaceFormattedHeader
- Returns:
- index of the first character of the header value
in the buffer returned by
getBuffer
.
-
getBuffer
public CharArrayBuffer getBuffer()
Description copied from interface:FormattedHeader
Obtains the buffer with the formatted header. The returned buffer MUST NOT be modified.- Specified by:
getBuffer
in interfaceFormattedHeader
- Returns:
- the formatted header, in a buffer that must not be modified
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
clone
public java.lang.Object clone() throws java.lang.CloneNotSupportedException
- Overrides:
clone
in classjava.lang.Object
- Throws:
java.lang.CloneNotSupportedException
-
-