io.servicetalk.http.api

Interface HttpResponse

All Superinterfaces:

HttpMetaData, HttpResponseMetaData

public interface HttpResponse
extends HttpResponseMetaData

An HTTP response. The payload is represented as a single Object.

Method Summary

Modifier and Type	Method and Description
default HttpResponse	addCookie(java.lang.CharSequence name, java.lang.CharSequence value) Adds a cookie with the specified name and value.
default HttpResponse	addCookie(HttpCookiePair cookie) Adds a cookie.
default HttpResponse	addHeader(java.lang.CharSequence name, java.lang.CharSequence value) Adds a new header with the specified name and value.
default HttpResponse	addHeaders(HttpHeaders headers) Adds all header names and values of headers object.
default HttpResponse	addSetCookie(java.lang.CharSequence name, java.lang.CharSequence value) Adds a set-cookie with the specified name and value.
default HttpResponse	addSetCookie(HttpSetCookie cookie) Adds a set-cookie.
default HttpResponse	addTrailer(java.lang.CharSequence name, java.lang.CharSequence value) Adds a new trailer with the specified name and value.
default HttpResponse	addTrailers(HttpHeaders trailers) Adds all trailer names and values of trailer object.
Buffer	payloadBody() Gets the underlying payload as a Buffer.
HttpResponse	payloadBody(Buffer payloadBody) Returns an HttpResponse with its underlying payload set to payloadBody.
default <T> T	payloadBody(HttpDeserializer<T> deserializer) Gets and deserializes the payload body.
<T> HttpResponse	payloadBody(T pojo, HttpSerializer<T> serializer) Returns an HttpResponse with its underlying payload set to the results of serialization of pojo.
default HttpResponse	setHeader(java.lang.CharSequence name, java.lang.CharSequence value) Sets a header with the specified name and value.
default HttpResponse	setHeaders(HttpHeaders headers) Clears the current header entries and copies all header entries of the specified headers object.
default HttpResponse	setTrailer(java.lang.CharSequence name, java.lang.CharSequence value) Sets a trailer with the specified name and value.
default HttpResponse	setTrailers(HttpHeaders trailers) Clears the current trailer entries and copies all trailer entries of the specified trailers object.
HttpResponse	status(HttpResponseStatus status) Set the status of this StreamingHttpResponse.
BlockingStreamingHttpResponse	toBlockingStreamingResponse() Translates this HttpResponse to a BlockingStreamingHttpResponse.
StreamingHttpResponse	toStreamingResponse() Translates this HttpResponse to a StreamingHttpResponse.
HttpHeaders	trailers() Gets the trailers.
HttpResponse	version(HttpProtocolVersion version) Set the protocol version of this HttpMetaData.

Methods inherited from interface io.servicetalk.http.api.HttpResponseMetaData

status

Methods inherited from interface io.servicetalk.http.api.HttpMetaData

headers, toString, toString, version

Method Detail

payloadBody

Buffer payloadBody()

Gets the underlying payload as a Buffer.

Returns:

The Buffer representation of the underlying payload.

payloadBody

default <T> T payloadBody(HttpDeserializer<T> deserializer)

Gets and deserializes the payload body.

Type Parameters:

T - The resulting type of the deserialization operation.

Parameters:

deserializer - The function that deserializes the underlying Object.

Returns:

The results of the deserialization operation.

payloadBody

HttpResponse payloadBody(Buffer payloadBody)

Returns an HttpResponse with its underlying payload set to payloadBody.

Parameters:

payloadBody - the underlying payload.

Returns:

this

payloadBody

<T> HttpResponse payloadBody(T pojo,
                             HttpSerializer<T> serializer)

Returns an HttpResponse with its underlying payload set to the results of serialization of pojo.

Type Parameters:

T - The type of object to serialize.

Parameters:

pojo - The object to serialize.

serializer - The HttpSerializer which converts pojo into bytes.

Returns:

this

toStreamingResponse

StreamingHttpResponse toStreamingResponse()

Translates this HttpResponse to a StreamingHttpResponse.

Returns:

a StreamingHttpResponse representation of this HttpResponse.

toBlockingStreamingResponse

BlockingStreamingHttpResponse toBlockingStreamingResponse()

Translates this HttpResponse to a BlockingStreamingHttpResponse.

Returns:

a BlockingStreamingHttpResponse representation of this HttpResponse.

version

HttpResponse version(HttpProtocolVersion version)

Description copied from interface: HttpMetaData

Set the protocol version of this HttpMetaData.

Specified by:

version in interface HttpMetaData

Specified by:

version in interface HttpResponseMetaData

Parameters:

version - the protocol version to set.

Returns:

this.

status

