HttpHeaders (Spring Framework 4.3.11.RELEASE API)

java.lang.Object
- org.springframework.http.HttpHeaders

All Implemented Interfaces:

Serializable, Map<String,List<String>>, MultiValueMap<String,String>

Direct Known Subclasses:

WebSocketHttpHeaders
```
public class HttpHeaders
extends Object
implements MultiValueMap<String,String>, Serializable
```
Represents HTTP request and response headers, mapping string header names to a list of string values.
In addition to the normal methods defined by Map, this class offers the following convenience methods:
- getFirst(String) returns the first value associated with a given header name
- add(String, String) adds a header value to the list of values for a header name
- set(String, String) sets the header value to a single string value
Inspired by com.sun.net.httpserver.Headers.
Since:

3.0

Author:

Arjen Poutsma, Sebastien Deleuze, Brian Clozel, Juergen Hoeller, Josh Long

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ACCEPT` The HTTP `Accept` header field name.
`static String`	`ACCEPT_CHARSET` The HTTP `Accept-Charset` header field name.
`static String`	`ACCEPT_ENCODING` The HTTP `Accept-Encoding` header field name.
`static String`	`ACCEPT_LANGUAGE` The HTTP `Accept-Language` header field name.
`static String`	`ACCEPT_RANGES` The HTTP `Accept-Ranges` header field name.
`static String`	`ACCESS_CONTROL_ALLOW_CREDENTIALS` The CORS `Access-Control-Allow-Credentials` response header field name.
`static String`	`ACCESS_CONTROL_ALLOW_HEADERS` The CORS `Access-Control-Allow-Headers` response header field name.
`static String`	`ACCESS_CONTROL_ALLOW_METHODS` The CORS `Access-Control-Allow-Methods` response header field name.
`static String`	`ACCESS_CONTROL_ALLOW_ORIGIN` The CORS `Access-Control-Allow-Origin` response header field name.
`static String`	`ACCESS_CONTROL_EXPOSE_HEADERS` The CORS `Access-Control-Expose-Headers` response header field name.
`static String`	`ACCESS_CONTROL_MAX_AGE` The CORS `Access-Control-Max-Age` response header field name.
`static String`	`ACCESS_CONTROL_REQUEST_HEADERS` The CORS `Access-Control-Request-Headers` request header field name.
`static String`	`ACCESS_CONTROL_REQUEST_METHOD` The CORS `Access-Control-Request-Method` request header field name.
`static String`	`AGE` The HTTP `Age` header field name.
`static String`	`ALLOW` The HTTP `Allow` header field name.
`static String`	`AUTHORIZATION` The HTTP `Authorization` header field name.
`static String`	`CACHE_CONTROL` The HTTP `Cache-Control` header field name.
`static String`	`CONNECTION` The HTTP `Connection` header field name.
`static String`	`CONTENT_DISPOSITION` The HTTP `Content-Disposition` header field name
`static String`	`CONTENT_ENCODING` The HTTP `Content-Encoding` header field name.
`static String`	`CONTENT_LANGUAGE` The HTTP `Content-Language` header field name.
`static String`	`CONTENT_LENGTH` The HTTP `Content-Length` header field name.
`static String`	`CONTENT_LOCATION` The HTTP `Content-Location` header field name.
`static String`	`CONTENT_RANGE` The HTTP `Content-Range` header field name.
`static String`	`CONTENT_TYPE` The HTTP `Content-Type` header field name.
`static String`	`COOKIE` The HTTP `Cookie` header field name.
`static String`	`DATE` The HTTP `Date` header field name.
`static String`	`ETAG` The HTTP `ETag` header field name.
`static String`	`EXPECT` The HTTP `Expect` header field name.
`static String`	`EXPIRES` The HTTP `Expires` header field name.
`static String`	`FROM` The HTTP `From` header field name.
`static String`	`HOST` The HTTP `Host` header field name.
`static String`	`IF_MATCH` The HTTP `If-Match` header field name.
`static String`	`IF_MODIFIED_SINCE` The HTTP `If-Modified-Since` header field name.
`static String`	`IF_NONE_MATCH` The HTTP `If-None-Match` header field name.
`static String`	`IF_RANGE` The HTTP `If-Range` header field name.
`static String`	`IF_UNMODIFIED_SINCE` The HTTP `If-Unmodified-Since` header field name.
`static String`	`LAST_MODIFIED` The HTTP `Last-Modified` header field name.
`static String`	`LINK` The HTTP `Link` header field name.
`static String`	`LOCATION` The HTTP `Location` header field name.
`static String`	`MAX_FORWARDS` The HTTP `Max-Forwards` header field name.
`static String`	`ORIGIN` The HTTP `Origin` header field name.
`static String`	`PRAGMA` The HTTP `Pragma` header field name.
`static String`	`PROXY_AUTHENTICATE` The HTTP `Proxy-Authenticate` header field name.
`static String`	`PROXY_AUTHORIZATION` The HTTP `Proxy-Authorization` header field name.
`static String`	`RANGE` The HTTP `Range` header field name.
`static String`	`REFERER` The HTTP `Referer` header field name.
`static String`	`RETRY_AFTER` The HTTP `Retry-After` header field name.
`static String`	`SERVER` The HTTP `Server` header field name.
`static String`	`SET_COOKIE` The HTTP `Set-Cookie` header field name.
`static String`	`SET_COOKIE2` The HTTP `Set-Cookie2` header field name.
`static String`	`TE` The HTTP `TE` header field name.
`static String`	`TRAILER` The HTTP `Trailer` header field name.
`static String`	`TRANSFER_ENCODING` The HTTP `Transfer-Encoding` header field name.
`static String`	`UPGRADE` The HTTP `Upgrade` header field name.
`static String`	`USER_AGENT` The HTTP `User-Agent` header field name.
`static String`	`VARY` The HTTP `Vary` header field name.
`static String`	`VIA` The HTTP `Via` header field name.
`static String`	`WARNING` The HTTP `Warning` header field name.
`static String`	`WWW_AUTHENTICATE` The HTTP `WWW-Authenticate` header field name.

Constructor Summary

Constructors
Constructor and Description

HttpHeaders()
Constructs a new, empty instance of the HttpHeaders object.

Constructors
Constructor and Description
`HttpHeaders()` Constructs a new, empty instance of the `HttpHeaders` object.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`add(String headerName, String headerValue)` Add the given, single header value under the given name.
`void`	`clear()`
`boolean`	`containsKey(Object key)`
`boolean`	`containsValue(Object value)`
`Set<Map.Entry<String,List<String>>>`	`entrySet()`
`boolean`	`equals(Object other)`
`List<String>`	`get(Object key)`
`List<MediaType>`	`getAccept()` Return the list of acceptable media types, as specified by the `Accept` header.
`List<Charset>`	`getAcceptCharset()` Return the list of acceptable charsets, as specified by the `Accept-Charset` header.
`boolean`	`getAccessControlAllowCredentials()` Return the value of the `Access-Control-Allow-Credentials` response header.
`List<String>`	`getAccessControlAllowHeaders()` Return the value of the `Access-Control-Allow-Headers` response header.
`List<HttpMethod>`	`getAccessControlAllowMethods()` Return the value of the `Access-Control-Allow-Methods` response header.
`String`	`getAccessControlAllowOrigin()` Return the value of the `Access-Control-Allow-Origin` response header.
`List<String>`	`getAccessControlExposeHeaders()` Return the value of the `Access-Control-Expose-Headers` response header.
`long`	`getAccessControlMaxAge()` Return the value of the `Access-Control-Max-Age` response header.
`List<String>`	`getAccessControlRequestHeaders()` Return the value of the `Access-Control-Request-Headers` request header.
`HttpMethod`	`getAccessControlRequestMethod()` Return the value of the `Access-Control-Request-Method` request header.
`Set<HttpMethod>`	`getAllow()` Return the set of allowed `HTTP methods`, as specified by the `Allow` header.
`String`	`getCacheControl()` Return the value of the `Cache-Control` header.
`List<String>`	`getConnection()` Return the value of the `Connection` header.
`long`	`getContentLength()` Return the length of the body in bytes, as specified by the `Content-Length` header.
`MediaType`	`getContentType()` Return the media type of the body, as specified by the `Content-Type` header.
`long`	`getDate()` Return the date and time at which the message was created, as specified by the `Date` header.
`String`	`getETag()` Return the entity tag of the body, as specified by the `ETag` header.
`protected List<String>`	`getETagValuesAsList(String headerName)` Retrieve a combined result from the field values of the ETag header.
`long`	`getExpires()` Return the date and time at which the message is no longer valid, as specified by the `Expires` header.
`protected String`	`getFieldValues(String headerName)` Retrieve a combined result from the field values of multi-valued headers.
`String`	`getFirst(String headerName)` Return the first header value for the given header name, if any.
`long`	`getFirstDate(String headerName)` Parse the first header value for the given header name as a date, return -1 if there is no value, or raise `IllegalArgumentException` if the value cannot be parsed as a date.
`List<String>`	`getIfMatch()` Return the value of the `If-Match` header.
`long`	`getIfModifiedSince()` Return the value of the `If-Modified-Since` header.
`List<String>`	`getIfNoneMatch()` Return the value of the `If-None-Match` header.
`long`	`getIfUnmodifiedSince()` Return the value of the `If-Unmodified-Since` header.
`long`	`getLastModified()` Return the time the resource was last changed, as specified by the `Last-Modified` header.
`URI`	`getLocation()` Return the (new) location of a resource as specified by the `Location` header.
`String`	`getOrigin()` Return the value of the `Origin` header.
`String`	`getPragma()` Return the value of the `Pragma` header.
`List<HttpRange>`	`getRange()` Return the value of the `Range` header.
`String`	`getUpgrade()` Return the value of the `Upgrade` header.
`List<String>`	`getValuesAsList(String headerName)` Return all values of a given header name, even if this header is set multiple times.
`List<String>`	`getVary()` Return the request header names subject to content negotiation.
`int`	`hashCode()`
`boolean`	`isEmpty()`
`Set<String>`	`keySet()`
`List<String>`	`put(String key, List<String> value)`
`void`	`putAll(Map<? extends String,? extends List<String>> map)`
`static HttpHeaders`	`readOnlyHttpHeaders(HttpHeaders headers)` Return a `HttpHeaders` object that can only be read, not written to.
`List<String>`	`remove(Object key)`
`void`	`set(String headerName, String headerValue)` Set the given, single header value under the given name.
`void`	`setAccept(List<MediaType> acceptableMediaTypes)` Set the list of acceptable media types, as specified by the `Accept` header.
`void`	`setAcceptCharset(List<Charset> acceptableCharsets)` Set the list of acceptable charsets, as specified by the `Accept-Charset` header.
`void`	`setAccessControlAllowCredentials(boolean allowCredentials)` Set the (new) value of the `Access-Control-Allow-Credentials` response header.
`void`	`setAccessControlAllowHeaders(List<String> allowedHeaders)` Set the (new) value of the `Access-Control-Allow-Headers` response header.
`void`	`setAccessControlAllowMethods(List<HttpMethod> allowedMethods)` Set the (new) value of the `Access-Control-Allow-Methods` response header.
`void`	`setAccessControlAllowOrigin(String allowedOrigin)` Set the (new) value of the `Access-Control-Allow-Origin` response header.
`void`	`setAccessControlExposeHeaders(List<String> exposedHeaders)` Set the (new) value of the `Access-Control-Expose-Headers` response header.
`void`	`setAccessControlMaxAge(long maxAge)` Set the (new) value of the `Access-Control-Max-Age` response header.
`void`	`setAccessControlRequestHeaders(List<String> requestHeaders)` Set the (new) value of the `Access-Control-Request-Headers` request header.
`void`	`setAccessControlRequestMethod(HttpMethod requestMethod)` Set the (new) value of the `Access-Control-Request-Method` request header.
`void`	`setAll(Map<String,String> values)` Set the given values under.
`void`	`setAllow(Set<HttpMethod> allowedMethods)` Set the set of allowed `HTTP methods`, as specified by the `Allow` header.
`void`	`setCacheControl(String cacheControl)` Set the (new) value of the `Cache-Control` header.
`void`	`setConnection(List<String> connection)` Set the (new) value of the `Connection` header.
`void`	`setConnection(String connection)` Set the (new) value of the `Connection` header.
`void`	`setContentDispositionFormData(String name, String filename)` Set the `Content-Disposition` header when creating a `"multipart/form-data"` request.
`void`	`setContentDispositionFormData(String name, String filename, Charset charset)` Deprecated. deprecated in 4.3.11 and removed from 5.0; as per RFC 7578, Section 4.2, an RFC 5987 style encoding should not be used for multipart/form-data requests. Furthermore there should be no reason for applications to set this header explicitly; for more details also read `setContentDispositionFormData(String, String)`
`void`	`setContentLength(long contentLength)` Set the length of the body in bytes, as specified by the `Content-Length` header.
`void`	`setContentType(MediaType mediaType)` Set the media type of the body, as specified by the `Content-Type` header.
`void`	`setDate(long date)` Set the date and time at which the message was created, as specified by the `Date` header.
`void`	`setDate(String headerName, long date)` Set the given date under the given header name after formatting it as a string using the pattern `"EEE, dd MMM yyyy HH:mm:ss zzz"`.
`void`	`setETag(String eTag)` Set the (new) entity tag of the body, as specified by the `ETag` header.
`void`	`setExpires(long expires)` Set the date and time at which the message is no longer valid, as specified by the `Expires` header.
`void`	`setIfMatch(List<String> ifMatchList)` Set the (new) value of the `If-Match` header.
`void`	`setIfMatch(String ifMatch)` Set the (new) value of the `If-Match` header.
`void`	`setIfModifiedSince(long ifModifiedSince)` Set the (new) value of the `If-Modified-Since` header.
`void`	`setIfNoneMatch(List<String> ifNoneMatchList)` Set the (new) values of the `If-None-Match` header.
`void`	`setIfNoneMatch(String ifNoneMatch)` Set the (new) value of the `If-None-Match` header.
`void`	`setIfUnmodifiedSince(long ifUnmodifiedSince)` Set the (new) value of the `If-Unmodified-Since` header.
`void`	`setLastModified(long lastModified)` Set the time the resource was last changed, as specified by the `Last-Modified` header.
`void`	`setLocation(URI location)` Set the (new) location of a resource, as specified by the `Location` header.
`void`	`setOrigin(String origin)` Set the (new) value of the `Origin` header.
`void`	`setPragma(String pragma)` Set the (new) value of the `Pragma` header.
`void`	`setRange(List<HttpRange> ranges)` Sets the (new) value of the `Range` header.
`void`	`setUpgrade(String upgrade)` Set the (new) value of the `Upgrade` header.
`void`	`setVary(List<String> requestHeaders)` Set the request header names (e.g.
`int`	`size()`
`protected String`	`toCommaDelimitedString(List<String> headerValues)` Turn the given list of header values into a comma-delimited result.
`Map<String,String>`	`toSingleValueMap()` Returns the first values contained in this `MultiValueMap`.
`String`	`toString()`
`Collection<List<String>>`	`values()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Field Detail
  - ACCEPT
