reactor.ipc.netty.http.server

Interface HttpServerResponse

All Superinterfaces:

HttpInfos, NettyOutbound, Publisher<java.lang.Void>

public interface HttpServerResponse
extends NettyOutbound, HttpInfos

An Http Reactive Channel with several accessor related to HTTP flow : headers, params, URI, method, websocket...

Since:

0.5

Author:

Stephane Maldini

Field Summary

Fields inherited from interface reactor.ipc.netty.NettyOutbound

FILE_CHUNKED_STRATEGY_BUFFER

Method Summary

Modifier and Type	Method and Description
HttpServerResponse	addCookie(Cookie cookie) Add an outbound cookie
HttpServerResponse	addHeader(java.lang.CharSequence name, java.lang.CharSequence value) Add an outbound http header, appending the value if the header already exist.
HttpServerResponse	chunkedTransfer(boolean chunked) Set transfer-encoding header
default HttpServerResponse	context(java.util.function.Consumer<NettyContext> contextCallback) Immediately call the passed callback with a NettyContext to operate on the underlying Channel state.
boolean	hasSentHeaders() Return true if headers and status have been sent to the client
HttpServerResponse	header(java.lang.CharSequence name, java.lang.CharSequence value) Set an outbound header, replacing any pre-existing value.
HttpServerResponse	headers(HttpHeaders headers) Set outbound headers, replacing any pre-existing value for these headers.
HttpServerResponse	keepAlive(boolean keepAlive) Set the request keepAlive if true otherwise remove the existing connection keep alive header
default HttpServerResponse	onWriteIdle(long idleTimeout, java.lang.Runnable onWriteIdle) Assign a Runnable to be invoked when writes have become idle for the given timeout.
default HttpServerResponse	options(java.util.function.Consumer<? super NettyPipeline.SendOptions> configurator) Provide a new NettyOutbound scoped configuration for sending.
HttpHeaders	responseHeaders() Return headers sent back to the clients
default Mono<java.lang.Void>	send() Send headers and empty content thus delimiting a full empty body http response.
NettyOutbound	sendHeaders() Return a NettyOutbound successful on committed response
Mono<java.lang.Void>	sendNotFound() Send 404 status HttpResponseStatus.NOT_FOUND.
Mono<java.lang.Void>	sendRedirect(java.lang.String location) Send redirect status HttpResponseStatus.FOUND along with a location header to the remote client.
default Mono<java.lang.Void>	sendWebsocket(java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> websocketHandler) Upgrade connection to Websocket.
Mono<java.lang.Void>	sendWebsocket(java.lang.String protocols, java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> websocketHandler) Upgrade connection to Websocket with optional subprotocol(s).
HttpServerResponse	sse() Add "text/event-stream" content-type for Server-Sent Events
HttpResponseStatus	status() Return the assigned HTTP status
HttpServerResponse	status(HttpResponseStatus status) Set an HTTP status to be sent along with the headers
default HttpServerResponse	status(int status) Set an HTTP status to be sent along with the headers

Methods inherited from interface reactor.ipc.netty.NettyOutbound

alloc, context, getFileChunkedStrategy, neverComplete, send, sendByteArray, sendFile, sendFile, sendFileChunked, sendGroups, sendObject, sendObject, sendString, sendString, subscribe, then, then

Methods inherited from interface reactor.ipc.netty.http.HttpInfos

cookies, isKeepAlive, isWebsocket, method, path, uri, version

Method Detail

addCookie

HttpServerResponse addCookie(Cookie cookie)

Add an outbound cookie

Returns:

this outbound

addHeader

HttpServerResponse addHeader(java.lang.CharSequence name,
                             java.lang.CharSequence value)

Add an outbound http header, appending the value if the header already exist.

Parameters:

name - header name

value - header value

Returns:

this outbound

chunkedTransfer

HttpServerResponse chunkedTransfer(boolean chunked)

Set transfer-encoding header

Parameters:

chunked - true if transfer-encoding:chunked

Returns:

this outbound

context

default HttpServerResponse context(java.util.function.Consumer<NettyContext> contextCallback)