HttpResponse status(HttpResponseStatus status)

Description copied from interface: HttpResponseMetaData

Set the status of this StreamingHttpResponse.

Specified by:

status in interface HttpResponseMetaData

Parameters:

status - The HttpResponseStatus to set.

Returns:

this.

addHeader

default HttpResponse addHeader(java.lang.CharSequence name,
                               java.lang.CharSequence value)

Description copied from interface: HttpMetaData

Adds a new header with the specified name and value.

Specified by:

addHeader in interface HttpMetaData

Specified by:

addHeader in interface HttpResponseMetaData

Parameters:

name - the name of the header.

value - the value of the header.

Returns:

this.

addHeaders

default HttpResponse addHeaders(HttpHeaders headers)

Description copied from interface: HttpMetaData

Adds all header names and values of headers object.

Specified by:

addHeaders in interface HttpMetaData

Specified by:

addHeaders in interface HttpResponseMetaData

Parameters:

headers - the headers to add.

Returns:

this.

setHeader

default HttpResponse setHeader(java.lang.CharSequence name,
                               java.lang.CharSequence value)

Description copied from interface: HttpMetaData

Sets a header with the specified name and value. Any existing headers with the same name are overwritten.

Specified by:

setHeader in interface HttpMetaData

Specified by:

setHeader in interface HttpResponseMetaData

Parameters:

name - the name of the header.

value - the value of the header.

Returns:

this.

setHeaders

default HttpResponse setHeaders(HttpHeaders headers)

Description copied from interface: HttpMetaData

Clears the current header entries and copies all header entries of the specified headers object.

Specified by:

setHeaders in interface HttpMetaData

Specified by:

setHeaders in interface HttpResponseMetaData

Parameters:

headers - the headers object which contains new values.

Returns:

this.

addCookie

default HttpResponse addCookie(HttpCookiePair cookie)

Description copied from interface: HttpMetaData

Adds a cookie.

This may result in multiple HttpCookiePairs with same name.

Specified by:

addCookie in interface HttpMetaData

Specified by:

addCookie in interface HttpResponseMetaData

Parameters:

cookie - the cookie to add.

Returns:

this.

addCookie

default HttpResponse addCookie(java.lang.CharSequence name,
                               java.lang.CharSequence value)

Description copied from interface: HttpMetaData

Adds a cookie with the specified name and value.

This may result in multiple HttpSetCookies with same name. Added cookie will not be wrapped, not secure, and not HTTP-only, with no path, domain, expire date and maximum age.

Specified by:

addCookie in interface HttpMetaData

Specified by:

addCookie in interface HttpResponseMetaData

Parameters:

name - the name of the cookie.

value - the value of the cookie.

Returns:

this.

addSetCookie

default HttpResponse addSetCookie(HttpSetCookie cookie)

Description copied from interface: HttpMetaData

Adds a set-cookie.

This may result in multiple HttpSetCookies with same name.

Specified by:

addSetCookie in interface HttpMetaData

Specified by:

addSetCookie in interface HttpResponseMetaData

Parameters:

cookie - the cookie to add.

Returns:

this.

addSetCookie

default HttpResponse addSetCookie(java.lang.CharSequence name,
                                  java.lang.CharSequence value)

Description copied from interface: HttpMetaData

Adds a set-cookie with the specified name and value.

This may result in multiple HttpSetCookies with same name. Added cookie will not be wrapped, not secure, and not HTTP-only, with no path, domain, expire date and maximum age.

Specified by:

addSetCookie in interface HttpMetaData

Specified by:

addSetCookie in interface HttpResponseMetaData

Parameters:

name - the name of the cookie.

value - the value of the cookie.

Returns:

this.

addTrailer

default HttpResponse addTrailer(java.lang.CharSequence name,
                                java.lang.CharSequence value)

Adds a new trailer with the specified name and value.

Parameters:

name - the name of the trailer.

value - the value of the trailer.

Returns:

this.

addTrailers

default HttpResponse addTrailers(HttpHeaders trailers)

Adds all trailer names and values of trailer object.

Parameters:

trailers - the trailers to add.

Returns:

this.

setTrailer

default HttpResponse setTrailer(java.lang.CharSequence name,
                                java.lang.CharSequence value)

Sets a trailer with the specified name and value. Any existing trailers with the same name are overwritten.

Parameters:

name - the name of the trailer.

value - the value of the trailer.

Returns:

this.

setTrailers

default HttpResponse setTrailers(HttpHeaders trailers)

Clears the current trailer entries and copies all trailer entries of the specified trailers object.

Parameters:

trailers - the trailers object which contains new values.

Returns:

this.

trailers

HttpHeaders trailers()

Gets the trailers.

Returns:

the trailers.