HttpHeaders (Netty 3.10.5.Final API文档 - 即时通讯网(52im.net))

java.lang.Object
- org.jboss.netty.handler.codec.http.HttpHeaders

所有已实现的接口:

java.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>>

直接已知子类:

DefaultHttpHeaders
```
public abstract class HttpHeaders
extends java.lang.Object
implements java.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>>
```
Provides the constants for the standard HTTP header names and values and commonly used utility methods that accesses an HttpMessage.

嵌套类概要

嵌套类
限定符和类型类和说明

static class HttpHeaders.Names
Standard HTTP header names.

static class HttpHeaders.Values
Standard HTTP header values.

嵌套类
限定符和类型	类和说明
`static class`	`HttpHeaders.Names` Standard HTTP header names.
`static class`	`HttpHeaders.Values` Standard HTTP header values.

字段概要

字段
限定符和类型字段和说明

static HttpHeaders EMPTY_HEADERS

字段
限定符和类型	字段和说明
`static HttpHeaders`	`EMPTY_HEADERS`

构造器概要

构造器
限定符构造器和说明

protected HttpHeaders()

构造器
限定符	构造器和说明
`protected`	`HttpHeaders()`

方法概要

方法
限定符和类型	方法和说明
`HttpHeaders`	`add(HttpHeaders headers)` Adds all header entries of the specified `headers`.
`abstract HttpHeaders`	`add(java.lang.String name, java.lang.Iterable<?> values)` Adds a new header with the specified name and values.
`abstract HttpHeaders`	`add(java.lang.String name, java.lang.Object value)` Adds a new header with the specified name and value.
`static void`	`addDateHeader(HttpMessage message, java.lang.String name, java.util.Date value)` Adds a new date header with the specified name and value.
`static void`	`addHeader(HttpMessage message, java.lang.String name, java.lang.Object value)` Adds a new header with the specified name and value.
`static void`	`addIntHeader(HttpMessage message, java.lang.String name, int value)` Adds a new integer header with the specified name and value.
`abstract HttpHeaders`	`clear()` Removes all headers from this `HttpMessage`.
`static void`	`clearHeaders(HttpMessage message)` Removes all headers from the specified message.
`abstract boolean`	`contains(java.lang.String name)` Checks to see if there is a header with the specified name
`boolean`	`contains(java.lang.String name, java.lang.String value, boolean ignoreCaseValue)` Returns `true` if a header with the name and value exists.
`abstract java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>>`	`entries()` Returns a new `List` that contains all headers in this object.
`abstract java.lang.String`	`get(java.lang.String name)` Returns the value of a header with the specified name.
`abstract java.util.List<java.lang.String>`	`getAll(java.lang.String name)` Returns the values of headers with the specified name
`static long`	`getContentLength(HttpMessage message)` Returns the length of the content.
`static long`	`getContentLength(HttpMessage message, long defaultValue)` Returns the length of the content.
`static java.util.Date`	`getDate(HttpMessage message)` Returns the value of the `"Date"` header.
`static java.util.Date`	`getDate(HttpMessage message, java.util.Date defaultValue)` Returns the value of the `"Date"` header.
`static java.util.Date`	`getDateHeader(HttpMessage message, java.lang.String name)` Returns the date header value with the specified header name.
`static java.util.Date`	`getDateHeader(HttpMessage message, java.lang.String name, java.util.Date defaultValue)` Returns the date header value with the specified header name.
`static java.lang.String`	`getHeader(HttpMessage message, java.lang.String name)` Returns the header value with the specified header name.
`static java.lang.String`	`getHeader(HttpMessage message, java.lang.String name, java.lang.String defaultValue)` Returns the header value with the specified header name.
`static java.lang.String`	`getHost(HttpMessage message)` Returns the value of the `"Host"` header.
`static java.lang.String`	`getHost(HttpMessage message, java.lang.String defaultValue)` Returns the value of the `"Host"` header.
`static int`	`getIntHeader(HttpMessage message, java.lang.String name)` Returns the integer header value with the specified header name.
`static int`	`getIntHeader(HttpMessage message, java.lang.String name, int defaultValue)` Returns the integer header value with the specified header name.
`static boolean`	`is100ContinueExpected(HttpMessage message)` Returns `true` if and only if the specified message contains the `"Expect: 100-continue"` header.
`static boolean`	`isContentLengthSet(HttpMessage m)`
`abstract boolean`	`isEmpty()` Checks if no header exists.
`static boolean`	`isKeepAlive(HttpMessage message)` Returns `true` if and only if the connection can remain open and thus 'kept alive'.
`static boolean`	`isTransferEncodingChunked(HttpMessage message)` Checks to see if the transfer encoding in a specified `HttpMessage` is chunked
`abstract java.util.Set<java.lang.String>`	`names()` Returns a new `Set` that contains the names of all headers in this object.
`abstract HttpHeaders`	`remove(java.lang.String name)` Removes the header with the specified name.
`static void`	`removeHeader(HttpMessage message, java.lang.String name)` Removes the header with the specified name.
`static void`	`removeTransferEncodingChunked(HttpMessage m)`
`HttpHeaders`	`set(HttpHeaders headers)` Cleans the current header entries and copies all header entries of the specified `headers`.
`abstract HttpHeaders`	`set(java.lang.String name, java.lang.Iterable<?> values)` Sets a header with the specified name and values.
`abstract HttpHeaders`	`set(java.lang.String name, java.lang.Object value)` Sets a header with the specified name and value.
`static void`	`set100ContinueExpected(HttpMessage message)` Sets the `"Expect: 100-continue"` header to the specified message.
`static void`	`set100ContinueExpected(HttpMessage message, boolean set)` Sets or removes the `"Expect: 100-continue"` header to / from the specified message.
`static void`	`setContentLength(HttpMessage message, long length)` Sets the `"Content-Length"` header.
`static void`	`setDate(HttpMessage message, java.util.Date value)` Sets the `"Date"` header.
`static void`	`setDateHeader(HttpMessage message, java.lang.String name, java.util.Date value)` Sets a new date header with the specified name and value.
`static void`	`setDateHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<java.util.Date> values)` Sets a new date header with the specified name and values.
`static void`	`setHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<?> values)` Sets a new header with the specified name and values.
`static void`	`setHeader(HttpMessage message, java.lang.String name, java.lang.Object value)` Sets a new header with the specified name and value.
`static void`	`setHost(HttpMessage message, java.lang.String value)` Sets the `"Host"` header.
`static void`	`setIntHeader(HttpMessage message, java.lang.String name, int value)` Sets a new integer header with the specified name and value.
`static void`	`setIntHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<java.lang.Integer> values)` Sets a new integer header with the specified name and values.
`static void`	`setKeepAlive(HttpMessage message, boolean keepAlive)` Sets the value of the `"Connection"` header depending on the protocol version of the specified message.
`static void`	`setTransferEncodingChunked(HttpMessage m)`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 java.lang.Iterable
iterator

