Response

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

Representation of the HTTP response to send back to the client

Value Params
attributes

io.chrisdavenport.vault.Vault containing additional parameters which may be used by the http4s backend for additional processing such as java.io.File object

body

EntityBody[F] representing the possible body of the response

headers

Headers containing all response headers

status

Status code and message

Companion
object
trait Serializable
trait Product
trait Equals
trait Message[F]
trait Media[F]
class Object
trait Matchable
class Any

Type members

Types

type SelfF[F0[_]] = Response[F0]

Inherited types

type Self = SelfF[F]
Inherited from
Message

Value members

Concrete methods

Add a Set-Cookie header for the provided ResponseCookie

Add a Set-Cookie header for the provided ResponseCookie

def addCookie(name: String, content: String, expires: Option[HttpDate]): Response[F]

Add a org.http4s.headers.Set-Cookie header with the provided values

Add a org.http4s.headers.Set-Cookie header with the provided values

def canEqual(that: Any): Boolean

Returns a list of cookies from the org.http4s.headers.Set-Cookie headers. Includes expired cookies, such as those that represent cookie deletion.

Returns a list of cookies from the org.http4s.headers.Set-Cookie headers. Includes expired cookies, such as those that represent cookie deletion.

def copy(status: Status, httpVersion: HttpVersion, headers: Headers, body: EntityBody[F], attributes: Vault): Response[F]
override def hashCode(): Int
Definition Classes
Any
def mapK[G[_]](f: FunctionK[F, G]): Response[G]
def productArity: Int
def productElement(n: Int): Any

Add a org.http4s.headers.Set-Cookie which will remove the specified cookie from the client

Add a org.http4s.headers.Set-Cookie which will remove the specified cookie from the client

def removeCookie(name: String): Response[F]

Add a org.http4s.headers.Set-Cookie which will remove the specified cookie from the client

Add a org.http4s.headers.Set-Cookie which will remove the specified cookie from the client

A projection of this response without the body.

A projection of this response without the body.

override def toString: String
Definition Classes
Any
def withStatus(status: Status): Response[F]

Inherited methods

def addHeader[H](h: H)(implicit evidence$1: Header[H, Recurring]): Self

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 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/*)))

////*/

Inherited from
Message
final def as[A](implicit F: MonadThrow[F], 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

Type Params
A

type of the result

Value Params
decoder

EntityDecoder used to decode the Media

Returns

the effect which will generate the A

Inherited from
Media
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

Type Params
T

type of the result

Value Params
decoder

EntityDecoder used to decode the Media

Returns

the effect which will generate the DecodeResult[T]

Inherited from
Media
final def bodyText(implicit RT: RaiseThrowable[F], defaultCharset: Charset): Stream[F, String]
Inherited from
Media
final def charset: Option[Charset]
Inherited from
Media
final def contentLength: Option[Long]
Inherited from
Media
final def contentType: Option[Content-Type]
Inherited from
Media
override def covary[F2[x]]: Response[F2]

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

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

Definition Classes
Inherited from
Message
def filterHeaders(f: Raw => Boolean): Self

Keep headers that satisfy the predicate

Keep headers that satisfy the predicate

Value Params
f

predicate

Returns

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

Inherited from
Message
def isChunked: Boolean
Inherited from
Message
def productElementName(n: Int): String
Inherited from
Product
def productElementNames: Iterator[String]
Inherited from
Product
def productIterator: Iterator[Any]
Inherited from
Product
def productPrefix: String
Inherited from
Product
def putHeaders(headers: ToRaw*): Self

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 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/*)))

////

Inherited from
Message
def removeHeader[A](implicit h: Header[A, _]): Self
Inherited from
Message
def removeHeader(key: CIString): Self
Inherited from
Message
def trailerHeaders(implicit F: Applicative[F]): F[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.

Inherited from
Message
Inherited from
Message
def withAttribute[A](key: Key[A], value: A): Self

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.

Type Params
A

type of the value to store

Value Params
key

io.chrisdavenport.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
def withAttributes(attributes: Vault): Self
Inherited from
Message

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.

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.

Inherited from
Message
def withContentType(contentType: Content-Type): Self
Inherited from
Message
def withContentTypeOption(contentTypeO: Option[Content-Type]): Self
Inherited from
Message

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.

Inherited from
Message
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

Type Params
T

type of the Body

Value Params
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

Inherited from
Message
def withHeaders(headers: ToRaw*): Self
Inherited from
Message
def withHeaders(headers: Headers): Self
Inherited from
Message
def withHttpVersion(httpVersion: HttpVersion): Self
Inherited from
Message
def withTrailerHeaders(trailerHeaders: F[Headers]): Self
Inherited from
Message
def withoutAttribute(key: Key[_]): Self

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

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

Value Params
key

io.chrisdavenport.vault.Key to remove

Returns

a new message object without the key

Inherited from
Message
Inherited from
Message

Concrete fields

val attributes: Vault
val body: EntityBody[F]