HttpHeaders

```
public interface HttpHeaders
```
An injectable interface that provides access to HTTP header information. All methods throw IllegalStateException if called outside the scope of a request (e.g. from a provider constructor).

Since:

1.0

See Also:

Context

Examples (en):

security-tomcat-user-identitystore, bval-evaluation-redeployment

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`ACCEPT` See HTTP/1.1 documentation.
`static java.lang.String`	`ACCEPT_CHARSET` See HTTP/1.1 documentation.
`static java.lang.String`	`ACCEPT_ENCODING` See HTTP/1.1 documentation.
`static java.lang.String`	`ACCEPT_LANGUAGE` See HTTP/1.1 documentation.
`static java.lang.String`	`ALLOW` See HTTP/1.1 documentation.
`static java.lang.String`	`AUTHORIZATION` See HTTP/1.1 documentation.
`static java.lang.String`	`CACHE_CONTROL` See HTTP/1.1 documentation.
`static java.lang.String`	`CONTENT_DISPOSITION` See IETF RFC-2183.
`static java.lang.String`	`CONTENT_ENCODING` See HTTP/1.1 documentation.
`static java.lang.String`	`CONTENT_ID` See IETF RFC-2392.
`static java.lang.String`	`CONTENT_LANGUAGE` See HTTP/1.1 documentation.
`static java.lang.String`	`CONTENT_LENGTH` See HTTP/1.1 documentation.
`static java.lang.String`	`CONTENT_LOCATION` See HTTP/1.1 documentation.
`static java.lang.String`	`CONTENT_TYPE` See HTTP/1.1 documentation.
`static java.lang.String`	`COOKIE` See IETF RFC 2109.
`static java.lang.String`	`DATE` See HTTP/1.1 documentation.
`static java.lang.String`	`ETAG` See HTTP/1.1 documentation.
`static java.lang.String`	`EXPECT` See HTTP/1.1 documentation.
`static java.lang.String`	`EXPIRES` See HTTP/1.1 documentation.
`static java.lang.String`	`HOST` See HTTP/1.1 documentation.
`static java.lang.String`	`IF_MATCH` See HTTP/1.1 documentation.
`static java.lang.String`	`IF_MODIFIED_SINCE` See HTTP/1.1 documentation.
`static java.lang.String`	`IF_NONE_MATCH` See HTTP/1.1 documentation.
`static java.lang.String`	`IF_UNMODIFIED_SINCE` See HTTP/1.1 documentation.
`static java.lang.String`	`LAST_EVENT_ID_HEADER` `"Last-Event-ID"` HTTP request header name as defined by SSE specification.
`static java.lang.String`	`LAST_MODIFIED` See HTTP/1.1 documentation.
`static java.lang.String`	`LINK` See Web Linking (IETF RFC-5988) documentation.
`static java.lang.String`	`LOCATION` See HTTP/1.1 documentation.
`static java.lang.String`	`RETRY_AFTER` See HTTP/1.1 documentation.
`static java.lang.String`	`SET_COOKIE` See IETF RFC 2109.
`static java.lang.String`	`USER_AGENT` See HTTP/1.1 documentation.
`static java.lang.String`	`VARY` See HTTP/1.1 documentation.
`static java.lang.String`	`WWW_AUTHENTICATE` See HTTP/1.1 documentation.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`java.util.List<java.util.Locale>`	`getAcceptableLanguages()` Get a list of languages that are acceptable for the response.
`java.util.List<MediaType>`	`getAcceptableMediaTypes()` Get a list of media types that are acceptable for the response.
`java.util.Map<java.lang.String,Cookie>`	`getCookies()` Get any cookies that accompanied the request.
`java.util.Date`	`getDate()` Get message date.
`java.lang.String`	`getHeaderString(java.lang.String name)` Get a HTTP header as a single string value.
`java.util.Locale`	`getLanguage()` Get the language of the request entity.
`int`	`getLength()` Get Content-Length value.
`MediaType`	`getMediaType()` Get the media type of the request entity.
`java.util.List<java.lang.String>`	`getRequestHeader(java.lang.String name)` Get the values of a HTTP request header if the header exists on the current request.
`MultivaluedMap<java.lang.String,java.lang.String>`	`getRequestHeaders()` Get the values of HTTP request headers.