```
public static final String ACCEPT
```
    The HTTP Accept header field name.
    
    See Also:
    
    Section 5.3.2 of RFC 7231, Constant Field Values
  - ACCEPT_CHARSET
```
public static final String ACCEPT_CHARSET
```
    The HTTP Accept-Charset header field name.
    
    See Also:
    
    Section 5.3.3 of RFC 7231, Constant Field Values
  - ACCEPT_ENCODING
```
public static final String ACCEPT_ENCODING
```
    The HTTP Accept-Encoding header field name.
    
    See Also:
    
    Section 5.3.4 of RFC 7231, Constant Field Values
  - ACCEPT_LANGUAGE
```
public static final String ACCEPT_LANGUAGE
```
    The HTTP Accept-Language header field name.
    
    See Also:
    
    Section 5.3.5 of RFC 7231, Constant Field Values
  - ACCEPT_RANGES
```
public static final String ACCEPT_RANGES
```
    The HTTP Accept-Ranges header field name.
    
    See Also:
    
    Section 5.3.5 of RFC 7233, Constant Field Values
  - ACCESS_CONTROL_ALLOW_CREDENTIALS
```
public static final String ACCESS_CONTROL_ALLOW_CREDENTIALS
```
    The CORS Access-Control-Allow-Credentials response header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_ALLOW_HEADERS