- 字段详细资料
  - EMPTY_HEADERS
```
public static final HttpHeaders EMPTY_HEADERS
```
- 构造器详细资料
  - HttpHeaders
```
protected HttpHeaders()
```
- 方法详细资料
  - isKeepAlive
```
public static boolean isKeepAlive(HttpMessage message)
```
    Returns true if and only if the connection can remain open and thus 'kept alive'. This methods respects the value of the "Connection" header first and then the return value of HttpVersion.isKeepAliveDefault().
  - setKeepAlive
```
public static void setKeepAlive(HttpMessage message,
                boolean keepAlive)
```
    Sets the value of the "Connection" header depending on the protocol version of the specified message. This method sets or removes the "Connection" header depending on what the default keep alive mode of the message's protocol version is, as specified by HttpVersion.isKeepAliveDefault().
    - If the connection is kept alive by default:
      
      set to "close" if keepAlive is false.
      
      remove otherwise.
    - If the connection is closed by default:
      
      set to "keep-alive" if keepAlive is true.
      
      remove otherwise.
  - getHeader
```
public static java.lang.String getHeader(HttpMessage message,
                         java.lang.String name)
```
    Returns the header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.
    
    返回:
    the header value or null if there is no such header
  - getHeader
```
public static java.lang.String getHeader(HttpMessage message,
                         java.lang.String name,
                         java.lang.String defaultValue)
```
    Returns the header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.
    
    返回:
    the header value or the defaultValue if there is no such header
  - setHeader