- Field Detail
  - ACCEPT
```
static final java.lang.String ACCEPT
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - ACCEPT_CHARSET
```
static final java.lang.String ACCEPT_CHARSET
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - ACCEPT_ENCODING
```
static final java.lang.String ACCEPT_ENCODING
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - ACCEPT_LANGUAGE
```
static final java.lang.String ACCEPT_LANGUAGE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - ALLOW
```
static final java.lang.String ALLOW
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - AUTHORIZATION
```
static final java.lang.String AUTHORIZATION
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - CACHE_CONTROL
```
static final java.lang.String CACHE_CONTROL
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - CONTENT_DISPOSITION
```
static final java.lang.String CONTENT_DISPOSITION
```
    See IETF RFC-2183.
    
    See Also:
    
    Constant Field Values
  - CONTENT_ENCODING
```
static final java.lang.String CONTENT_ENCODING
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - CONTENT_ID
```
static final java.lang.String CONTENT_ID
```
    See IETF RFC-2392.
    
    See Also:
    
    Constant Field Values
  - CONTENT_LANGUAGE
```
static final java.lang.String CONTENT_LANGUAGE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - CONTENT_LENGTH
```
static final java.lang.String CONTENT_LENGTH
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - CONTENT_LOCATION
```
static final java.lang.String CONTENT_LOCATION
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - CONTENT_TYPE
```
static final java.lang.String CONTENT_TYPE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - DATE
```
static final java.lang.String DATE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - ETAG
```
static final java.lang.String ETAG
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - EXPECT
```
static final java.lang.String EXPECT
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - EXPIRES
```
static final java.lang.String EXPIRES
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - HOST
```
static final java.lang.String HOST
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - IF_MATCH
```
static final java.lang.String IF_MATCH
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - IF_MODIFIED_SINCE
```
static final java.lang.String IF_MODIFIED_SINCE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - IF_NONE_MATCH
```
static final java.lang.String IF_NONE_MATCH
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - IF_UNMODIFIED_SINCE
```
static final java.lang.String IF_UNMODIFIED_SINCE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - LAST_MODIFIED
```
static final java.lang.String LAST_MODIFIED
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - LOCATION
```
static final java.lang.String LOCATION
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - LINK
```
static final java.lang.String LINK
```
    See Web Linking (IETF RFC-5988) documentation.
    
    See Also:
    
    Constant Field Values
  - RETRY_AFTER
```
static final java.lang.String RETRY_AFTER
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - USER_AGENT
```
static final java.lang.String USER_AGENT
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - VARY
```
static final java.lang.String VARY
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - WWW_AUTHENTICATE
```
static final java.lang.String WWW_AUTHENTICATE
```
    See HTTP/1.1 documentation.
    
    See Also:
    
    Constant Field Values
  - COOKIE
```
static final java.lang.String COOKIE
```
    See IETF RFC 2109.
    
    See Also:
    
    Constant Field Values
  - SET_COOKIE
```
static final java.lang.String SET_COOKIE
```
    See IETF RFC 2109.
    
    See Also:
    
    Constant Field Values
  - LAST_EVENT_ID_HEADER
```
static final java.lang.String LAST_EVENT_ID_HEADER
```
    "Last-Event-ID" HTTP request header name as defined by SSE specification.
    
    Since:
    
    2.1
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getRequestHeader
```
java.util.List<java.lang.String> getRequestHeader(java.lang.String name)
```
    Get the values of a HTTP request header if the header exists on the current request. The returned value will be a read-only List if the specified header exists or null if it does not. This is a shortcut for getRequestHeaders().get(name).
    
    Parameters:
    
    name - the header name, case insensitive.
    
    Returns:
    
    a read-only list of header values if the specified header exists, otherwise null.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request.
  - getHeaderString