```
public static final String ACCESS_CONTROL_ALLOW_HEADERS
```
    The CORS Access-Control-Allow-Headers response header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_ALLOW_METHODS
```
public static final String ACCESS_CONTROL_ALLOW_METHODS
```
    The CORS Access-Control-Allow-Methods response header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_ALLOW_ORIGIN
```
public static final String ACCESS_CONTROL_ALLOW_ORIGIN
```
    The CORS Access-Control-Allow-Origin response header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_EXPOSE_HEADERS
```
public static final String ACCESS_CONTROL_EXPOSE_HEADERS
```
    The CORS Access-Control-Expose-Headers response header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_MAX_AGE
```
public static final String ACCESS_CONTROL_MAX_AGE
```
    The CORS Access-Control-Max-Age response header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_REQUEST_HEADERS
```
public static final String ACCESS_CONTROL_REQUEST_HEADERS
```
    The CORS Access-Control-Request-Headers request header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - ACCESS_CONTROL_REQUEST_METHOD
```
public static final String ACCESS_CONTROL_REQUEST_METHOD
```
    The CORS Access-Control-Request-Method request header field name.
    
    See Also:
    
    CORS W3C recommendation, Constant Field Values
  - AGE
```
public static final String AGE
```
    The HTTP Age header field name.
    
    See Also:
    
    Section 5.1 of RFC 7234, Constant Field Values
  - ALLOW
