Package io.helidon.webserver

Interface ResponseHeaders

All Superinterfaces:

Headers, Parameters

public interface ResponseHeaders
extends Headers

Extends Parameters interface by adding HTTP response headers oriented constants and convenient methods. Use constants located in Http.Header as standard header names.

Lifecycle

Headers can be muted until send to the client. It is also possible to register a 'before send' function which can made 'last minute mutation'.

Headers are send together with HTTP status code also automatically just before first chunk of response data is send.

See Also:

Http.Header

Method Summary

Modifier and Type	Method and Description
java.util.List<MediaType>	acceptPatches() Gets immutable list of supported patch document formats (header "Accept-Patch").
void	addAcceptPatches(MediaType... acceptableMediaTypes) Adds one or more acceptedTypes path document formats (header "Accept-Patch").
void	addCookie(SetCookie cookie) Adds Set-Cookie header specified in RFC6265.
void	addCookie(java.lang.String name, java.lang.String value) Adds Set-Cookie header based on RFC2616.
void	addCookie(java.lang.String name, java.lang.String value, java.time.Duration maxAge) Adds Set-Cookie header based on RFC6265 with Max-Age parameter.
void	beforeSend(java.util.function.Consumer<ResponseHeaders> headersConsumer) Register a Consumer which is executed just before headers are send.
java.util.OptionalLong	contentLength() Optionally gets the value of "Content-Length" header.
void	contentLength(long contentLength) Sets the value of "Content-Length" header.
java.util.Optional<MediaType>	contentType() Optionally gets the MIME type of the response body.
void	contentType(MediaType contentType) Sets the MIME type of the response body.
java.util.Optional<java.time.ZonedDateTime>	expires() Optionally gets the value of "Expires" header.
void	expires(java.time.Instant dateTime) Sets the value of "Expires" header.
void	expires(java.time.ZonedDateTime dateTime) Sets the value of "Expires" header.
java.util.Optional<java.time.ZonedDateTime>	lastModified() Optionally gets the value of "Last-Modified" header.
void	lastModified(java.time.Instant dateTime) Sets the value of "Last-Modified" header.
void	lastModified(java.time.ZonedDateTime dateTime) Sets the value of "Last-Modified" header.
java.util.Optional<java.net.URI>	location() Optionally gets the value of "Location" header.
void	location(java.net.URI location) Sets the value of "Location" header.
java.util.concurrent.CompletionStage<ResponseHeaders>	send() Send headers and status code to the client.
java.util.concurrent.CompletionStage<ResponseHeaders>	whenSend() Returns a completion stage which is completed when all headers are send to the client.

Methods inherited from interface io.helidon.common.http.Headers

all, value, values

Methods inherited from interface io.helidon.common.http.Parameters

add, add, addAll, computeIfAbsent, computeSingleIfAbsent, first, put, put, putAll, putIfAbsent, putIfAbsent, remove, toMap, toUnmodifiableParameters

Method Detail

acceptPatches

java.util.List<MediaType> acceptPatches()

Gets immutable list of supported patch document formats (header "Accept-Patch").

Method returns a copy of actual values.

Returns:

A list of supported media types for the patch.

addAcceptPatches

void addAcceptPatches(MediaType... acceptableMediaTypes)
               throws AlreadyCompletedException

Adds one or more acceptedTypes path document formats (header "Accept-Patch").

Parameters:

acceptableMediaTypes - media types to add.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

contentType

java.util.Optional<MediaType> contentType()

Optionally gets the MIME type of the response body.

Returns:

Media type of the content.

contentType

void contentType(MediaType contentType)
          throws AlreadyCompletedException

Sets the MIME type of the response body.

Parameters:

contentType - Media type of the content.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

contentLength

java.util.OptionalLong contentLength()

Optionally gets the value of "Content-Length" header.

Returns:

Length of the body in octets.

contentLength

void contentLength(long contentLength)
            throws AlreadyCompletedException

Sets the value of "Content-Length" header.

Parameters:

contentLength - Length of the body in octets.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

expires

java.util.Optional<java.time.ZonedDateTime> expires()

Optionally gets the value of "Expires" header.

Gives the date/time after which the response is considered stale.

Returns:

Expires header value.

expires

void expires(java.time.ZonedDateTime dateTime)
      throws AlreadyCompletedException

Sets the value of "Expires" header.

The date/time after which the response is considered stale.

Parameters:

dateTime - Expires date/time.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

expires

void expires(java.time.Instant dateTime)
      throws AlreadyCompletedException

Sets the value of "Expires" header.

The date/time after which the response is considered stale.

Parameters:

dateTime - Expires date/time.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

lastModified

java.util.Optional<java.time.ZonedDateTime> lastModified()

Optionally gets the value of "Last-Modified" header.

The last modified date for the requested object.

Returns:

Expires header value.

lastModified

void lastModified(java.time.ZonedDateTime dateTime)
           throws AlreadyCompletedException

Sets the value of "Last-Modified" header.

The last modified date for the requested object.

Parameters:

dateTime - Expires date/time.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

lastModified

void lastModified(java.time.Instant dateTime)
           throws AlreadyCompletedException

Sets the value of "Last-Modified" header.

The last modified date for the requested object

Parameters:

dateTime - Expires date/time.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

location

java.util.Optional<java.net.URI> location()

Optionally gets the value of "Location" header.

Used in redirection, or when a new resource has been created.

Returns:

Location header value.

location

void location(java.net.URI location)
       throws AlreadyCompletedException

Sets the value of "Location" header.

Used in redirection, or when a new resource has been created.

Parameters:

location - Location header value.

Throws:

AlreadyCompletedException - if headers were completed (sent to the client).

addCookie

void addCookie(java.lang.String name,
               java.lang.String value)
        throws AlreadyCompletedException,
               java.lang.NullPointerException

Adds Set-Cookie header based on RFC2616.

Parameters:

name - a name of the cookie.

value - a value of the cookie.

Throws:

java.lang.NullPointerException - if name parameter is null.

AlreadyCompletedException - if headers were completed (sent to the client).

addCookie

void addCookie(java.lang.String name,
               java.lang.String value,
               java.time.Duration maxAge)
        throws AlreadyCompletedException,
               java.lang.NullPointerException

Adds Set-Cookie header based on RFC6265 with Max-Age parameter.

Parameters:

name - a name of the cookie.

value - a value of the cookie.

maxAge - a Max-Age cookie parameter.

Throws:

java.lang.NullPointerException - if name parameter is null.

AlreadyCompletedException - if headers were completed (sent to the client).

addCookie

void addCookie(SetCookie cookie)
        throws java.lang.NullPointerException

Adds Set-Cookie header specified in RFC6265.

Parameters:

cookie - a cookie definition

Throws:

java.lang.NullPointerException - if cookie parameter is null

beforeSend

void beforeSend(java.util.function.Consumer<ResponseHeaders> headersConsumer)

Register a Consumer which is executed just before headers are send. Consumer can made 'last minute changes' in headers.

Sending of headers to the client is postponed after all registered consumers are finished.

There is no guarantied execution order.

Parameters:

headersConsumer - a consumer which will be executed just before headers are send.

whenSend

java.util.concurrent.CompletionStage<ResponseHeaders> whenSend()

Returns a completion stage which is completed when all headers are send to the client.

Returns:

a completion stage of the headers.

send

java.util.concurrent.CompletionStage<ResponseHeaders> send()

Send headers and status code to the client. This instance become immutable after that (all muting methods throws IllegalStateException).

It is non-blocking method returning a CompletionStage.

Returns:

a completion stage of sending tryProcess.