Request

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

Add a Cookie header with the provided values

cURL representation of the request.

Supported cURL-Parameters are: -X, -H

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.

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.

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.

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

Whether the Request was received over a secure medium

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=====

<table> <tr><th>Query String</th><th>Map</th></tr> <tr><td><code>?param=v</code></td><td><code>Map("param" -> Seq("v"))</code></td></tr> <tr><td><code>?param=</code></td><td><code>Map("param" -> Seq(""))</code></td></tr> <tr><td><code>?param</code></td><td><code>Map("param" -> Seq())</code></td></tr> <tr><td><code>?=value</code></td><td><code>Map("" -> Seq("value"))</code></td></tr> <tr><td><code>?p1=v1&amp;p1=v2&amp;p2=v3&amp;p2=v3</code></td><td><code>Map("p1" -> Seq("v1","v2"), "p2" -> Seq("v3","v4"))</code></td></tr> </table>

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

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.

A projection of this request without the body.

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 cats.effect.IO
>>> import org.http4s.headers.Accept

>>> val req = Request[IO]().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/*)))

////*/

Decode the Media to the specified type

If no valid Status has been described, allow Ok

Decode the Media to the specified type

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

Keep headers that satisfy the predicate

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

>>> import cats.effect.IO
>>> import org.http4s.headers.Accept

>>> val req = Request[IO]().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/*)))

////

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.

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

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.

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

Replace the body of this message with a new body

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