```
public static final String ALLOW
```
    The HTTP Allow header field name.
    
    See Also:
    
    Section 7.4.1 of RFC 7231, Constant Field Values
  - AUTHORIZATION
```
public static final String AUTHORIZATION
```
    The HTTP Authorization header field name.
    
    See Also:
    
    Section 4.2 of RFC 7235, Constant Field Values
  - CACHE_CONTROL
```
public static final String CACHE_CONTROL
```
    The HTTP Cache-Control header field name.
    
    See Also:
    
    Section 5.2 of RFC 7234, Constant Field Values
  - CONNECTION
```
public static final String CONNECTION
```
    The HTTP Connection header field name.
    
    See Also:
    
    Section 6.1 of RFC 7230, Constant Field Values
  - CONTENT_ENCODING
```
public static final String CONTENT_ENCODING
```
    The HTTP Content-Encoding header field name.
    
    See Also:
    
    Section 3.1.2.2 of RFC 7231, Constant Field Values
  - CONTENT_DISPOSITION
```
public static final String CONTENT_DISPOSITION
```
    The HTTP Content-Disposition header field name
    
    See Also:
    
    RFC 6266, Constant Field Values
  - CONTENT_LANGUAGE
```
public static final String CONTENT_LANGUAGE
```
    The HTTP Content-Language header field name.
    
    See Also:
    
    Section 3.1.3.2 of RFC 7231, Constant Field Values
  - CONTENT_LENGTH
```
public static final String CONTENT_LENGTH
```
    The HTTP Content-Length header field name.
    
    See Also:
    
    Section 3.3.2 of RFC 7230, Constant Field Values
  - CONTENT_LOCATION
```
public static final String CONTENT_LOCATION
```
    The HTTP Content-Location header field name.
    
    See Also:
    
    Section 3.1.4.2 of RFC 7231, Constant Field Values
  - CONTENT_RANGE
```
public static final String CONTENT_RANGE
```
    The HTTP Content-Range header field name.
    
    See Also:
    
    Section 4.2 of RFC 7233, Constant Field Values
  - CONTENT_TYPE
```
public static final String CONTENT_TYPE
```
    The HTTP Content-Type header field name.
    
    See Also:
    
    Section 3.1.1.5 of RFC 7231, Constant Field Values
  - COOKIE
```
public static final String COOKIE
```
    The HTTP Cookie header field name.
    
    See Also:
    
    Section 4.3.4 of RFC 2109, Constant Field Values
  - DATE
```
public static final String DATE
```
    The HTTP Date header field name.
    
    See Also:
    
    Section 7.1.1.2 of RFC 7231, Constant Field Values
  - ETAG
```
public static final String ETAG
```
    The HTTP ETag header field name.
    
    See Also:
    
    Section 2.3 of RFC 7232, Constant Field Values
  - EXPECT
```
public static final String EXPECT
```
    The HTTP Expect header field name.
    
    See Also:
    
    Section 5.1.1 of RFC 7231, Constant Field Values
  - EXPIRES
```
public static final String EXPIRES
```
    The HTTP Expires header field name.
    
    See Also:
    
    Section 5.3 of RFC 7234, Constant Field Values
  - FROM
```
public static final String FROM
```
    The HTTP From header field name.
    
    See Also:
    
    Section 5.5.1 of RFC 7231, Constant Field Values
  - HOST
```
public static final String HOST
```
    The HTTP Host header field name.
    
    See Also:
    
    Section 5.4 of RFC 7230, Constant Field Values
  - IF_MATCH
```
public static final String IF_MATCH
```
    The HTTP If-Match header field name.
    
    See Also:
    
    Section 3.1 of RFC 7232, Constant Field Values
  - IF_MODIFIED_SINCE
```
public static final String IF_MODIFIED_SINCE
```
    The HTTP If-Modified-Since header field name.
    
    See Also:
    
    Section 3.3 of RFC 7232, Constant Field Values
  - IF_NONE_MATCH
```
public static final String IF_NONE_MATCH
```
    The HTTP If-None-Match header field name.
    
    See Also:
    
    Section 3.2 of RFC 7232, Constant Field Values
  - IF_RANGE
```
public static final String IF_RANGE
```
    The HTTP If-Range header field name.
    
    See Also:
    
    Section 3.2 of RFC 7233, Constant Field Values
  - IF_UNMODIFIED_SINCE
```
public static final String IF_UNMODIFIED_SINCE
```
    The HTTP If-Unmodified-Since header field name.
    
    See Also:
    
    Section 3.4 of RFC 7232, Constant Field Values
  - LAST_MODIFIED
