final case class Response[F[_]](status: Status = Status.Ok, httpVersion: HttpVersion = HttpVersion.`HTTP/1.1`, headers: Headers = Headers.empty, body: EntityBody[F] = EmptyBody, attributes: AttributeMap = AttributeMap.empty) extends Message[F] with ResponseOps[F] with Product with Serializable
Representation of the HTTP response to send back to the client
- status
Status code and message
- headers
Headers containing all response headers
- body
EntityBody[F] representing the possible body of the response
- attributes
AttributeMap containing additional parameters which may be used by the http4s backend for additional processing such as java.io.File object
- Source
- Message.scala
- Alphabetic
- By Inheritance
- Response
- Serializable
- Serializable
- Product
- Equals
- ResponseOps
- Message
- MessageOps
- AnyRef
- Any
- by any2stringadd
- by StringFormat
- by Ensuring
- by ArrowAssoc
- Hide All
- Show All
- Public
- All
Instance Constructors
-
new
Response(status: Status = Status.Ok, httpVersion: HttpVersion = HttpVersion.`HTTP/1.1`, headers: Headers = Headers.empty, body: EntityBody[F] = EmptyBody, attributes: AttributeMap = AttributeMap.empty)
- status
Status code and message
- headers
Headers containing all response headers
- body
EntityBody[F] representing the possible body of the response
- attributes
AttributeMap containing additional parameters which may be used by the http4s backend for additional processing such as java.io.File object
Type Members
-
type
Self = Response[F]
- Definition Classes
- Response → Message → MessageOps
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
- def +(other: String): String
- def ->[B](y: B): (Response[F], B)
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
addCookie(name: String, content: String, expires: Option[HttpDate] = None)(implicit F: Functor[F]): Self
Add a Set-Cookie header with the provided values
Add a Set-Cookie header with the provided values
- Definition Classes
- ResponseOps
-
final
def
addCookie(cookie: ResponseCookie)(implicit F: Functor[F]): Self
Add a Set-Cookie header for the provided Cookie
Add a Set-Cookie header for the provided Cookie
- Definition Classes
- ResponseOps
-
final
def
as[T](implicit F: FlatMap[F], decoder: EntityDecoder[F, T]): F[T]
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 T
- Definition Classes
- MessageOps
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
attemptAs[T](implicit F: FlatMap[F], decoder: EntityDecoder[F, T]): DecodeResult[F, T]
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
- Message → MessageOps
- val attributes: AttributeMap
- val body: EntityBody[F]
-
final
def
bodyAsText(implicit defaultCharset: Charset = DefaultCharset): Stream[F, String]
- Definition Classes
- Message
- def change(body: EntityBody[F], headers: Headers, attributes: AttributeMap): Self
-
def
charset: Option[Charset]
Returns the charset parameter of the
Content-Typeheader, if present.Returns the charset parameter of the
Content-Typeheader, if present. Does not introspect the body for media types that define a charset internally.- Definition Classes
- Message
-
def
clone(): AnyRef
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @native() @throws( ... )
-
def
contentLength: Option[Long]
- Definition Classes
- Message
-
def
contentType: Option[Content-Type]
- Definition Classes
- Message
-
def
cookies: List[ResponseCookie]
Returns a list of cookies from the org.http4s.headers.Set-Cookie headers.
Returns a list of cookies from the org.http4s.headers.Set-Cookie headers. Includes expired cookies, such as those that represent cookie deletion.
- def ensuring(cond: (Response[F]) ⇒ Boolean, msg: ⇒ Any): Response[F]
- def ensuring(cond: (Response[F]) ⇒ Boolean): Response[F]
- def ensuring(cond: Boolean, msg: ⇒ Any): Response[F]
- def ensuring(cond: Boolean): Response[F]
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
filterHeaders(f: (Header) ⇒ Boolean)(implicit F: Functor[F]): Self
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
-
def
finalize(): Unit
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
- def formatted(fmtstr: String): String
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- val headers: Headers
- val httpVersion: HttpVersion
-
def
isChunked: Boolean
- Definition Classes
- Message
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- def mapK[G[_]](f: ~>[F, G]): Response[G]
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
putHeaders(headers: Header*)(implicit F: Functor[F]): 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
- MessageOps
-
final
def
removeCookie(name: String)(implicit F: Functor[F]): Self
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
- Definition Classes
- ResponseOps
-
final
def
removeCookie(cookie: ResponseCookie)(implicit F: Functor[F]): Self
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
- Definition Classes
- ResponseOps
-
final
def
removeHeader(key: HeaderKey)(implicit F: Functor[F]): Self
- Definition Classes
- MessageOps
-
final
def
replaceAllHeaders(headers: Header*)(implicit F: Functor[F]): Self
Replace the existing headers with those provided
Replace the existing headers with those provided
- Definition Classes
- MessageOps
-
final
def
replaceAllHeaders(headers: Headers)(implicit F: Functor[F]): Self
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
- val status: Status
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- Response → AnyRef → Any
-
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 task might not complete unless the entire body has been consumed.
- Definition Classes
- Message
-
def
transformHeaders(f: (Headers) ⇒ Headers)(implicit F: Functor[F]): Self
- Definition Classes
- Message → MessageOps
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @native() @throws( ... )
-
def
withAttribute[A](key: AttributeKey[A], value: A)(implicit F: Functor[F]): Self
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
- Message → MessageOps
-
def
withAttribute[V](entry: AttributeEntry[V])(implicit F: Functor[F]): Self
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
-
def
withBodyStream(body: EntityBody[F]): Self
Sets the entity body without affecting headers such as
Transfer-EncodingorContent-Length.Sets the entity body without affecting headers such as
Transfer-EncodingorContent-Length. Most use cases are better served by withEntity, which uses an EntityEncoder to maintain the headers. -
final
def
withContentType(contentType: Content-Type)(implicit F: Functor[F]): Self
- Definition Classes
- MessageOps
-
final
def
withContentTypeOption(contentTypeO: Option[Content-Type])(implicit F: Functor[F]): Self
- Definition Classes
- MessageOps
-
def
withEmptyBody(implicit F: Functor[F]): 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
-
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
-
def
withStatus(status: Status)(implicit F: Functor[F]): Self
Change the status of this response object
Change the status of this response object
- status
value to replace on the response object
- returns
a new response object with the new status code
- Definition Classes
- Response → ResponseOps
-
final
def
withTrailerHeaders(trailerHeaders: F[Headers])(implicit F: Functor[F]): Self
- Definition Classes
- MessageOps
-
final
def
withType(t: MediaType)(implicit F: Functor[F]): Self
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
-
final
def
withoutContentType(implicit F: Functor[F]): Self
- Definition Classes
- MessageOps
- def →[B](y: B): (Response[F], B)
Deprecated Value Members
-
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