```
public static void setHeader(HttpMessage message,
             java.lang.String name,
             java.lang.Object value)
```
    Sets a new header with the specified name and value. If there is an existing header with the same name, the existing header is removed. If the specified value is not a String, it is converted into a String by Object.toString(), except for Date and Calendar which are formatted to the date format defined in RFC2616.
  - setHeader
```
public static void setHeader(HttpMessage message,
             java.lang.String name,
             java.lang.Iterable<?> values)
```
    Sets a new header with the specified name and values. If there is an existing header with the same name, the existing header is removed. This getMethod can be represented approximately as the following code:
```
 removeHeader(message, name);
 for (Object v: values) {
     if (v == null) {
         break;
     }
     addHeader(message, name, v);
 }
 
```
  - addHeader
```
public static void addHeader(HttpMessage message,
             java.lang.String name,
             java.lang.Object value)
```
    Adds a new header with the specified name and value. If the specified value is not a String, it is converted into a String by Object.toString(), except for Date and Calendar which are formatted to the date format defined in RFC2616.
  - removeHeader
```
public static void removeHeader(HttpMessage message,
                java.lang.String name)
```
    Removes the header with the specified name.
  - clearHeaders
```
public static void clearHeaders(HttpMessage message)
```
    Removes all headers from the specified message.
  - getIntHeader
```
public static int getIntHeader(HttpMessage message,
               java.lang.String name)
```
    Returns the integer header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.
    
    返回:
    the header value
    
    抛出:
    
    java.lang.NumberFormatException - if there is no such header or the header value is not a number
  - getIntHeader
```
public static int getIntHeader(HttpMessage message,
               java.lang.String name,
               int defaultValue)
```
    Returns the integer header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.
    
    返回:
    the header value or the defaultValue if there is no such header or the header value is not a number
  - setIntHeader
```
public static void setIntHeader(HttpMessage message,
                java.lang.String name,
                int value)
```
    Sets a new integer header with the specified name and value. If there is an existing header with the same name, the existing header is removed.
  - setIntHeader
```
public static void setIntHeader(HttpMessage message,
                java.lang.String name,
                java.lang.Iterable<java.lang.Integer> values)
```
    Sets a new integer header with the specified name and values. If there is an existing header with the same name, the existing header is removed.
  - addIntHeader
```
public static void addIntHeader(HttpMessage message,
                java.lang.String name,
                int value)
```
    Adds a new integer header with the specified name and value.
  - getDateHeader
```
public static java.util.Date getDateHeader(HttpMessage message,
                           java.lang.String name)
                                    throws java.text.ParseException
```
    Returns the date header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.
    
    返回:
    the header value
    
    抛出:
    
    java.text.ParseException - if there is no such header or the header value is not a formatted date
  - getDateHeader
```
public static java.util.Date getDateHeader(HttpMessage message,
                           java.lang.String name,
                           java.util.Date defaultValue)
```
    Returns the date header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.
    
    返回:
    the header value or the defaultValue if there is no such header or the header value is not a formatted date
  - setDateHeader
```
public static void setDateHeader(HttpMessage message,
                 java.lang.String name,
                 java.util.Date value)
```
    Sets a new date header with the specified name and value. If there is an existing header with the same name, the existing header is removed. The specified value is formatted as defined in RFC2616
  - setDateHeader
```
public static void setDateHeader(HttpMessage message,
                 java.lang.String name,
                 java.lang.Iterable<java.util.Date> values)
```
    Sets a new date header with the specified name and values. If there is an existing header with the same name, the existing header is removed. The specified values are formatted as defined in RFC2616
  - addDateHeader