```
public static final String LAST_MODIFIED
```
    The HTTP Last-Modified header field name.
    
    See Also:
    
    Section 2.2 of RFC 7232, Constant Field Values
  - LINK
```
public static final String LINK
```
    The HTTP Link header field name.
    
    See Also:
    
    RFC 5988, Constant Field Values
  - LOCATION
```
public static final String LOCATION
```
    The HTTP Location header field name.
    
    See Also:
    
    Section 7.1.2 of RFC 7231, Constant Field Values
  - MAX_FORWARDS
```
public static final String MAX_FORWARDS
```
    The HTTP Max-Forwards header field name.
    
    See Also:
    
    Section 5.1.2 of RFC 7231, Constant Field Values
  - ORIGIN
```
public static final String ORIGIN
```
    The HTTP Origin header field name.
    
    See Also:
    
    RFC 6454, Constant Field Values
  - PRAGMA
```
public static final String PRAGMA
```
    The HTTP Pragma header field name.
    
    See Also:
    
    Section 5.4 of RFC 7234, Constant Field Values
  - PROXY_AUTHENTICATE
```
public static final String PROXY_AUTHENTICATE
```
    The HTTP Proxy-Authenticate header field name.
    
    See Also:
    
    Section 4.3 of RFC 7235, Constant Field Values
  - PROXY_AUTHORIZATION
```
public static final String PROXY_AUTHORIZATION
```
    The HTTP Proxy-Authorization header field name.
    
    See Also:
    
    Section 4.4 of RFC 7235, Constant Field Values
  - RANGE
```
public static final String RANGE
```
    The HTTP Range header field name.
    
    See Also:
    
    Section 3.1 of RFC 7233, Constant Field Values
  - REFERER
```
public static final String REFERER
```
    The HTTP Referer header field name.
    
    See Also:
    
    Section 5.5.2 of RFC 7231, Constant Field Values
  - RETRY_AFTER
```
public static final String RETRY_AFTER
```
    The HTTP Retry-After header field name.
    
    See Also:
    
    Section 7.1.3 of RFC 7231, Constant Field Values
  - SERVER
```
public static final String SERVER
```
    The HTTP Server header field name.
    
    See Also:
    
    Section 7.4.2 of RFC 7231, Constant Field Values
  - SET_COOKIE
```
public static final String SET_COOKIE
```
    The HTTP Set-Cookie header field name.
    
    See Also:
    
    Section 4.2.2 of RFC 2109, Constant Field Values
  - SET_COOKIE2
```
public static final String SET_COOKIE2
```
    The HTTP Set-Cookie2 header field name.
    
    See Also:
    
    RFC 2965, Constant Field Values
  - TE
```
public static final String TE
```
    The HTTP TE header field name.
    
    See Also:
    
    Section 4.3 of RFC 7230, Constant Field Values
  - TRAILER
```
public static final String TRAILER
```
    The HTTP Trailer header field name.
    
    See Also:
    
    Section 4.4 of RFC 7230, Constant Field Values
  - TRANSFER_ENCODING
```
public static final String TRANSFER_ENCODING
```
    The HTTP Transfer-Encoding header field name.
    
    See Also:
    
    Section 3.3.1 of RFC 7230, Constant Field Values
  - UPGRADE
```
public static final String UPGRADE
```
    The HTTP Upgrade header field name.
    
    See Also:
    
    Section 6.7 of RFC 7230, Constant Field Values
  - USER_AGENT
```
public static final String USER_AGENT
```
    The HTTP User-Agent header field name.
    
    See Also:
    
    Section 5.5.3 of RFC 7231, Constant Field Values
  - VARY
```
public static final String VARY
```
    The HTTP Vary header field name.
    
    See Also:
    
    Section 7.1.4 of RFC 7231, Constant Field Values
  - VIA
```
public static final String VIA
```
    The HTTP Via header field name.
    
    See Also:
    
    Section 5.7.1 of RFC 7230, Constant Field Values
  - WARNING
```
public static final String WARNING
```
    The HTTP Warning header field name.
    
    See Also:
    
    Section 5.5 of RFC 7234, Constant Field Values
  - WWW_AUTHENTICATE
```
public static final String WWW_AUTHENTICATE
```
    The HTTP WWW-Authenticate header field name.
    
    See Also:
    
    Section 4.1 of RFC 7235, Constant Field Values
- Constructor Detail
  - HttpHeaders
```
public HttpHeaders()
```
    Constructs a new, empty instance of the HttpHeaders object.
- Method Detail
  - setAccept
```
public void setAccept(List<MediaType> acceptableMediaTypes)
```
    Set the list of acceptable media types, as specified by the Accept header.
  - getAccept
```
public List<MediaType> getAccept()
```
    Return the list of acceptable media types, as specified by the Accept header.
    Returns an empty list when the acceptable media types are unspecified.
  - setAccessControlAllowCredentials
```
public void setAccessControlAllowCredentials(boolean allowCredentials)
```
    Set the (new) value of the Access-Control-Allow-Credentials response header.
  - getAccessControlAllowCredentials
```
public boolean getAccessControlAllowCredentials()
```
    Return the value of the Access-Control-Allow-Credentials response header.
  - setAccessControlAllowHeaders
```
public void setAccessControlAllowHeaders(List<String> allowedHeaders)
```
    Set the (new) value of the Access-Control-Allow-Headers response header.
  - getAccessControlAllowHeaders
```
public List<String> getAccessControlAllowHeaders()
```
    Return the value of the Access-Control-Allow-Headers response header.
  - setAccessControlAllowMethods
