HttpHeaders (jakarta.ws.rs-api 2.1.6 API)

```
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

Author:

Paul Sandoz, Marc Hadley

See Also:

Context

Field Summary

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

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`List<Locale>`	`getAcceptableLanguages()`	Get a list of languages that are acceptable for the response.
`List<MediaType>`	`getAcceptableMediaTypes()`	Get a list of media types that are acceptable for the response.
`Map<String,Cookie>`	`getCookies()`	Get any cookies that accompanied the request.
`Date`	`getDate()`	Get message date.
`String`	`getHeaderString(String name)`	Get a HTTP header as a single string value.
`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.
`List<String>`	`getRequestHeader(String name)`	Get the values of a HTTP request header.
`MultivaluedMap<String,String>`	`getRequestHeaders()`	Get the values of HTTP request headers.

- Field Detail
  - ACCEPT
```
static final String ACCEPT
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - ACCEPT_CHARSET
```
static final String ACCEPT_CHARSET
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - ACCEPT_ENCODING
```
static final String ACCEPT_ENCODING
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - ACCEPT_LANGUAGE
```
static final String ACCEPT_LANGUAGE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - ALLOW
```
static final String ALLOW
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - AUTHORIZATION
```
static final String AUTHORIZATION
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - CACHE_CONTROL
```
static final String CACHE_CONTROL
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_DISPOSITION
```
static final String CONTENT_DISPOSITION
```
    See {@link IETF RFC-2183}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_ENCODING
```
static final String CONTENT_ENCODING
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_ID
```
static final String CONTENT_ID
```
    See {@link IETF RFC-2392}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_LANGUAGE
```
static final String CONTENT_LANGUAGE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_LENGTH
```
static final String CONTENT_LENGTH
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_LOCATION
```
static final String CONTENT_LOCATION
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - CONTENT_TYPE
```
static final String CONTENT_TYPE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - DATE
```
static final String DATE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - ETAG
```
static final String ETAG
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - EXPIRES
```
static final String EXPIRES
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - HOST
```
static final String HOST
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - IF_MATCH
```
static final String IF_MATCH
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - IF_MODIFIED_SINCE
```
static final String IF_MODIFIED_SINCE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - IF_NONE_MATCH
```
static final String IF_NONE_MATCH
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - IF_UNMODIFIED_SINCE
```
static final String IF_UNMODIFIED_SINCE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - LAST_MODIFIED
```
static final String LAST_MODIFIED
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - LOCATION
```
static final String LOCATION
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - LINK
```
static final String LINK
```
    See {@link Web Linking (IETF RFC-5988) documentation}.
    
    See Also:
    
    Constant Field Values
  - RETRY_AFTER
```
static final String RETRY_AFTER
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - USER_AGENT
```
static final String USER_AGENT
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - VARY
```
static final String VARY
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - WWW_AUTHENTICATE
```
static final String WWW_AUTHENTICATE
```
    See {@link HTTP/1.1 documentation}.
    
    See Also:
    
    Constant Field Values
  - COOKIE
```
static final String COOKIE
```
    See {@link IETF RFC 2109}.
    
    See Also:
    
    Constant Field Values
  - SET_COOKIE
```
static final String SET_COOKIE
```
    See {@link IETF RFC 2109}.
    
    See Also:
    
    Constant Field Values
  - LAST_EVENT_ID_HEADER
```
static final 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
```
List<String> getRequestHeader(String name)
```
    Get the values of a HTTP request header. The returned List is read-only. This is a shortcut for getRequestHeaders().get(name).
    
    Parameters:
    
    name - the header name, case insensitive.
    
    Returns:
    
    a read-only list of header values.
    
    Throws:
    
    IllegalStateException - if called outside the scope of a request.
  - getHeaderString
```
String getHeaderString(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<String,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:
    
    IllegalStateException - if called outside the scope of a request.
  - getAcceptableMediaTypes
```
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:
    
    IllegalStateException - if called outside the scope of a request.
  - getAcceptableLanguages
```
List<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:
    
    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:
    
    IllegalStateException - if called outside the scope of a request.
  - getLanguage
```
Locale getLanguage()
```
    Get the language of the request entity.
    
    Returns:
    
    the language of the entity or null if not specified.
    
    Throws:
    
    IllegalStateException - if called outside the scope of a request.
  - getCookies
```
Map<String,Cookie> getCookies()
```
    Get any cookies that accompanied the request.
    
    Returns:
    
    a read-only map of cookie name (String) to Cookie.
    
    Throws:
    
    IllegalStateException - if called outside the scope of a request
  - getDate
```
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

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