Request

org.http4s.Request
See theRequest companion object
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.

Attributes

attributes

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

entity

Entity defining the body of the request

headers

collection of Headers

httpVersion

the HTTP version

method

Method.GET, Method.POST, etc.

uri

representation of the request URI

Companion:
object
Source:
Message.scala
Graph
Supertypes
trait Product
trait Equals
trait Message[F]
trait Media[F]
class Object
trait Matchable
class Any

Members list

Concise view

Type members

Types

type SelfF[F0[_]] = Request[F0]

Attributes

Source:
Message.scala

Value members

Concrete methods

Add a Cookie header for the provided org.http4s.headers.Cookie

Add a Cookie header for the provided org.http4s.headers.Cookie

Attributes

Source:
Message.scala

Add a Cookie header with the provided values

Add a Cookie header with the provided values

Attributes

Source:
Message.scala

cURL representation of the request.

cURL representation of the request.

Supported cURL-Parameters are: --request, --url, --header. Note that asCurl will not print the request body.

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala
def canEqual(that: Any): Boolean

Attributes

Source:
Message.scala

Parses all available org.http4s.headers.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.

Parses all available org.http4s.headers.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.

Attributes

Source:
Message.scala
def decode[F2[x], A](f: A => F2[Response[F2]])(implicit F: Monad[F2], decoder: EntityDecoder[F2, A]): F2[Response[F2]]

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.

Attributes

Source:
Message.scala
def decodeStrict[F2[x], A](f: A => F2[Response[F2]])(implicit F: Monad[F2], decoder: EntityDecoder[F2, A]): F2[Response[F2]]

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.

Attributes

Source:
Message.scala
def decodeWith[F2[x], A](decoder: EntityDecoder[F2, A], strict: Boolean)(f: A => F2[Response[F2]])(implicit F: Monad[F2]): F2[Response[F2]]

Attributes

Source:
Message.scala

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

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

Attributes

Source:
Message.scala

Checks whether the Entity of the Message is pure in the sense of indicating that the entity body can be re-run without side effects.

Checks whether the Entity of the Message is pure in the sense of indicating that the entity body can be re-run without side effects.

Attributes

Returns:

the Boolean value: 'true' if entity is empty or already loaded into memory; 'false' if entity is streamed.

Source:
Message.scala
override def hashCode(): Int

Calculate a hash code value for the object.

Calculate a hash code value for the object.

The default hashing algorithm is platform dependent.

Note that it is allowed for two objects to have identical hash codes (o1.hashCode.equals(o2.hashCode)) yet not be equal (o1.equals(o2) returns false). A degenerate implementation could always return 0. However, it is required that if two objects are equal (o1.equals(o2) returns true) that they have identical hash codes (o1.hashCode.equals(o2.hashCode)). Therefore, when overriding this method, be sure to verify that the behavior is consistent with the equals method.

Attributes

Returns:

the hash code value for this object.

Definition Classes
Any
Source:
Message.scala

A request is idempotent if its method is idempotent or it contains an Idempotency-Key header.

A request is idempotent if its method is idempotent or it contains an Idempotency-Key header.

Attributes

Source:
Message.scala

Whether the Request was received over a secure medium

Whether the Request was received over a secure medium

Attributes

Source:
Message.scala

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 list will be empty. If the value is empty the the list contains an empty string.

=====Examples=====

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

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

Attributes

Source:
Message.scala

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.

Attributes

See also:

multiParams

Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala
def productElement(n: Int): Any

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala
def remoteHost[F1[x]](implicit F: Monad[F1], dns: Dns[F1]): F1[Option[Hostname]]

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

A projection of this request without the body.

A projection of this request without the body.

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala
override def toString: String

Returns a string representation of the object.

Returns a string representation of the object.

The default representation is platform dependent.

Attributes

Returns:

a string representation of the object.

Definition Classes
Any
Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

Deprecated methods

Attributes

Deprecated
[Since version 0.22.0-M1] Use {withPathInfo(Uri.Path)} instead
Source:
Message.scala

Inherited methods

def addHeader[H : ([H] =>> Header[H, Recurring])](h: H): SelfF[F]

Add a header to these headers. The header should be a type with a recurring Header instance to ensure that the new value can be appended to any existing values.

