Package io.helidon.webserver.spi

Interface BareResponse

All Superinterfaces:

io.helidon.common.reactive.Flow.Subscriber<ResponseChunk>

public interface BareResponse
extends io.helidon.common.reactive.Flow.Subscriber<ResponseChunk>

Bare (minimal) representation of HTTP Response. Used by WebServer implementations to invoke a Routing.

Method Summary

Modifier and Type	Method	Description
void	onComplete()	Response should be flushed and closed.
void	onError(java.lang.Throwable thr)	Response should be flushed and closed.
void	onNext(ResponseChunk data)	Provided ByteBuffer MUST be fully read during the method call.
void	onSubscribe(io.helidon.common.reactive.Flow.Subscription subscription)	Each response is subscribed up to a single publisher and AFTER writeStatusAndHeaders(Http.ResponseStatus, Map) method is called and returned.
long	requestId()	A unique correlation ID that is associated with this response and its associated request.
java.util.concurrent.CompletionStage<BareResponse>	whenCompleted()	Returns a CompletionStage of this response.
java.util.concurrent.CompletionStage<BareResponse>	whenHeadersCompleted()	Returns a CompletionStage of headers part of this response.
void	writeStatusAndHeaders(Http.ResponseStatus status, java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers)	Send response line and headers to the client.

Method Detail

writeStatusAndHeaders

void writeStatusAndHeaders(Http.ResponseStatus status,
                           java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers)
                    throws SocketClosedException,
                           java.lang.NullPointerException

Send response line and headers to the client.

Parameters:

status - an HTTP status

headers - a Map of header names and values

Throws:

SocketClosedException - if headers were already send or response is closed

java.lang.NullPointerException - if status is null

whenHeadersCompleted

java.util.concurrent.CompletionStage<BareResponse> whenHeadersCompleted()

Returns a CompletionStage of headers part of this response. The stage is completed when all headers are sent to the client.

Returns:

a completion stage of the response.

whenCompleted

java.util.concurrent.CompletionStage<BareResponse> whenCompleted()

Returns a CompletionStage of this response. The stage is completed when all response data are sent or response channel is finished.

Returns:

a completion stage of the response.

onSubscribe

void onSubscribe(io.helidon.common.reactive.Flow.Subscription subscription)

Each response is subscribed up to a single publisher and AFTER writeStatusAndHeaders(Http.ResponseStatus, Map) method is called and returned.

Specified by:

onSubscribe in interface io.helidon.common.reactive.Flow.Subscriber<ResponseChunk>

Parameters:

subscription - a subscription.

onNext

void onNext(ResponseChunk data)
     throws SocketClosedException

Provided ByteBuffer MUST be fully read during the method call.

Specified by:

onNext in interface io.helidon.common.reactive.Flow.Subscriber<ResponseChunk>

Parameters:

data - chunk of the response payload

Throws:

SocketClosedException - if response is already closed

onError

void onError(java.lang.Throwable thr)

Response should be flushed and closed.

This method can be called without a subscription or demand. HTTP IO must be able to handle it.

Specified by:

onError in interface io.helidon.common.reactive.Flow.Subscriber<ResponseChunk>

Parameters:

thr - an error.

onComplete

void onComplete()

Response should be flushed and closed.

This method can be called without a subscription or demand. HTTP IO must be able to handle it.

Specified by:

onComplete in interface io.helidon.common.reactive.Flow.Subscriber<ResponseChunk>

requestId

long requestId()

A unique correlation ID that is associated with this response and its associated request.

Returns:

a unique correlation ID associated with this response and its request