```
public void setAccessControlAllowMethods(List<HttpMethod> allowedMethods)
```
    Set the (new) value of the Access-Control-Allow-Methods response header.
  - getAccessControlAllowMethods
```
public List<HttpMethod> getAccessControlAllowMethods()
```
    Return the value of the Access-Control-Allow-Methods response header.
  - setAccessControlAllowOrigin
```
public void setAccessControlAllowOrigin(String allowedOrigin)
```
    Set the (new) value of the Access-Control-Allow-Origin response header.
  - getAccessControlAllowOrigin
```
public String getAccessControlAllowOrigin()
```
    Return the value of the Access-Control-Allow-Origin response header.
  - setAccessControlExposeHeaders
```
public void setAccessControlExposeHeaders(List<String> exposedHeaders)
```
    Set the (new) value of the Access-Control-Expose-Headers response header.
  - getAccessControlExposeHeaders
```
public List<String> getAccessControlExposeHeaders()
```
    Return the value of the Access-Control-Expose-Headers response header.
  - setAccessControlMaxAge
```
public void setAccessControlMaxAge(long maxAge)
```
    Set the (new) value of the Access-Control-Max-Age response header.
  - getAccessControlMaxAge
```
public long getAccessControlMaxAge()
```
    Return the value of the Access-Control-Max-Age response header.
    Returns -1 when the max age is unknown.
  - setAccessControlRequestHeaders
```
public void setAccessControlRequestHeaders(List<String> requestHeaders)
```
    Set the (new) value of the Access-Control-Request-Headers request header.
  - getAccessControlRequestHeaders
```
public List<String> getAccessControlRequestHeaders()
```
    Return the value of the Access-Control-Request-Headers request header.
  - setAccessControlRequestMethod
```
public void setAccessControlRequestMethod(HttpMethod requestMethod)
```
    Set the (new) value of the Access-Control-Request-Method request header.
  - getAccessControlRequestMethod
```
public HttpMethod getAccessControlRequestMethod()
```
    Return the value of the Access-Control-Request-Method request header.
  - setAcceptCharset
```
public void setAcceptCharset(List<Charset> acceptableCharsets)
```
    Set the list of acceptable charsets, as specified by the Accept-Charset header.
  - getAcceptCharset
```
public List<Charset> getAcceptCharset()
```
    Return the list of acceptable charsets, as specified by the Accept-Charset header.
  - setAllow
```
public void setAllow(Set<HttpMethod> allowedMethods)
```
    Set the set of allowed HTTP methods, as specified by the Allow header.
  - getAllow
```
public Set<HttpMethod> getAllow()
```
    Return the set of allowed HTTP methods, as specified by the Allow header.
    Returns an empty set when the allowed methods are unspecified.
  - setCacheControl
```
public void setCacheControl(String cacheControl)
```
    Set the (new) value of the Cache-Control header.
  - getCacheControl
```
public String getCacheControl()
```
    Return the value of the Cache-Control header.
  - setConnection
```
public void setConnection(String connection)
```
    Set the (new) value of the Connection header.
  - setConnection
```
public void setConnection(List<String> connection)
```
    Set the (new) value of the Connection header.
  - getConnection
```
public List<String> getConnection()
```
    Return the value of the Connection header.
  - setContentDispositionFormData
```
public void setContentDispositionFormData(String name,
                                          String filename)
```
    Set the Content-Disposition header when creating a "multipart/form-data" request.
    Applications typically would not set this header directly but rather prepare a MultiValueMap<String, Object>, containing an Object or a Resource for each part, and then pass that to the RestTemplate or WebClient.
    
    Parameters:
    
    name - the control name
    
    filename - the filename (may be null)
  - setContentDispositionFormData
```
@Deprecated
public void setContentDispositionFormData(String name,
                                                      String filename,
                                                      Charset charset)
```
    Deprecated. deprecated in 4.3.11 and removed from 5.0; as per RFC 7578, Section 4.2, an RFC 5987 style encoding should not be used for multipart/form-data requests. Furthermore there should be no reason for applications to set this header explicitly; for more details also read setContentDispositionFormData(String, String)
    
    Set the (new) value of the Content-Disposition header for form-data, optionally encoding the filename using the RFC 5987.
    Only the US-ASCII, UTF-8 and ISO-8859-1 charsets are supported.
    
    Parameters:
    
    name - the control name
    
    filename - the filename (may be null)
    
    charset - the charset used for the filename (may be null)
  - setContentLength
```
public void setContentLength(long contentLength)
```
    Set the length of the body in bytes, as specified by the Content-Length header.
  - getContentLength
```
public long getContentLength()
```
    Return the length of the body in bytes, as specified by the Content-Length header.
    Returns -1 when the content-length is unknown.
  - setContentType
```
public void setContentType(MediaType mediaType)
```
    Set the media type of the body, as specified by the Content-Type header.
  - getContentType
```
public MediaType getContentType()
```
    Return the media type of the body, as specified by the Content-Type header.
    Returns null when the content-type is unknown.
  - setDate
```
public void setDate(long date)
```
    Set the date and time at which the message was created, as specified by the Date header.
    The date should be specified as the number of milliseconds since January 1, 1970 GMT.
  - getDate
```
public long getDate()
```
    Return the date and time at which the message was created, as specified by the Date header.
    The date is returned as the number of milliseconds since January 1, 1970 GMT. Returns -1 when the date is unknown.
    
    Throws:
    
    IllegalArgumentException - if the value can't be converted to a date
  - setETag
```
public void setETag(String eTag)
```
    Set the (new) entity tag of the body, as specified by the ETag header.
  - getETag
