Build 1.0_r1(from source)

org.apache.http
Interface HttpMessage

All Known Subinterfaces:
HttpEntityEnclosingRequest, HttpRequest, HttpResponse, HttpUriRequest
All Known Implementing Classes:
AbstractHttpMessage, BasicHttpEntityEnclosingRequest, BasicHttpRequest, BasicHttpResponse, EntityEnclosingRequestWrapper, HttpDelete, HttpEntityEnclosingRequestBase, HttpGet, HttpHead, HttpOptions, HttpPost, HttpPut, HttpRequestBase, HttpTrace, RequestWrapper

public interface HttpMessage

A generic HTTP message. Holds what is common between requests and responses.

Since:
4.0

Method Summary
 void addHeader(Header header)
          Adds a header to this message.
 void addHeader(String name, String value)
          Adds a header to this message.
 boolean containsHeader(String name)
          Checks if a certain header is present in this message.
 Header[] getAllHeaders()
          Returns all the headers of this message.
 Header getFirstHeader(String name)
          Returns the first header with a specified name of this message.
 Header[] getHeaders(String name)
          Returns all the headers with a specified name of this message.
 Header getLastHeader(String name)
          Returns the last header with a specified name of this message.
 HttpParams getParams()
          Returns the parameters effective for this message as set by setParams(HttpParams).
 ProtocolVersion getProtocolVersion()
          Returns the protocol version this message is compatible with.
 HeaderIterator headerIterator()
          Returns an iterator of all the headers.
 HeaderIterator headerIterator(String name)
          Returns an iterator of the headers with a given name.
 void removeHeader(Header header)
          Removes a header from this message.
 void removeHeaders(String name)
          Removes all headers with a certain name from this message.
 void setHeader(Header header)
          Overwrites the first header with the same name.
 void setHeader(String name, String value)
          Overwrites the first header with the same name.
 void setHeaders(Header[] headers)
          Overwrites all the headers in the message.
 void setParams(HttpParams params)
          Provides parameters to be used for the processing of this message.
 

Method Detail

getProtocolVersion

ProtocolVersion getProtocolVersion()
Returns the protocol version this message is compatible with.


containsHeader

boolean containsHeader(String name)
Checks if a certain header is present in this message. Header values are ignored.

Parameters:
name - the header name to check for.
Returns:
true if at least one header with this name is present.

getHeaders

Header[] getHeaders(String name)
Returns all the headers with a specified name of this message. Header values are ignored. Headers are orderd in the sequence they will be sent over a connection.

Parameters:
name - the name of the headers to return.
Returns:
the headers whose name property equals name.

getFirstHeader

Header getFirstHeader(String name)
Returns the first header with a specified name of this message. Header values are ignored. If there is more than one matching header in the message the first element of getHeaders(String) is returned. If there is no matching header in the message null is returned.

Parameters:
name - the name of the header to return.
Returns:
the first header whose name property equals name or null if no such header could be found.

getLastHeader

Header getLastHeader(String name)
Returns the last header with a specified name of this message. Header values are ignored. If there is more than one matching header in the message the last element of getHeaders(String) is returned. If there is no matching header in the message null is returned.

Parameters:
name - the name of the header to return.
Returns:
the last header whose name property equals name. or null if no such header could be found.

getAllHeaders

Header[] getAllHeaders()
Returns all the headers of this message. Headers are orderd in the sequence they will be sent over a connection.

Returns:
all the headers of this message

addHeader

void addHeader(Header header)
Adds a header to this message. The header will be appended to the end of the list.

Parameters:
header - the header to append.

addHeader

void addHeader(String name,
               String value)
Adds a header to this message. The header will be appended to the end of the list.

Parameters:
name - the name of the header.
value - the value of the header.

setHeader

void setHeader(Header header)
Overwrites the first header with the same name. The new header will be appended to the end of the list, if no header with the given name can be found.

Parameters:
header - the header to set.

setHeader

void setHeader(String name,
               String value)
Overwrites the first header with the same name. The new header will be appended to the end of the list, if no header with the given name can be found.

Parameters:
name - the name of the header.
value - the value of the header.

setHeaders

void setHeaders(Header[] headers)
Overwrites all the headers in the message.

Parameters:
headers - the array of headers to set.

removeHeader

void removeHeader(Header header)
Removes a header from this message.

Parameters:
header - the header to remove.

removeHeaders

void removeHeaders(String name)
Removes all headers with a certain name from this message.

Parameters:
name - The name of the headers to remove.

headerIterator

HeaderIterator headerIterator()
Returns an iterator of all the headers.

Returns:
Iterator that returns Header objects in the sequence they are sent over a connection.

headerIterator

HeaderIterator headerIterator(String name)
Returns an iterator of the headers with a given name.

Parameters:
name - the name of the headers over which to iterate, or null for all headers
Returns:
Iterator that returns Header objects with the argument name in the sequence they are sent over a connection.

getParams

HttpParams getParams()
Returns the parameters effective for this message as set by setParams(HttpParams).


setParams

void setParams(HttpParams params)
Provides parameters to be used for the processing of this message.

Parameters:
params - the parameters

Build 1.0_r1(from source)

Please submit a feedback, bug or feature