Headers (library API)

java.lang.Object
- com.qiniu.android.http.Headers

```
public final class Headers
extends java.lang.Object
```
The header fields of a single HTTP message. Values are uninterpreted strings; use Request and Response for interpreted headers. This class maintains the order of the header fields within the HTTP message.
This class tracks header values line-by-line. A field with multiple comma- separated values on the same line will be treated as a field with a single value by this class. It is the caller's responsibility to detect and split on commas if their field permits multiple values. This simplifies use of single-valued fields whose values routinely contain commas, such as cookies or dates.
This class trims whitespace from values. It never returns values with leading or trailing whitespace.
Instances of this class are immutable. Use Headers.Builder to create instances.

嵌套类概要

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

static class Headers.Builder

嵌套类
限定符和类型	类和说明
`static class`	`Headers.Builder`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`long`	`byteCount()` Returns the number of bytes required to encode these headers using HTTP/1.1.
`boolean`	`equals(java.lang.Object other)` Returns true if `other` is a `Headers` object with the same headers, with the same casing, in the same order.
`java.lang.String`	`get(java.lang.String name)` Returns the last value corresponding to the specified field, or null.
`java.util.Date`	`getDate(java.lang.String name)` Returns the last value corresponding to the specified field parsed as an HTTP date, or null if either the field is absent or cannot be parsed as a date.
`int`	`hashCode()`
`java.lang.String`	`name(int index)` Returns the field at `position`.
`java.util.Set<java.lang.String>`	`names()` Returns an immutable case-insensitive set of header names.
`Headers.Builder`	`newBuilder()`
`static Headers`	`of(java.util.Map<java.lang.String,java.lang.String> headers)` Returns headers for the header names and values in the `Map`.
`static Headers`	`of(java.lang.String... namesAndValues)` Returns headers for the alternating header names and values.
`int`	`size()` Returns the number of field values.
`java.util.Map<java.lang.String,java.util.List<java.lang.String>>`	`toMultimap()`
`java.lang.String`	`toString()`
`java.lang.String`	`value(int index)` Returns the value at `index`.
`java.util.List<java.lang.String>`	`values(java.lang.String name)` Returns an immutable list of the header values for `name`.

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

- 方法详细资料
  - of
```
public static Headers of(java.lang.String... namesAndValues)
```
    Returns headers for the alternating header names and values. There must be an even number of arguments, and they must alternate between header names and values.
  - of
```
public static Headers of(java.util.Map<java.lang.String,java.lang.String> headers)
```
    Returns headers for the header names and values in the Map.
  - get
```
public java.lang.String get(java.lang.String name)
```
    Returns the last value corresponding to the specified field, or null.
  - getDate
```
public java.util.Date getDate(java.lang.String name)
```
    Returns the last value corresponding to the specified field parsed as an HTTP date, or null if either the field is absent or cannot be parsed as a date.
  - size
```
public int size()
```
    Returns the number of field values.
  - name
```
public java.lang.String name(int index)
```
    Returns the field at position.
  - value
```
public java.lang.String value(int index)
```
    Returns the value at index.
  - names
```
public java.util.Set<java.lang.String> names()
```
    Returns an immutable case-insensitive set of header names.
  - values
```
public java.util.List<java.lang.String> values(java.lang.String name)
```
    Returns an immutable list of the header values for name.
  - byteCount
```
public long byteCount()
```
    Returns the number of bytes required to encode these headers using HTTP/1.1. This is also the approximate size of HTTP/2 headers before they are compressed with HPACK. This value is intended to be used as a metric: smaller headers are more efficient to encode and transmit.
  - newBuilder
```
public Headers.Builder newBuilder()
```
  - equals
```
public boolean equals(java.lang.Object other)
```
    Returns true if other is a Headers object with the same headers, with the same casing, in the same order. Note that two headers instances may be semantically equal but not equal according to this method. In particular, none of the following sets of headers are equal according to this method:
```
   

   1. Original
   Content-Type: text/html
   Content-Length: 50

   2. Different order
   Content-Length: 50
   Content-Type: text/html

   3. Different case
   content-type: text/html
   content-length: 50

   4. Different values
   Content-Type: text/html
   Content-Length: 050
 
```
    Applications that require semantically equal headers should convert them into a canonical form before comparing them for equality.
    覆盖:
    
    equals 在类中 java.lang.Object
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类中 java.lang.Object
  - toString
```
public java.lang.String toString()
```
    覆盖:
    
    toString 在类中 java.lang.Object
  - toMultimap
```
public java.util.Map<java.lang.String,java.util.List<java.lang.String>> toMultimap()
```

类 Headers

嵌套类概要

方法概要

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

方法详细资料

of

of

get

getDate

size

name

value

names

values

byteCount

newBuilder

equals

hashCode

toString

toMultimap