```
public String getETag()
```
    Return the entity tag of the body, as specified by the ETag header.
  - setExpires
```
public void setExpires(long expires)
```
    Set the date and time at which the message is no longer valid, as specified by the Expires header.
    The date should be specified as the number of milliseconds since January 1, 1970 GMT.
  - getExpires
```
public long getExpires()
```
    Return the date and time at which the message is no longer valid, as specified by the Expires header.
    The date is returned as the number of milliseconds since January 1, 1970 GMT. Returns -1 when the date is unknown.
  - setIfMatch
```
public void setIfMatch(String ifMatch)
```
    Set the (new) value of the If-Match header.
    
    Since:
    
    4.3
  - setIfMatch
```
public void setIfMatch(List<String> ifMatchList)
```
    Set the (new) value of the If-Match header.
    
    Since:
    
    4.3
  - getIfMatch
```
public List<String> getIfMatch()
```
    Return the value of the If-Match header.
    
    Since:
    
    4.3
  - setIfModifiedSince
```
public void setIfModifiedSince(long ifModifiedSince)
```
    Set the (new) value of the If-Modified-Since header.
    The date should be specified as the number of milliseconds since January 1, 1970 GMT.
  - getIfModifiedSince
```
public long getIfModifiedSince()
```
    Return the value of the If-Modified-Since header.
    The date is returned as the number of milliseconds since January 1, 1970 GMT. Returns -1 when the date is unknown.
  - setIfNoneMatch
```
public void setIfNoneMatch(String ifNoneMatch)
```
    Set the (new) value of the If-None-Match header.
  - setIfNoneMatch
```
public void setIfNoneMatch(List<String> ifNoneMatchList)
```
    Set the (new) values of the If-None-Match header.
  - getIfNoneMatch
```
public List<String> getIfNoneMatch()
```
    Return the value of the If-None-Match header.
  - setIfUnmodifiedSince
```
public void setIfUnmodifiedSince(long ifUnmodifiedSince)
```
    Set the (new) value of the If-Unmodified-Since header.
    The date should be specified as the number of milliseconds since January 1, 1970 GMT.
    
    Since:
    
    4.3
  - getIfUnmodifiedSince
```
public long getIfUnmodifiedSince()
```
    Return the value of the If-Unmodified-Since header.
    The date is returned as the number of milliseconds since January 1, 1970 GMT. Returns -1 when the date is unknown.
    
    Since:
    
    4.3
  - setLastModified
```
public void setLastModified(long lastModified)
```
    Set the time the resource was last changed, as specified by the Last-Modified header.
    The date should be specified as the number of milliseconds since January 1, 1970 GMT.
  - getLastModified
```
public long getLastModified()
```
    Return the time the resource was last changed, as specified by the Last-Modified header.
    The date is returned as the number of milliseconds since January 1, 1970 GMT. Returns -1 when the date is unknown.
  - setLocation
```
public void setLocation(URI location)
```
    Set the (new) location of a resource, as specified by the Location header.
  - getLocation
```
public URI getLocation()
```
    Return the (new) location of a resource as specified by the Location header.
    Returns null when the location is unknown.
  - setOrigin
```
public void setOrigin(String origin)
```
    Set the (new) value of the Origin header.
  - getOrigin
```
public String getOrigin()
```
    Return the value of the Origin header.
  - setPragma
```
public void setPragma(String pragma)
```
    Set the (new) value of the Pragma header.
  - getPragma
```
public String getPragma()
```
    Return the value of the Pragma header.
  - setRange
```
public void setRange(List<HttpRange> ranges)
```
    Sets the (new) value of the Range header.
  - getRange
```
public List<HttpRange> getRange()
```
    Return the value of the Range header.
    Returns an empty list when the range is unknown.
  - setUpgrade
```
public void setUpgrade(String upgrade)
```
    Set the (new) value of the Upgrade header.
  - getUpgrade
```
public String getUpgrade()
```
    Return the value of the Upgrade header.
  - setVary
```
public void setVary(List<String> requestHeaders)
```
    Set the request header names (e.g. "Accept-Language") for which the response is subject to content negotiation and variances based on the value of those request headers.
    
    Parameters:
    
    requestHeaders - the request header names
    
    Since:
    
    4.3
  - getVary
```
public List<String> getVary()
```
    Return the request header names subject to content negotiation.
    
    Since:
    
    4.3
  - setDate
```
public void setDate(String headerName,
                    long date)
```
    Set the given date under the given header name after formatting it as a string using the pattern "EEE, dd MMM yyyy HH:mm:ss zzz". The equivalent of set(String, String) but for date headers.
    
    Since:
    
    3.2.4
  - getFirstDate
```
public long getFirstDate(String headerName)
```
    Parse the first header value for the given header name as a date, return -1 if there is no value, or raise IllegalArgumentException if the value cannot be parsed as a date.
    
    Parameters:
    
    headerName - the header name
    
    Returns:
    
    the parsed date header, or -1 if none
    
    Since:
    
    3.2.4
  - getValuesAsList
```
public List<String> getValuesAsList(String headerName)
```
    Return all values of a given header name, even if this header is set multiple times.
    
    Parameters:
    
    headerName - the header name
    
    Returns:
    
    all associated values
    
    Since:
    
    4.3
  - getETagValuesAsList
```
protected List<String> getETagValuesAsList(String headerName)
```
    Retrieve a combined result from the field values of the ETag header.
    
    Parameters:
    
    headerName - the header name
    
    Returns:
    
    the combined result
    
    Since:
    
    4.3
  - getFieldValues
```
protected String getFieldValues(String headerName)
```
    Retrieve a combined result from the field values of multi-valued headers.
    
    Parameters:
    
    headerName - the header name
    
    Returns:
    
    the combined result
    
    Since:
    
    4.3
  - toCommaDelimitedString
