Http.RequestHeader (Play 2.6.20)

All Known Subinterfaces:

Http.Request

All Known Implementing Classes:

Http.RequestImpl, play.core.j.RequestHeaderImpl, play.core.j.RequestImpl

Enclosing class:

Http
```
public static interface Http.RequestHeader
```

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`play.api.mvc.RequestHeader`	`_underlyingHeader()` Deprecated. As of release 2.6.0. Use `asScala()`
`List<play.api.http.MediaRange>`	`acceptedTypes()`
`List<Lang>`	`acceptLanguages()` The Request Langs extracted from the Accept-Language header and sorted by preference (preferred first).
`boolean`	`accepts(String mimeType)` Check if this request accepts a given media type.
`<A> Http.RequestHeader`	`addAttr(TypedKey<A> key, A value)` Create a new versions of this object with the given attribute attached to it.
`play.api.mvc.RequestHeader`	`asScala()` Return the Scala version of the request header.
`TypedMap`	`attrs()`
`Optional<String>`	`charset()` Get the charset of the request.
`Optional<List<X509Certificate>>`	`clientCertificateChain()` The X509 certificate chain presented by a client during SSL requests.
`Optional<String>`	`contentType()` Get the content type of the request.
`Http.Cookie`	`cookie(String name)`
`Http.Cookies`	`cookies()`
`default String`	`getHeader(String headerName)` Deprecated. Deprecated as of 2.6.0. Use `header(String)` ()} instead.
`Http.Headers`	`getHeaders()` Retrieve all headers.
`String`	`getQueryString(String key)` Helper method to access a queryString parameter.
`boolean`	`hasBody()` Checks if the request has a body.
`default boolean`	`hasHeader(String headerName)` Checks if the request has the header.
`default Optional<String>`	`header(String headerName)` Retrieves a single header.
`default Map<String,String[]>`	`headers()` Deprecated. Deprecated as of 2.6.0. Use `getHeaders()` instead.
`String`	`host()` The request host.
`String`	`method()` The HTTP Method.
`String`	`path()` The URI path.
`Map<String,String[]>`	`queryString()` The query string content.
`String`	`remoteAddress()` The client IP address.
`boolean`	`secure()` Is the client using SSL?
`Map<String,String>`	`tags()` Deprecated. Use `attr`, `withAttr`, etc.
`String`	`uri()` The complete request URI, containing both path and query string.
`String`	`version()` The HTTP version.
`Http.RequestHeader`	`withAttrs(TypedMap newAttrs)` Create a new version of this object with the given attributes attached to it.
`Http.Request`	`withBody(Http.RequestBody body)` Attach a body to this header.

- Method Detail
  - uri
```
String uri()
```
    The complete request URI, containing both path and query string.
    
    Returns:
    
    the uri
  - method
```
String method()
```
    The HTTP Method.
    
    Returns:
    
    the http method
  - version
```
String version()
```
    The HTTP version.
    
    Returns:
    
    the version
  - remoteAddress
```
String remoteAddress()
```
    The client IP address. retrieves the last untrusted proxy from the Forwarded-Headers or the X-Forwarded-*-Headers.
    
    Returns:
    
    the remote address
  - secure
```
boolean secure()
```
    Is the client using SSL?
    
    Returns:
    
    true that the client is using SSL
  - attrs
```
TypedMap attrs()
```
    Returns:
    
    a map of typed attributes associated with the request.
  - withAttrs
```
Http.RequestHeader withAttrs(TypedMap newAttrs)
```
    Create a new version of this object with the given attributes attached to it.
    
    Parameters:
    
    newAttrs - The new attributes to add.
    
    Returns:
    
    The new version of this object with the attributes attached.
  - addAttr
```
<A> Http.RequestHeader addAttr(TypedKey<A> key,
                               A value)
```
    Create a new versions of this object with the given attribute attached to it.
    
    Type Parameters:
    
    A - the attribute type
    
    Parameters:
    
    key - The new attribute key.
    
    value - The attribute value.
    
    Returns:
    
    The new version of this object with the new attribute.
  - withBody
```
Http.Request withBody(Http.RequestBody body)
```
    Attach a body to this header.
    
    Parameters:
    
    body - The body to attach.
    
    Returns:
    
    A new request with the body attached to the header.
  - host
```
String host()
```
    The request host.
    
    Returns:
    
    the host
  - path