```
public static void addDateHeader(HttpMessage message,
                 java.lang.String name,
                 java.util.Date value)
```
    Adds a new date header with the specified name and value. The specified value is formatted as defined in RFC2616
  - getContentLength
```
public static long getContentLength(HttpMessage message)
```
    Returns the length of the content. Please note that this value is not retrieved from HttpMessage.getContent() but from the "Content-Length" header, and thus they are independent from each other.
    
    返回:
    the content length
    
    抛出:
    
    java.lang.NumberFormatException - if the message does not have the "Content-Length" header or its value is not a number
  - getContentLength
```
public static long getContentLength(HttpMessage message,
                    long defaultValue)
```
    Returns the length of the content. Please note that this value is not retrieved from HttpMessage.getContent() but from the "Content-Length" header, and thus they are independent from each other.
    
    返回:
    the content length or defaultValue if this message does not have the "Content-Length" header or its value is not a number
  - setContentLength
```
public static void setContentLength(HttpMessage message,
                    long length)
```
    Sets the "Content-Length" header.
  - getHost
```
public static java.lang.String getHost(HttpMessage message)
```
    Returns the value of the "Host" header.
  - getHost
```
public static java.lang.String getHost(HttpMessage message,
                       java.lang.String defaultValue)
```
    Returns the value of the "Host" header. If there is no such header, the defaultValue is returned.
  - setHost
```
public static void setHost(HttpMessage message,
           java.lang.String value)
```
    Sets the "Host" header.
  - getDate
```
public static java.util.Date getDate(HttpMessage message)
                              throws java.text.ParseException
```
    Returns the value of the "Date" header.
    
    抛出:
    
    java.text.ParseException - if there is no such header or the header value is not a formatted date
  - getDate
```
public static java.util.Date getDate(HttpMessage message,
                     java.util.Date defaultValue)
```
    Returns the value of the "Date" header. If there is no such header or the header is not a formatted date, the defaultValue is returned.
  - setDate
```
public static void setDate(HttpMessage message,
           java.util.Date value)
```
    Sets the "Date" header.
  - is100ContinueExpected
```
public static boolean is100ContinueExpected(HttpMessage message)
```
    Returns true if and only if the specified message contains the "Expect: 100-continue" header.
  - set100ContinueExpected
```
public static void set100ContinueExpected(HttpMessage message)
```
    Sets the "Expect: 100-continue" header to the specified message. If there is any existing "Expect" header, they are replaced with the new one.
  - set100ContinueExpected
```
public static void set100ContinueExpected(HttpMessage message,
                          boolean set)
```
    Sets or removes the "Expect: 100-continue" header to / from the specified message. If the specified value is true, the "Expect: 100-continue" header is set and all other previous "Expect" headers are removed. Otherwise, all "Expect" headers are removed completely.
  - isTransferEncodingChunked
```
public static boolean isTransferEncodingChunked(HttpMessage message)
```
    Checks to see if the transfer encoding in a specified HttpMessage is chunked
    
    参数:
    message - The message to check
    
    返回:
    True if transfer encoding is chunked, otherwise false
  - removeTransferEncodingChunked
```
public static void removeTransferEncodingChunked(HttpMessage m)
```
  - setTransferEncodingChunked
```
public static void setTransferEncodingChunked(HttpMessage m)
```
  - isContentLengthSet
```
public static boolean isContentLengthSet(HttpMessage m)
```
  - get
```
public abstract java.lang.String get(java.lang.String name)
```
    Returns the value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.
    
    参数:
    name - The name of the header to search
    
    返回:
    The first header value or null if there is no such header
  - getAll
```
public abstract java.util.List<java.lang.String> getAll(java.lang.String name)
```
    Returns the values of headers with the specified name
    
    参数:
    name - The name of the headers to search
    
    返回:
    A List of header values which will be empty if no values are found
  - entries
```
public abstract java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> entries()
```
    Returns a new List that contains all headers in this object. Note that modifying the returned List will not affect the state of this object. If you intend to enumerate over the header entries only, use Iterable.iterator() instead, which has much less overhead.
  - contains
