Packages

final class Request[F[_]] extends Message[F] with Product with Serializable

Representation of an incoming HTTP message

A Request encapsulates the entirety of the incoming HTTP request including the status line, headers, and a possible request body.

Source
Message.scala
Linear Supertypes
Serializable, Serializable, Product, Equals, Message[F], Media[F], AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Request
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. Message
  7. Media
  8. AnyRef
  9. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new Request(method: Method = Method.GET, uri: Uri = Uri(path = "/"), httpVersion: HttpVersion = HttpVersion.`HTTP/1.1`, headers: Headers = Headers.empty, body: EntityBody[F] = EmptyBody, attributes: Vault = Vault.empty)

    method

    Method.GET, Method.POST, etc.

    uri

    representation of the request URI

    httpVersion

    the HTTP version

    headers

    collection of Headers

    body

    fs2.Stream[F, Byte] defining the body of the request

    attributes

    Immutable Map used for carrying additional information in a type safe fashion

Type Members

  1. type Self = SelfF[F]
    Definition Classes
    Message
  2. type SelfF[F0[_]] = Request[F0]
    Definition Classes
    RequestMessage

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from Request[F] to any2stringadd[Request[F]] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (Request[F], B)
    Implicit
    This member is added by an implicit conversion from Request[F] to ArrowAssoc[Request[F]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. def addCookie(name: String, content: String): Self

    Add a Cookie header with the provided values

  7. def addCookie(cookie: RequestCookie): Self

    Add a Cookie header for the provided Cookie

  8. final def as[A](implicit F: MonadError[F, Throwable], decoder: EntityDecoder[F, A]): F[A]

    Decode the Media to the specified type

    Decode the Media to the specified type

    If no valid Status has been described, allow Ok

    A

    type of the result

    decoder

    EntityDecoder used to decode the Media

    returns

    the effect which will generate the A

    Definition Classes
    Media
  9. def asCurl(redactHeadersWhen: (CaseInsensitiveString) ⇒ Boolean = Headers.SensitiveHeaders.contains): String

    cURL representation of the request.

    cURL representation of the request.

    Supported cURL-Parameters are: -X, -H

  10. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  11. final def attemptAs[T](implicit decoder: EntityDecoder[F, T]): DecodeResult[F, T]

    Decode the Media to the specified type

    Decode the Media to the specified type

    T

    type of the result

    decoder

    EntityDecoder used to decode the Media

    returns

    the effect which will generate the DecodeResult[T]

    Definition Classes
    Media
  12. val attributes: Vault
    Definition Classes
    RequestMessage
  13. def authType: Option[AuthScheme]
  14. val body: EntityBody[F]
    Definition Classes
    RequestMessageMedia
  15. final def bodyAsText(implicit defaultCharset: Charset = DefaultCharset): Stream[F, String]
    Definition Classes
    Media
  16. def canEqual(that: Any): Boolean
    Definition Classes
    Request → Equals
  17. def change(httpVersion: HttpVersion, body: EntityBody[F], headers: Headers, attributes: Vault): Self
    Attributes
    protected
    Definition Classes
    RequestMessage
  18. final def charset: Option[Charset]
    Definition Classes
    Media
  19. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  20. final def contentLength: Option[Long]
    Definition Classes
    Media
  21. final def contentType: Option[Content-Type]
    Definition Classes
    Media
  22. def cookies: List[RequestCookie]

    Parses all available Cookie headers into a list of RequestCookie objects.

    Parses all available Cookie headers into a list of RequestCookie objects. This implementation is compatible with cookie headers formatted per HTTP/1 and HTTP/2, or even both at the same time.

  23. def covary[F2[x] >: F[x]]: SelfF[F2]

    Lifts this Message's body to the specified effect type.

    Lifts this Message's body to the specified effect type.

    Definition Classes
    MessageMedia
  24. def decode[A](f: (A) ⇒ F[Response[F]])(implicit F: Monad[F], decoder: EntityDecoder[F, A]): F[Response[F]]

    Helper method for decoding Requests

    Helper method for decoding Requests

    Attempt to decode the Request and, if successful, execute the continuation to get a Response. If decoding fails, an UnprocessableEntity Response is generated.

  25. def decodeStrict[A](f: (A) ⇒ F[Response[F]])(implicit F: Monad[F], decoder: EntityDecoder[F, A]): F[Response[F]]

    Helper method for decoding Requests

    Helper method for decoding Requests

    Attempt to decode the Request and, if successful, execute the continuation to get a Response. If decoding fails, an UnprocessableEntity Response is generated. If the decoder does not support the MediaType of the Request, a UnsupportedMediaType Response is generated instead.

  26. def decodeWith[A](decoder: EntityDecoder[F, A], strict: Boolean)(f: (A) ⇒ F[Response[F]])(implicit F: Monad[F]): F[Response[F]]
  27. def ensuring(cond: (Request[F]) ⇒ Boolean, msg: ⇒ Any): Request[F]
    Implicit
    This member is added by an implicit conversion from Request[F] to Ensuring[Request[F]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  28. def ensuring(cond: (Request[F]) ⇒ Boolean): Request[F]
    Implicit
    This member is added by an implicit conversion from Request[F] to Ensuring[Request[F]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  29. def ensuring(cond: Boolean, msg: ⇒ Any): Request[F]
    Implicit
    This member is added by an implicit conversion from Request[F] to Ensuring[Request[F]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  30. def ensuring(cond: Boolean): Request[F]
    Implicit
    This member is added by an implicit conversion from Request[F] to Ensuring[Request[F]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  31. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  32. def equals(that: Any): Boolean
    Definition Classes
    Request → Equals → AnyRef → Any
  33. def filterHeaders(f: (Header) ⇒ Boolean): Self

    Keep headers that satisfy the predicate

    Keep headers that satisfy the predicate

    f

    predicate

    returns

    a new message object which has only headers that satisfy the predicate

    Definition Classes
    Message
  34. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  35. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from Request[F] to StringFormat[Request[F]] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  36. def from: Option[InetAddress]

    Returns the the X-Forwarded-For value if present, else the remote address.

  37. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  38. def hashCode(): Int
    Definition Classes
    Request → AnyRef → Any
  39. val headers: Headers
    Definition Classes
    RequestMessageMedia
  40. val httpVersion: HttpVersion
    Definition Classes
    RequestMessage
  41. def isChunked: Boolean
    Definition Classes
    Message
  42. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  43. def isSecure: Option[Boolean]

    Whether the Request was received over a secure medium

  44. def mapK[G[_]](f: ~>[F, G]): Request[G]
  45. val method: Method
  46. def multiParams: Map[String, Seq[String]]

    Representation of the query string as a map

    Representation of the query string as a map

    In case a parameter is available in query string but no value is there the sequence will be empty. If the value is empty the the sequence contains an empty string.

    Examples

    Query StringMap
    ?param=vMap("param" -> Seq("v"))
    ?param=Map("param" -> Seq(""))
    ?paramMap("param" -> Seq())
    ?=valueMap("" -> Seq("value"))
    ?p1=v1&p1=v2&p2=v3&p2=v3Map("p1" -> Seq("v1","v2"), "p2" -> Seq("v3","v4"))

    The query string is lazily parsed. If an error occurs during parsing an empty Map is returned.

  47. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  48. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  49. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  50. def params: Map[String, String]

    View of the head elements of the URI parameters in query string.

    View of the head elements of the URI parameters in query string.

    In case a parameter has no value the map returns an empty string.

    See also

    multiParams

  51. lazy val pathInfo: String
  52. def pathTranslated: Option[File]
  53. def productArity: Int
    Definition Classes
    Request → Product
  54. def productElement(n: Int): Any
    Definition Classes
    Request → Product
  55. def productIterator: Iterator[Any]
    Definition Classes
    Product
  56. def productPrefix: String
    Definition Classes
    Product
  57. def putHeaders(headers: Header*): Self

    Add the provided headers to the existing headers, replacing those of the same header name The passed headers are assumed to contain no duplicate Singleton headers.

    Add the provided headers to the existing headers, replacing those of the same header name The passed headers are assumed to contain no duplicate Singleton headers.

    Definition Classes
    Message
  58. def queryString: String
  59. def remote: Option[InetSocketAddress]
  60. def remoteAddr: Option[String]
  61. def remoteHost: Option[String]
  62. def remotePort: Option[Int]
  63. def remoteUser: Option[String]
  64. def removeHeader(key: HeaderKey): Self
    Definition Classes
    Message
  65. lazy val scriptName: String
  66. def server: Option[InetSocketAddress]
  67. def serverAddr: String
  68. def serverPort: Int
  69. def serverSoftware: ServerSoftware
  70. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  71. def toString(): String
    Definition Classes
    Request → AnyRef → Any
  72. def trailerHeaders(implicit F: Applicative[F]): F[Headers]

    The trailer headers, as specified in Section 3.6.1 of RFC 2616.

    The trailer headers, as specified in Section 3.6.1 of RFC 2616. The resulting F might not complete until the entire body has been consumed.

    Definition Classes
    Message
  73. def transformHeaders(f: (Headers) ⇒ Headers): Self
    Definition Classes
    Message
  74. val uri: Uri
  75. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  76. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  77. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  78. def withAttribute[A](key: Key[A], value: A): Self

    Generates a new message object with the specified key/value pair appended to the AttributeMap

    Generates a new message object with the specified key/value pair appended to the AttributeMap

    A

    type of the value to store

    key

    Key with which to associate the value

    value

    value associated with the key

    returns

    a new message object with the key/value pair appended

    Definition Classes
    Message
  79. def withAttributes(attributes: Vault): Self
    Definition Classes
    Message
  80. def withBodyStream(body: EntityBody[F]): Self

    Sets the entity body without affecting headers such as Transfer-Encoding or Content-Length.

    Sets the entity body without affecting headers such as Transfer-Encoding or Content-Length. Most use cases are better served by withEntity, which uses an EntityEncoder to maintain the headers.

    Definition Classes
    Message
  81. def withContentType(contentType: Content-Type): Self
    Definition Classes
    Message
  82. def withContentTypeOption(contentTypeO: Option[Content-Type]): Self
    Definition Classes
    Message
  83. def withEmptyBody: Self

    Set an empty entity body on this message, and remove all payload headers that make no sense with an empty body.

    Set an empty entity body on this message, and remove all payload headers that make no sense with an empty body.

    Definition Classes
    Message
  84. def withEntity[T](b: T)(implicit w: EntityEncoder[F, T]): Self

    Replace the body of this message with a new body

    Replace the body of this message with a new body

    T

    type of the Body

    b

    body to attach to this method

    w

    EntityEncoder with which to convert the body to an EntityBody

    returns

    a new message with the new body

    Definition Classes
    Message
  85. def withHeaders(headers: Header*): Self
    Definition Classes
    Message
  86. def withHeaders(headers: Headers): Self
    Definition Classes
    Message
  87. def withHttpVersion(httpVersion: HttpVersion): Self
    Definition Classes
    Message
  88. def withMethod(method: Method): Self
  89. def withPathInfo(pi: String): Self
  90. def withTrailerHeaders(trailerHeaders: F[Headers]): Self
    Definition Classes
    Message
  91. def withUri(uri: Uri): Self
  92. def withoutAttribute(key: Key[_]): Self

    Returns a new message object without the specified key in the AttributeMap

    Returns a new message object without the specified key in the AttributeMap

    key

    Key to remove

    returns

    a new message object without the key

    Definition Classes
    Message
  93. def withoutContentType: Self
    Definition Classes
    Message
  94. def withoutTrailerHeaders: Self
    Definition Classes
    Message
  95. def [B](y: B): (Request[F], B)
    Implicit
    This member is added by an implicit conversion from Request[F] to ArrowAssoc[Request[F]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Deprecated Value Members

  1. def replaceAllHeaders(headers: Header*): Self

    Replace the existing headers with those provided

    Replace the existing headers with those provided

    Definition Classes
    Message
    Annotations
    @deprecated
    Deprecated

    (Since version 0.20.0-M2) Use withHeaders instead

  2. def replaceAllHeaders(headers: Headers): Self

    Replace the existing headers with those provided

    Replace the existing headers with those provided

    Definition Classes
    Message
    Annotations
    @deprecated
    Deprecated

    (Since version 0.20.0-M2) Use withHeaders instead

  3. def withBody[T](b: T)(implicit F: Applicative[F], w: EntityEncoder[F, T]): F[Self]
    Definition Classes
    Message
    Annotations
    @deprecated
    Deprecated

    (Since version 0.19) Use withEntity

  4. def withType(t: MediaType)(implicit F: Functor[F]): Self
    Definition Classes
    Message
    Annotations
    @deprecated
    Deprecated

    (Since version 0.20.0-M2) Use withContentType(Content-Type(t)) instead

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from Message[F]

Inherited from Media[F]

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from Request[F] to any2stringadd[Request[F]]

Inherited by implicit conversion StringFormat from Request[F] to StringFormat[Request[F]]

Inherited by implicit conversion Ensuring from Request[F] to Ensuring[Request[F]]

Inherited by implicit conversion ArrowAssoc from Request[F] to ArrowAssoc[Request[F]]

Ungrouped