Class/Object

org.http4s

Request

Related Docs: object Request | package http4s

Permalink

sealed abstract case class Request[F[_]] extends Message[F] with RequestOps[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.

Linear Supertypes
Serializable, Serializable, Product, Equals, RequestOps[F], Message[F], MessageOps[F], AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Request
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. RequestOps
  7. Message
  8. MessageOps
  9. AnyRef
  10. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. type Self = Request[F]

    Permalink
    Definition Classes
    RequestMessageMessageOps

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def addCookie(name: String, content: String, expires: Option[HttpDate] = None)(implicit F: Functor[F]): Self

    Permalink

    Add a Cookie header with the provided values

    Add a Cookie header with the provided values

    Definition Classes
    RequestOps
  5. final def addCookie(cookie: Cookie)(implicit F: Functor[F]): Self

    Permalink

    Add a Cookie header for the provided Cookie

    Add a Cookie header for the provided Cookie

    Definition Classes
    RequestOps
  6. final def as[T](implicit F: FlatMap[F], decoder: EntityDecoder[F, T]): F[T]

    Permalink

    Decode the Message to the specified type

    Decode the Message to the specified type

    If no valid Status has been described, allow Ok

    T

    type of the result

    decoder

    EntityDecoder used to decode the Message

    returns

    the effect which will generate the T

    Definition Classes
    MessageOps
  7. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  8. def attemptAs[T](implicit F: FlatMap[F], decoder: EntityDecoder[F, T]): DecodeResult[F, T]

    Permalink

    Decode the Message to the specified type

    Decode the Message to the specified type

    T

    type of the result

    decoder

    EntityDecoder used to decode the Message

    returns

    the effect which will generate the DecodeResult[T]

    Definition Classes
    MessageMessageOps
  9. val attributes: AttributeMap

    Permalink

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

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

    Definition Classes
    RequestMessage
  10. lazy val authType: Option[AuthScheme]

    Permalink
  11. val body: EntityBody[F]

    Permalink

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

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

    Definition Classes
    RequestMessage
  12. final def bodyAsText(implicit defaultCharset: Charset = DefaultCharset): Stream[F, String]

    Permalink
    Definition Classes
    Message
  13. def change(body: EntityBody[F], headers: Headers, attributes: AttributeMap): Self

    Permalink
    Attributes
    protected
    Definition Classes
    RequestMessage
  14. def charset: Option[Charset]

    Permalink

    Returns the charset parameter of the Content-Type header, if present.

    Returns the charset parameter of the Content-Type header, if present. Does not introspect the body for media types that define a charset internally.

    Definition Classes
    Message
  15. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  16. def contentLength: Option[Long]

    Permalink
    Definition Classes
    Message
  17. def contentType: Option[Content-Type]

    Permalink
    Definition Classes
    Message
  18. final def decode[A](f: (A) ⇒ F[Response[F]])(implicit F: Monad[F], decoder: EntityDecoder[F, A]): F[Response[F]]

    Permalink

    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.

    Definition Classes
    RequestOps
  19. final def decodeStrict[A](f: (A) ⇒ F[Response[F]])(implicit F: Monad[F], decoder: EntityDecoder[F, A]): F[Response[F]]

    Permalink

    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.

    Definition Classes
    RequestOps
  20. def decodeWith[A](decoder: EntityDecoder[F, A], strict: Boolean)(f: (A) ⇒ F[Response[F]])(implicit F: Monad[F]): F[Response[F]]

    Permalink

    Like decode, but with an explicit decoder.

    Like decode, but with an explicit decoder.

    strict

    If strict, will return a Status.UnsupportedMediaType http Response if this message's MediaType is not supported by the provided decoder

    Definition Classes
    RequestRequestOps
  21. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  22. final def filterHeaders(f: (Header) ⇒ Boolean)(implicit F: Functor[F]): Self

    Permalink

    Remove headers that satisfy the predicate

    Remove headers that satisfy the predicate

    f

    predicate

    returns

    a new message object which lacks the specified headers

    Definition Classes
    MessageOps
  23. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  24. def from: Option[InetAddress]

    Permalink

    Returns the the forwardFor value if present, else the remote address.

  25. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  26. val headers: Headers

    Permalink

    collection of Headers

    collection of Headers

    Definition Classes
    RequestMessage
  27. val httpVersion: HttpVersion

    Permalink

    the HTTP version

    the HTTP version

    Definition Classes
    RequestMessage
  28. def isChunked: Boolean

    Permalink
    Definition Classes
    Message
  29. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  30. lazy val isSecure: Option[Boolean]

    Permalink

    Whether the Request was received over a secure medium

  31. val method: Method

    Permalink

    Method.GET, Method.POST, etc.

  32. def multiParams: Map[String, Seq[String]]

    Permalink

    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.

  33. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  34. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  35. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  36. def params: Map[String, String]

    Permalink

    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

  37. lazy val pathInfo: String

    Permalink
  38. lazy val pathTranslated: Option[File]

    Permalink
  39. final def putHeaders(headers: Header*)(implicit F: Functor[F]): Self

    Permalink

    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
    MessageOps
  40. def queryString: String

    Permalink
  41. lazy val remote: Option[InetSocketAddress]

    Permalink
  42. lazy val remoteAddr: Option[String]

    Permalink
  43. lazy val remoteHost: Option[String]

    Permalink
  44. lazy val remotePort: Option[Int]

    Permalink
  45. lazy val remoteUser: Option[String]

    Permalink
  46. final def removeHeader(key: HeaderKey)(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    MessageOps
  47. final def replaceAllHeaders(headers: Header*)(implicit F: Functor[F]): Self

    Permalink

    Replace the existing headers with those provided

    Replace the existing headers with those provided

    Definition Classes
    MessageOps
  48. final def replaceAllHeaders(headers: Headers)(implicit F: Functor[F]): Self

    Permalink

    Replaces the Headers of the incoming Request object

    Replaces the Headers of the incoming Request object

    headers

    Headers containing the desired headers

    returns

    a new Request object

    Definition Classes
    MessageOps
  49. lazy val scriptName: String

    Permalink
  50. lazy val server: Option[InetSocketAddress]

    Permalink
  51. lazy val serverAddr: String

    Permalink
  52. lazy val serverPort: Int

    Permalink
  53. def serverSoftware: ServerSoftware

    Permalink
  54. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  55. def toString(): String

    Permalink
    Definition Classes
    Request → AnyRef → Any
  56. def trailerHeaders(implicit F: Applicative[F]): F[Headers]

    Permalink

    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 task might not complete unless the entire body has been consumed.

    Definition Classes
    Message
  57. def transformHeaders(f: (Headers) ⇒ Headers)(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    MessageMessageOps
  58. val uri: Uri

    Permalink

    representation of the request URI

  59. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  60. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  61. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  62. def withAttribute[A](key: AttributeKey[A], value: A)(implicit F: Functor[F]): Self

    Permalink

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

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

    A

    type of the value to store

    key

    AttributeKey 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
    MessageMessageOps
  63. def withAttribute[V](entry: AttributeEntry[V])(implicit F: Functor[F]): Self

    Permalink

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

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

    V

    type of the value to store

    entry

    AttributeEntry entry to add

    returns

    a new message object with the key/value pair appended

    Definition Classes
    MessageOps
  64. def withAttributes(attributes: AttributeMap): Request[F]

    Permalink
  65. def withBody[T](b: T)(implicit F: Monad[F], w: EntityEncoder[F, T]): F[Self]

    Permalink

    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
  66. def withBodyStream(body: EntityBody[F]): Request[F]

    Permalink

    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 withBody, which uses an EntityEncoder to maintain the headers.

    Definition Classes
    RequestMessage
  67. final def withContentType(contentType: Content-Type)(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    MessageOps
  68. final def withContentTypeOption(contentTypeO: Option[Content-Type])(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    MessageOps
  69. def withEmptyBody(implicit F: Functor[F]): Self

    Permalink

    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
  70. def withHeaders(headers: Headers): Request[F]

    Permalink
  71. def withHttpVersion(httpVersion: HttpVersion): Request[F]

    Permalink
  72. def withMethod(method: Method): Request[F]

    Permalink
  73. def withPathInfo(pi: String)(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    RequestRequestOps
  74. final def withTrailerHeaders(trailerHeaders: F[Headers])(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    MessageOps
  75. final def withType(t: MediaType)(implicit F: Functor[F]): Self

    Permalink

    Added the org.http4s.headers.Content-Type header to the response

    Added the org.http4s.headers.Content-Type header to the response

    Definition Classes
    MessageOps
  76. def withUri(uri: Uri): Request[F]

    Permalink
  77. final def withoutContentType(implicit F: Functor[F]): Self

    Permalink
    Definition Classes
    MessageOps

Deprecated Value Members

  1. def copy(method: Method = this.method, uri: Uri = this.uri, httpVersion: HttpVersion = this.httpVersion, headers: Headers = this.headers, body: EntityBody[F] = this.body, attributes: AttributeMap = this.attributes): Request[F]

    Permalink
    Annotations
    @deprecated
    Deprecated

    (Since version 0.17.0-M3) Copy method is unsafe for setting path info. Use with... methods instead

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from RequestOps[F]

Inherited from Message[F]

Inherited from MessageOps[F]

Inherited from AnyRef

Inherited from Any

Ungrouped