Add a header to these headers. The header should be a type with a recurring Header instance to ensure that the new value can be appended to any existing values.

>>> import org.http4s.headers.Accept

>>> val req = Request().addHeader(Accept(MediaRange.`application/*`))
>>> req.headers.get[Accept]
Some(Accept(NonEmptyList(application/*)))

>>> val req2 = req.addHeader(Accept(MediaRange.`text/*`))
>>> req2.headers.get[Accept]
Some(Accept(NonEmptyList(application/*, text/*)))

////*/

Attributes

Inherited from:
Message
Source:
Message.scala
final def body: EntityBody[F]

Attributes

Inherited from:
Media
Source:
Media.scala
final def bodyText[F2[x]](implicit RT: RaiseThrowable[F2], defaultCharset: Charset): Stream[F2, String]

Attributes

Inherited from:
Media
Source:
Media.scala
final def charset: Option[Charset]

Attributes

Inherited from:
Media
Source:
Media.scala

Attributes

Inherited from:
Media
Source:
Media.scala

Attributes

Inherited from:
Media
Source:
Media.scala
override def covary[F2[x]]: SelfF[F2]

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

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

Attributes

Definition Classes
Inherited from:
Message
Source:
Message.scala

Keep headers that satisfy the predicate

Keep headers that satisfy the predicate

Attributes

f

predicate

Returns:

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

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala
def mapK[F2[x], G[_]](f: FunctionK[F2, G]): SelfF[G]

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Product

Attributes

Inherited from:
Product

Attributes

Inherited from:
Product

Attributes

Inherited from:
Product

Add the provided headers to the existing headers, replacing those of the same header name

Add the provided headers to the existing headers, replacing those of the same header name

>>> import org.http4s.headers.Accept

>>> val req = Request().putHeaders(Accept(MediaRange.`application/*`))
>>> req.headers.get[Accept]
Some(Accept(NonEmptyList(application/*)))

>>> val req2 = req.putHeaders(Accept(MediaRange.`text/*`))
>>> req2.headers.get[Accept]
Some(Accept(NonEmptyList(text/*)))

////

Attributes

Inherited from:
Message
Source:
Message.scala
def removeHeader[A](implicit h: Header[A, _]): SelfF[F]

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala
def toStrict[F1[x]](maxBytes: Option[Long])(implicit F: Concurrent[F1]): F1[SelfF[Pure]]

Compiles the body stream to a single chunk and sets it as the body. Replaces any Transfer-Encoding: chunked with a Content-Length header. It is the caller's responsibility to assure there is enough memory to materialize the entity body and control the time limits of that materialization.

Compiles the body stream to a single chunk and sets it as the body. Replaces any Transfer-Encoding: chunked with a Content-Length header. It is the caller's responsibility to assure there is enough memory to materialize the entity body and control the time limits of that materialization.

Attributes

maxBytes

maximum length of the entity stream. If the stream exceeds the limit then processing fails with the Message.EntityStreamException. Pass the scala.None if you don't want to limit the entity body.

Inherited from:
Message
Source:
Message.scala
def trailerHeaders[F1[x]](implicit F: Applicative[F1]): F1[Headers]

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.

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.

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala
def withAttribute[A](key: Key[A], value: A): SelfF[F]

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

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

Attributes

A

type of the value to store

key

org.typelevel.vault.Key with which to associate the value

value

value associated with the key

Returns:

a new message object with the key/value pair appended

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

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

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

WARNING: this method does not modify the headers of the message, and as a consequence headers may be incoherent with the body.

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

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

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

Attributes

Inherited from:
Message
Source:
Message.scala
def withEntity[F1[x]](entity: Entity[F1]): SelfF[F1]

Attributes

Inherited from:
Message
Source:
Message.scala
def withEntity[F1[x], T](b: T)(implicit w: EntityEncoder[F1, T]): SelfF[F1]

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

Returns a new message object without the specified key in the attributes.

Returns a new message object without the specified key in the attributes.

Attributes

key

org.typelevel.vault.Key to remove

Returns:

a new message object without the key

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

Attributes

Inherited from:
Message
Source:
Message.scala

Concrete fields

Attributes

Source:
Message.scala
val entity: Entity[F]

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala

Attributes

Source:
Message.scala
val uri: Uri

Attributes

Source:
Message.scala