```
public abstract boolean contains(java.lang.String name)
```
    Checks to see if there is a header with the specified name
    
    参数:
    name - The name of the header to search for
    
    返回:
    True if at least one header is found
  - isEmpty
```
public abstract boolean isEmpty()
```
    Checks if no header exists.
  - names
```
public abstract java.util.Set<java.lang.String> names()
```
    Returns a new Set that contains the names of all headers in this object. Note that modifying the returned Set will not affect the state of this object. If you intend to enumerate over the header entries only, use Iterable.iterator() instead, which has much less overhead.
  - add
```
public abstract HttpHeaders add(java.lang.String name,
              java.lang.Object value)
```
    Adds a new header with the specified name and value. If the specified value is not a String, it is converted into a String by Object.toString(), except in the cases of Date and Calendar, which are formatted to the date format defined in RFC2616.
    
    参数:
    name - The name of the header being added
    value - The value of the header being added
    
    返回:
    this
  - add
```
public abstract HttpHeaders add(java.lang.String name,
              java.lang.Iterable<?> values)
```
    Adds a new header with the specified name and values. This getMethod can be represented approximately as the following code:
```
 for (Object v: values) {
     if (v == null) {
         break;
     }
     headers.add(name, v);
 }
 
```
    参数:
    name - The name of the headers being set
    values - The values of the headers being set
    
    返回:
    this
  - add
```
public HttpHeaders add(HttpHeaders headers)
```
    Adds all header entries of the specified headers.
    
    返回:
    this
  - set
```
public abstract HttpHeaders set(java.lang.String name,
              java.lang.Object value)
```
    Sets a header with the specified name and value. If there is an existing header with the same name, it is removed. If the specified value is not a String, it is converted into a String by Object.toString(), except for Date and Calendar, which are formatted to the date format defined in RFC2616.
    
    参数:
    name - The name of the header being set
    value - The value of the header being set
    
    返回:
    this
  - set
```
public abstract HttpHeaders set(java.lang.String name,
              java.lang.Iterable<?> values)
```
    Sets a header with the specified name and values. If there is an existing header with the same name, it is removed. This getMethod can be represented approximately as the following code:
```
 headers.remove(name);
 for (Object v: values) {
     if (v == null) {
         break;
     }
     headers.add(name, v);
 }
 
```
    参数:
    name - The name of the headers being set
    values - The values of the headers being set
    
    返回:
    this
  - set
```
public HttpHeaders set(HttpHeaders headers)
```
    Cleans the current header entries and copies all header entries of the specified headers.
    
    返回:
    this
  - remove
```
public abstract HttpHeaders remove(java.lang.String name)
```
    Removes the header with the specified name.
    
    参数:
    name - The name of the header to remove
    
    返回:
    this
  - clear
```
public abstract HttpHeaders clear()
```
    Removes all headers from this HttpMessage.
    
    返回:
    this
  - contains
```
public boolean contains(java.lang.String name,
               java.lang.String value,
               boolean ignoreCaseValue)
```
    Returns true if a header with the name and value exists.
    
    参数:
    name - the headername
    value - the value
    ignoreCaseValue - true if case should be ignored
    
    返回:
    contains true if it contains it false otherwise

类 HttpHeaders

嵌套类概要

字段概要

构造器概要

方法概要

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

从接口继承的方法 java.lang.Iterable

字段详细资料

EMPTY_HEADERS

构造器详细资料

HttpHeaders

方法详细资料

isKeepAlive

setKeepAlive

getHeader

getHeader

setHeader

setHeader

addHeader

removeHeader

clearHeaders

getIntHeader

getIntHeader

setIntHeader

setIntHeader

addIntHeader

getDateHeader

getDateHeader

setDateHeader

setDateHeader

addDateHeader

getContentLength

getContentLength

setContentLength

getHost

getHost

setHost

getDate

getDate

setDate

is100ContinueExpected

set100ContinueExpected

set100ContinueExpected

isTransferEncodingChunked

removeTransferEncodingChunked

setTransferEncodingChunked

isContentLengthSet

get

getAll

entries

contains

isEmpty

names

add

add

add

set

set

set

remove

clear

contains