Packages

trait RequestHeader extends AnyRef

The HTTP request header. Note that it doesn't contain the request body yet.

Self Type
RequestHeader
Annotations
@implicitNotFound()
Source
RequestHeader.scala
Linear Supertypes
AnyRef, Any
Known Subclasses
MessagesRequest, MessagesRequestHeader, Request, AuthenticatedRequest, WrappedRequest, FakeRequest
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. RequestHeader
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Abstract Value Members

  1. abstract def attrs: TypedMap

    A map of typed attributes associated with the request.

  2. abstract def connection: RemoteConnection

    The remote connection that made the request.

  3. abstract def headers: Headers

    The HTTP headers.

  4. abstract def method: String

    The HTTP method.

  5. abstract def target: RequestTarget

    The target of the HTTP request, i.e.

    The target of the HTTP request, i.e. the URI or path that was given on the first line of the request.

  6. abstract def version: String

    The HTTP version.

Concrete Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. lazy val acceptLanguages: Seq[Lang]

    The Request Langs extracted from the Accept-Language header and sorted by preference (preferred first).

  5. lazy val acceptedTypes: Seq[MediaRange]

    returns

    The media types list of the request’s Accept header, sorted by preference (preferred first).

  6. def accepts(mimeType: String): Boolean

    Check if this request accepts a given media type.

    Check if this request accepts a given media type.

    returns

    true if mimeType matches the Accept header, otherwise false

  7. def addAttr[A](key: TypedKey[A], value: A): RequestHeader

    Create a new versions of this object with the given attribute attached to it.

    Create a new versions of this object with the given attribute attached to it.

    A

    The type of value.

    key

    The new attribute key.

    value

    The attribute value.

    returns

    The new version of this object with the new attribute.

  8. def addAttrs(entries: TypedEntry[_]*): RequestHeader

    Create a new versions of this object with the given attributes attached to it.

    Create a new versions of this object with the given attributes attached to it.

    entries

    The new attributes.

    returns

    The new version of this object with the new attributes.

  9. def addAttrs(e1: TypedEntry[_], e2: TypedEntry[_], e3: TypedEntry[_]): RequestHeader

    Create a new versions of this object with the given attributes attached to it.

    Create a new versions of this object with the given attributes attached to it.

    e1

    The first new attribute.

    e2

    The second new attribute.

    e3

    The third new attribute.

    returns

    The new version of this object with the new attributes.

  10. def addAttrs(e1: TypedEntry[_], e2: TypedEntry[_]): RequestHeader

    Create a new versions of this object with the given attributes attached to it.

    Create a new versions of this object with the given attributes attached to it.

    e1

    The first new attribute.

    e2

    The second new attribute.

    returns

    The new version of this object with the new attributes.

  11. def addAttrs(e1: TypedEntry[_]): RequestHeader

    Create a new versions of this object with the given attribute attached to it.

    Create a new versions of this object with the given attribute attached to it.

    e1

    The new attribute.

    returns

    The new version of this object with the new attribute.

  12. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  13. def asJava: mvc.Http.RequestHeader
  14. lazy val charset: Option[String]

    Returns the charset of the request for text-based body

  15. final def clientCertificateChain: Option[Seq[X509Certificate]]

    The X509 certificate chain presented by a client during SSL requests.

    The X509 certificate chain presented by a client during SSL requests. This method is equivalent to connection.clientCertificateChain.

  16. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  17. lazy val contentType: Option[String]

    Returns the value of the Content-Type header (without the parameters (eg charset))

  18. def cookies: Cookies

    The HTTP cookies.

    The HTTP cookies. The request's cookies are stored in an attribute indexed by play.api.mvc.request.RequestAttrKey.Cookies. The attribute uses a Cell to store the cookies, to allow them to be evaluated on-demand.

  19. lazy val domain: String

    The HTTP domain.

    The HTTP domain. The domain part of the request's host.

  20. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  21. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  22. def flash: Flash

    Parses the Flash cookie and returns the Flash data.

    Parses the Flash cookie and returns the Flash data. The request's flash cookie is stored in an attribute indexed by play.api.mvc.request.RequestAttrKey.Flash. The attribute uses a play.api.mvc.request.Cell to store the flash, to allow it to be evaluated on-demand.

  23. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  24. def getQueryString(key: String): Option[String]

    Helper method to access a queryString parameter.

    Helper method to access a queryString parameter. This method delegates to connection.getQueryParameter(key).

    returns

    The query parameter's value if the parameter is present and there is only one value. If the parameter is absent or there is more than one value for that parameter then None is returned.

  25. def hasBody: Boolean

    True if this request has a body, so we know if we should trigger body parsing.

    True if this request has a body, so we know if we should trigger body parsing. The base implementation simply checks for the Content-Length or Transfer-Encoding headers, but subclasses (such as fake requests) may return true in other cases so the headers need not be updated to reflect the body.

  26. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  27. lazy val host: String

    The HTTP host (domain, optionally port).

    The HTTP host (domain, optionally port). This value is derived from the request target, if a hostname is present. If the target doesn't have a host then the Host header is used, if present. If that's not present then an empty string is returned.

  28. final def id: Long

    The request id.

    The request id. The request id is stored as an attribute indexed by play.api.mvc.request.RequestAttrKey.Id.

  29. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  30. lazy val mediaType: Option[MediaType]

    The media type of this request.

    The media type of this request. Same as contentType, except returns a fully parsed media type with parameters.

  31. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  32. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  33. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  34. final def path: String

    The URI path.

    The URI path. This method delegates to target.path.

  35. final def queryString: Map[String, Seq[String]]

    The parsed query string.

    The parsed query string. This method delegates to target.queryMap.

  36. def rawQueryString: String

    Returns the raw query string.

    Returns the raw query string. This method delegates to connection.rawQueryString.

  37. final def remoteAddress: String

    The client IP address.

    The client IP address.

    retrieves the last untrusted proxy from the Forwarded-Headers or the X-Forwarded-*-Headers.

    This method delegates to connection.remoteAddressString.

  38. def removeAttr(key: TypedKey[_]): RequestHeader

    Create a new versions of this object with the given attribute removed.

    Create a new versions of this object with the given attribute removed.

    key

    The key of the attribute to remove.

    returns

    The new version of this object with the attribute removed.

  39. final def secure: Boolean

    Is the client using SSL? This method delegates to connection.secure.

  40. def session: Session

    Parses the Session cookie and returns the Session data.

    Parses the Session cookie and returns the Session data. The request's session cookie is stored in an attribute indexed by play.api.mvc.request.RequestAttrKey.Session. The attribute uses a play.api.mvc.request.Cell to store the session cookie, to allow it to be evaluated on-demand.

  41. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  42. def toString(): String
    Definition Classes
    RequestHeader → AnyRef → Any
  43. def transientLang(): Option[Lang]

    The transient language will be taken into account when using play.api.i18n.MessagesApi.preferred() (It will take precedence over any other language).

    The transient language will be taken into account when using play.api.i18n.MessagesApi.preferred() (It will take precedence over any other language).

    returns

    The current transient language of this request.

  44. final def uri: String

    The complete request URI, containing both path and query string.

    The complete request URI, containing both path and query string. The URI is what was on the status line after the request method. E.g. in "GET /foo/bar?q=s HTTP/1.1" the URI should be /foo/bar?q=s. It could be absolute, some clients send absolute URLs, especially proxies, e.g. http://www.example.org/foo/bar?q=s.

    This method delegates to target.uriString.

  45. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  46. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  47. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  48. def withAttrs(newAttrs: TypedMap): RequestHeader

    Create a new version of this object with the given attributes attached to it.

    Create a new version of this object with the given attributes attached to it. This replaces any existing attributes.

    newAttrs

    The new attributes to add.

    returns

    The new version of this object with the attributes attached.

  49. def withBody[A](body: A): Request[A]

    Attach a body to this header.

    Attach a body to this header.

    A

    The type of the body.

    body

    The body to attach.

    returns

    A new request with the body attached to the header.

  50. def withConnection(newConnection: RemoteConnection): RequestHeader
  51. def withHeaders(newHeaders: Headers): RequestHeader

    The remote connection that made the request.

  52. def withMethod(newMethod: String): RequestHeader

    Return a new copy of the request with its method changed.

  53. def withTarget(newTarget: RequestTarget): RequestHeader

    Return a new copy of the request with its target changed.

  54. def withTransientLang(locale: Locale): RequestHeader

    Create a new versions of this object with the given transient language set.

    Create a new versions of this object with the given transient language set. The transient language will be taken into account when using play.api.i18n.MessagesApi.preferred() (It will take precedence over any other language).

    locale

    The language to use.

    returns

    The new version of this object with the given transient language set.

  55. def withTransientLang(code: String): RequestHeader

    Create a new versions of this object with the given transient language set.

    Create a new versions of this object with the given transient language set. The transient language will be taken into account when using play.api.i18n.MessagesApi.preferred() (It will take precedence over any other language).

    code

    The language to use.

    returns

    The new version of this object with the given transient language set.

  56. def withTransientLang(lang: Lang): RequestHeader

    Create a new versions of this object with the given transient language set.

    Create a new versions of this object with the given transient language set. The transient language will be taken into account when using play.api.i18n.MessagesApi.preferred() (It will take precedence over any other language).

    lang

    The language to use.

    returns

    The new version of this object with the given transient language set.

  57. def withVersion(newVersion: String): RequestHeader

    Return a new copy of the request with its HTTP version changed.

  58. def withoutTransientLang(): RequestHeader

    Create a new versions of this object with the given transient language removed.

    Create a new versions of this object with the given transient language removed.

    returns

    The new version of this object with the transient language removed.

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

Inherited from AnyRef

Inherited from Any

Ungrouped