```
String path()
```
    The URI path.
    
    Returns:
    
    the path
  - acceptLanguages
```
List<Lang> acceptLanguages()
```
    The Request Langs extracted from the Accept-Language header and sorted by preference (preferred first).
    
    Returns:
    
    the preference-ordered list of languages accepted by the client
  - acceptedTypes
```
List<play.api.http.MediaRange> acceptedTypes()
```
    Returns:
    
    The media types set in the request Accept header, sorted by preference (preferred first)
  - accepts
```
boolean accepts(String mimeType)
```
    Check if this request accepts a given media type.
    
    Parameters:
    
    mimeType - the mimeType to check for support.
    
    Returns:
    
    true if mimeType is in the Accept header, otherwise false
  - queryString
```
Map<String,String[]> queryString()
```
    The query string content.
    
    Returns:
    
    the query string map
  - getQueryString
```
String getQueryString(String key)
```
    Helper method to access a queryString parameter.
    
    Parameters:
    
    key - the query string parameter to look up
    
    Returns:
    
    the value for the provided key.
  - cookies
```
Http.Cookies cookies()
```
    Returns:
    
    the request cookies
  - cookie
```
Http.Cookie cookie(String name)
```
    Parameters:
    
    name - Name of the cookie to retrieve
    
    Returns:
    
    the cookie, if found, otherwise null
  - getHeaders
```
Http.Headers getHeaders()
```
    Retrieve all headers.
    
    Returns:
    
    the request headers for this request.
  - headers
```
@Deprecated
default Map<String,String[]> headers()
```
    Deprecated. Deprecated as of 2.6.0. Use getHeaders() instead.
    
    Retrieves all headers.
    
    Returns:
    
    a map of of header name to headers with case-insensitive keys
  - getHeader
```
@Deprecated
default String getHeader(String headerName)
```
    Deprecated. Deprecated as of 2.6.0. Use header(String) ()} instead.
    
    Retrieves a single header.
    
    Parameters:
    
    headerName - The name of the header (case-insensitive)
    
    Returns:
    
    the value corresponding to headerName, or null if it was not present
  - header
```
default Optional<String> header(String headerName)
```
    Retrieves a single header.
    
    Parameters:
    
    headerName - The name of the header (case-insensitive)
    
    Returns:
    
    the value corresponding to headerName, or empty if it was not present
  - hasHeader
```
default boolean hasHeader(String headerName)
```
    Checks if the request has the header.
    
    Parameters:
    
    headerName - The name of the header (case-insensitive)
    
    Returns:
    
    true if the request did contain the header.
  - hasBody
```
boolean hasBody()
```
    Checks if the request has a body.
    
    Returns:
    
    true if request has a body, false otherwise.
  - contentType
```
Optional<String> contentType()
```
    Get the content type of the request.
    
    Returns:
    
    The request content type excluding the charset, if it exists.
  - charset
```
Optional<String> charset()
```
    Get the charset of the request.
    
    Returns:
    
    The request charset, which comes from the content type header, if it exists.
  - clientCertificateChain
```
Optional<List<X509Certificate>> clientCertificateChain()
```
    The X509 certificate chain presented by a client during SSL requests.
    
    Returns:
    
    The chain of X509Certificates used for the request if the request is secure and the server supports it.
  - tags
```
@Deprecated
Map<String,String> tags()
```
    Deprecated. Use attr, withAttr, etc.
    
    Returns:
    
    the tags for the request
  - _underlyingHeader
```
@Deprecated
play.api.mvc.RequestHeader _underlyingHeader()
```
    Deprecated. As of release 2.6.0. Use asScala()
    
    For internal Play-use only
    
    Returns:
    
    the underlying request
  - asScala
```
play.api.mvc.RequestHeader asScala()
```
    Return the Scala version of the request header.
    
    Returns:
    
    the Scala version for this request header.
    
    See Also:
    
    RequestHeader

Interface Http.RequestHeader

Method Summary

Method Detail

uri

method

version

remoteAddress

secure

attrs

withAttrs

addAttr

withBody

host

path

acceptLanguages

acceptedTypes

accepts

queryString

getQueryString

cookies

cookie

getHeaders

headers

getHeader

header

hasHeader

hasBody

contentType

charset

clientCertificateChain

tags

_underlyingHeader

asScala