```
protected String toCommaDelimitedString(List<String> headerValues)
```
    Turn the given list of header values into a comma-delimited result.
    
    Parameters:
    
    headerValues - the list of header values
    
    Returns:
    
    a combined result with comma delimitation
  - getFirst
```
public String getFirst(String headerName)
```
    Return the first header value for the given header name, if any.
    
    Specified by:
    
    getFirst in interface MultiValueMap<String,String>
    
    Parameters:
    
    headerName - the header name
    
    Returns:
    
    the first header value, or null if none
  - add
```
public void add(String headerName,
                String headerValue)
```
    Add the given, single header value under the given name.
    
    Specified by:
    
    add in interface MultiValueMap<String,String>
    
    Parameters:
    
    headerName - the header name
    
    headerValue - the header value
    
    Throws:
    
    UnsupportedOperationException - if adding headers is not supported
    
    See Also:
    
    put(String, List), set(String, String)
  - set
```
public void set(String headerName,
                String headerValue)
```
    Set the given, single header value under the given name.
    
    Specified by:
    
    set in interface MultiValueMap<String,String>
    
    Parameters:
    
    headerName - the header name
    
    headerValue - the header value
    
    Throws:
    
    UnsupportedOperationException - if adding headers is not supported
    
    See Also:
    
    put(String, List), add(String, String)
  - setAll
```
public void setAll(Map<String,String> values)
```
    Description copied from interface: MultiValueMap
    
    Set the given values under.
    
    Specified by:
    
    setAll in interface MultiValueMap<String,String>
    
    Parameters:
    
    values - the values.
  - toSingleValueMap
```
public Map<String,String> toSingleValueMap()
```
    Description copied from interface: MultiValueMap
    
    Returns the first values contained in this MultiValueMap.
    
    Specified by:
    
    toSingleValueMap in interface MultiValueMap<String,String>
    
    Returns:
    
    a single value representation of this map
  - size
```
public int size()
```
    Specified by:
    
    size in interface Map<String,List<String>>
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface Map<String,List<String>>
  - containsKey
```
public boolean containsKey(Object key)
```
    Specified by:
    
    containsKey in interface Map<String,List<String>>
  - containsValue
```
public boolean containsValue(Object value)
```
    Specified by:
    
    containsValue in interface Map<String,List<String>>
  - get
```
public List<String> get(Object key)
```
    Specified by:
    
    get in interface Map<String,List<String>>
  - put
```
public List<String> put(String key,
                        List<String> value)
```
    Specified by:
    
    put in interface Map<String,List<String>>
  - remove
```
public List<String> remove(Object key)
```
    Specified by:
    
    remove in interface Map<String,List<String>>
  - putAll
```
public void putAll(Map<? extends String,? extends List<String>> map)
```
    Specified by:
    
    putAll in interface Map<String,List<String>>
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Map<String,List<String>>
  - keySet
```
public Set<String> keySet()
```
    Specified by:
    
    keySet in interface Map<String,List<String>>
  - values
```
public Collection<List<String>> values()
```
    Specified by:
    
    values in interface Map<String,List<String>>
  - entrySet
```
public Set<Map.Entry<String,List<String>>> entrySet()
```
    Specified by:
    
    entrySet in interface Map<String,List<String>>
  - equals
```
public boolean equals(Object other)
```
    Specified by:
    
    equals in interface Map<String,List<String>>
    
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Map<String,List<String>>
    
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - readOnlyHttpHeaders
```
public static HttpHeaders readOnlyHttpHeaders(HttpHeaders headers)
```
    Return a HttpHeaders object that can only be read, not written to.

Class HttpHeaders

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Field Detail

ACCEPT

ACCEPT_CHARSET

ACCEPT_ENCODING

ACCEPT_LANGUAGE

ACCEPT_RANGES

ACCESS_CONTROL_ALLOW_CREDENTIALS

ACCESS_CONTROL_ALLOW_HEADERS

ACCESS_CONTROL_ALLOW_METHODS

ACCESS_CONTROL_ALLOW_ORIGIN

ACCESS_CONTROL_EXPOSE_HEADERS

ACCESS_CONTROL_MAX_AGE

ACCESS_CONTROL_REQUEST_HEADERS

ACCESS_CONTROL_REQUEST_METHOD

AGE

ALLOW

AUTHORIZATION

CACHE_CONTROL

CONNECTION

CONTENT_ENCODING

CONTENT_DISPOSITION

CONTENT_LANGUAGE

CONTENT_LENGTH

CONTENT_LOCATION

CONTENT_RANGE

CONTENT_TYPE

COOKIE

DATE

ETAG

EXPECT

EXPIRES

FROM

HOST

IF_MATCH

IF_MODIFIED_SINCE

IF_NONE_MATCH

IF_RANGE

IF_UNMODIFIED_SINCE

LAST_MODIFIED

LINK

LOCATION

MAX_FORWARDS

ORIGIN

PRAGMA

PROXY_AUTHENTICATE

PROXY_AUTHORIZATION

RANGE

REFERER

RETRY_AFTER

SERVER

SET_COOKIE

SET_COOKIE2

TE

TRAILER

TRANSFER_ENCODING

UPGRADE

USER_AGENT

VARY

VIA

WARNING

WWW_AUTHENTICATE

Constructor Detail

HttpHeaders

Method Detail

setAccept

getAccept

setAccessControlAllowCredentials

getAccessControlAllowCredentials

setAccessControlAllowHeaders

getAccessControlAllowHeaders

setAccessControlAllowMethods

getAccessControlAllowMethods