Description copied from interface: NettyOutbound

Immediately call the passed callback with a NettyContext to operate on the underlying Channel state. This allows for chaining outbound API.

Specified by:

context in interface NettyOutbound

Parameters:

contextCallback - context callback

Returns:

the NettyContext

hasSentHeaders

boolean hasSentHeaders()

Return true if headers and status have been sent to the client

Returns:

true if headers and status have been sent to the client

header

HttpServerResponse header(java.lang.CharSequence name,
                          java.lang.CharSequence value)

Set an outbound header, replacing any pre-existing value.

Parameters:

name - headers key

value - header value

Returns:

this outbound

headers

HttpServerResponse headers(HttpHeaders headers)

Set outbound headers, replacing any pre-existing value for these headers.

Parameters:

headers - netty headers map

Returns:

this outbound

keepAlive

HttpServerResponse keepAlive(boolean keepAlive)

Set the request keepAlive if true otherwise remove the existing connection keep alive header

Returns:

this outbound

onWriteIdle

default HttpServerResponse onWriteIdle(long idleTimeout,
                                       java.lang.Runnable onWriteIdle)

Description copied from interface: NettyOutbound

Assign a Runnable to be invoked when writes have become idle for the given timeout. This replaces any previously set idle callback.

Specified by:

onWriteIdle in interface NettyOutbound

Parameters:

idleTimeout - the idle timeout

onWriteIdle - the idle timeout handler

Returns:

this

options

default HttpServerResponse options(java.util.function.Consumer<? super NettyPipeline.SendOptions> configurator)

Description copied from interface: NettyOutbound

Provide a new NettyOutbound scoped configuration for sending. The NettyPipeline.SendOptions changes will apply to the next written object or Publisher.

Specified by:

options in interface NettyOutbound

Parameters:

configurator - the callback invoked to retrieve send configuration

Returns:

this instance

responseHeaders

HttpHeaders responseHeaders()

Return headers sent back to the clients

Returns:

headers sent back to the clients

send

default Mono<java.lang.Void> send()

Send headers and empty content thus delimiting a full empty body http response.

Returns:

a Mono successful on committed response

See Also:

NettyOutbound.send(Publisher)

sendHeaders

NettyOutbound sendHeaders()

Return a NettyOutbound successful on committed response

Returns:

a NettyOutbound successful on committed response

sendNotFound

Mono<java.lang.Void> sendNotFound()

Send 404 status HttpResponseStatus.NOT_FOUND.

Returns:

a Mono successful on flush confirmation

sendRedirect

Mono<java.lang.Void> sendRedirect(java.lang.String location)

Send redirect status HttpResponseStatus.FOUND along with a location header to the remote client.

Parameters:

location - the location to redirect to

Returns:

a Mono successful on flush confirmation

sendWebsocket

default Mono<java.lang.Void> sendWebsocket(java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> websocketHandler)

Upgrade connection to Websocket. Mono and Callback are invoked on handshake success, otherwise the returned Mono fails.

Parameters:

websocketHandler - the in/out handler for ws transport

Returns:

a Mono completing when upgrade is confirmed

sendWebsocket

Mono<java.lang.Void> sendWebsocket(java.lang.String protocols,
                                   java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> websocketHandler)

Upgrade connection to Websocket with optional subprotocol(s). Mono and Callback are invoked on handshake success, otherwise the returned Mono fails.

Parameters:

protocols - optional sub-protocol

websocketHandler - the in/out handler for ws transport

Returns:

a Mono completing when upgrade is confirmed

sse

HttpServerResponse sse()

Add "text/event-stream" content-type for Server-Sent Events

Returns:

this response

status

HttpResponseStatus status()

Return the assigned HTTP status

Returns:

the assigned HTTP status

status

HttpServerResponse status(HttpResponseStatus status)

Set an HTTP status to be sent along with the headers

Parameters:

status - an HTTP status to be sent along with the headers

Returns:

this response

status

default HttpServerResponse status(int status)

Set an HTTP status to be sent along with the headers

Parameters:

status - an HTTP status to be sent along with the headers

Returns:

this response