```
java.lang.String getHeaderString(java.lang.String name)
```
    Get a HTTP header as a single string value.
    Each single header value is converted to String using a RuntimeDelegate.HeaderDelegate if one is available via RuntimeDelegate.createHeaderDelegate(java.lang.Class) for the header value class or using its toString method if a header delegate is not available.
    
    Parameters:
    
    name - the HTTP header.
    
    Returns:
    
    the HTTP header value. If the HTTP header is not present then null is returned. If the HTTP header is present but has no value then the empty string is returned. If the HTTP header is present more than once then the values of joined together and separated by a ',' character.
    
    Since:
    
    2.0
    
    See Also:
    
    getRequestHeader(java.lang.String)
  - getRequestHeaders
```
MultivaluedMap<java.lang.String,java.lang.String> getRequestHeaders()
```
    Get the values of HTTP request headers. The returned Map is case-insensitive wrt. keys and is read-only. The method never returns null.
    
    Returns:
    
    a read-only map of header names and values.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request.
  - getAcceptableMediaTypes
```
java.util.List<MediaType> getAcceptableMediaTypes()
```
    Get a list of media types that are acceptable for the response.
    If no acceptable media types are specified, a read-only list containing a single wildcard media type instance is returned.
    
    Returns:
    
    a read-only list of requested response media types sorted according to their q-value, with highest preference first.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request.
  - getAcceptableLanguages
```
java.util.List<java.util.Locale> getAcceptableLanguages()
```
    Get a list of languages that are acceptable for the response.
    If no acceptable languages are specified, a read-only list containing a single wildcard Locale instance (with language field set to "*") is returned.
    
    Returns:
    
    a read-only list of acceptable languages sorted according to their q-value, with highest preference first.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request.
  - getMediaType
```
MediaType getMediaType()
```
    Get the media type of the request entity.
    
    Returns:
    
    the media type or null if there is no request entity.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request.
  - getLanguage
```
java.util.Locale getLanguage()
```
    Get the language of the request entity.
    
    Returns:
    
    the language of the entity or null if not specified.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request.
  - getCookies
```
java.util.Map<java.lang.String,Cookie> getCookies()
```
    Get any cookies that accompanied the request.
    
    Returns:
    
    a read-only map of cookie name (String) to Cookie.
    
    Throws:
    
    java.lang.IllegalStateException - if called outside the scope of a request
  - getDate
```
java.util.Date getDate()
```
    Get message date.
    
    Returns:
    
    the message date, otherwise null if not present.
    
    Since:
    
    2.0
  - getLength
```
int getLength()
```
    Get Content-Length value.
    
    Returns:
    
    Content-Length as integer if present and valid number. In other cases returns -1.
    
    Since:
    
    2.0

Interface HttpHeaders

Field Summary

Method Summary

Field Detail

ACCEPT

ACCEPT_CHARSET

ACCEPT_ENCODING

ACCEPT_LANGUAGE

ALLOW

AUTHORIZATION

CACHE_CONTROL

CONTENT_DISPOSITION

CONTENT_ENCODING

CONTENT_ID

CONTENT_LANGUAGE

CONTENT_LENGTH

CONTENT_LOCATION

CONTENT_TYPE

DATE

ETAG

EXPECT

EXPIRES

HOST

IF_MATCH

IF_MODIFIED_SINCE

IF_NONE_MATCH

IF_UNMODIFIED_SINCE

LAST_MODIFIED

LOCATION

LINK

RETRY_AFTER

USER_AGENT

VARY

WWW_AUTHENTICATE

COOKIE

SET_COOKIE

LAST_EVENT_ID_HEADER

Method Detail

getRequestHeader

getHeaderString

getRequestHeaders

getAcceptableMediaTypes

getAcceptableLanguages

getMediaType

getLanguage

getCookies

getDate

getLength