reactor.netty.http.server

Interface HttpServerRequest

All Superinterfaces:

HttpInfos, HttpServerInfos, NettyInbound

public interface HttpServerRequest
extends NettyInbound, HttpServerInfos

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

Since:

0.5

Author:

Stephane Maldini

Method Summary

Modifier and Type	Method and Description
InetSocketAddress	hostAddress() Returns the address of the host peer or null in case of Unix Domain Sockets.
boolean	isFormUrlencoded() Returns true if the request has Content-Type with value application/x-www-form-urlencoded.
boolean	isMultipart() Returns true if the request has Content-Type with value multipart/form-data.
String	param(CharSequence key) URI parameter captured via {} e.g.
Map<String,String>	params() Returns all URI parameters captured via {} e.g.
HttpServerRequest	paramsResolver(java.util.function.Function<? super String,Map<String,String>> paramsResolver) Specifies a params resolver.
default Flux<HttpContent>	receiveContent() Returns a Flux of HttpContent containing received chunks
Flux<HttpData>	receiveForm() When the request is POST and have Content-Type with value application/x-www-form-urlencoded or multipart/form-data, returns a Flux of HttpData containing received Attribute/FileUpload.
Flux<HttpData>	receiveForm(java.util.function.Consumer<HttpServerFormDecoderProvider.Builder> formDecoderBuilder) When the request is POST and have Content-Type with value application/x-www-form-urlencoded or multipart/form-data, returns a Flux of HttpData containing received Attribute/FileUpload.
InetSocketAddress	remoteAddress() Returns the address of the remote peer or null in case of Unix Domain Sockets.
HttpHeaders	requestHeaders() Returns inbound HttpHeaders
String	scheme() Returns the current protocol scheme
HttpServerRequest	withConnection(java.util.function.Consumer<? super Connection> withConnection) Calls the passed callback with a Connection to operate on the underlying Channel state.

Methods inherited from interface reactor.netty.NettyInbound

receive, receiveObject

Methods inherited from interface reactor.netty.http.server.HttpServerInfos

allCookies

Methods inherited from interface reactor.netty.http.HttpInfos

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

Method Detail

withConnection

HttpServerRequest withConnection(java.util.function.Consumer<? super Connection> withConnection)

Description copied from interface: NettyInbound

Calls the passed callback with a Connection to operate on the underlying Channel state. This allows for chaining inbound API.

Specified by:

withConnection in interface NettyInbound

Parameters:

withConnection - connection callback

Returns:

the Connection

param

@Nullable
String param(CharSequence key)

URI parameter captured via {} e.g. /test/{param}.

Parameters:

key - parameter name e.g. "param" in URI /test/{param}

Returns:

the parameter captured value

params

@Nullable
Map<String,String> params()

Returns all URI parameters captured via {} e.g. /test/{param1}/{param2} as key/value map.

Returns:

the parameters captured key/value map

paramsResolver

HttpServerRequest paramsResolver(java.util.function.Function<? super String,Map<String,String>> paramsResolver)

Specifies a params resolver.

Parameters:

paramsResolver - a params resolver

Returns:

this HttpServerRequest

receiveContent

default Flux<HttpContent> receiveContent()

Returns a Flux of HttpContent containing received chunks

Returns:

a Flux of HttpContent containing received chunks

isFormUrlencoded

boolean isFormUrlencoded()

Returns true if the request has Content-Type with value application/x-www-form-urlencoded.

Returns:

true if the request has Content-Type with value application/x-www-form-urlencoded, false - otherwise

Since:

1.0.11

isMultipart

boolean isMultipart()

Returns true if the request has Content-Type with value multipart/form-data.

Returns:

true if the request has Content-Type with value multipart/form-data, false - otherwise

Since:

1.0.11

receiveForm

Flux<HttpData> receiveForm()

When the request is POST and have Content-Type with value application/x-www-form-urlencoded or multipart/form-data, returns a Flux of HttpData containing received Attribute/FileUpload. When the request is not POST or does not have Content-Type with value application/x-www-form-urlencoded or multipart/form-data, a Flux.error(Throwable) will be returned.

Uses HTTP form decoder configuration specified on server level or the default one if nothing is configured.

HttpData.retain() disables auto memory release on each HttpData published, retaining in order to prevent premature recycling when HttpData is accumulated downstream.

Returns:

a Flux of HttpData containing received Attribute/FileUpload

Since:

1.0.11

receiveForm

Flux<HttpData> receiveForm(java.util.function.Consumer<HttpServerFormDecoderProvider.Builder> formDecoderBuilder)

When the request is POST and have Content-Type with value application/x-www-form-urlencoded or multipart/form-data, returns a Flux of HttpData containing received Attribute/FileUpload. When the request is not POST or does not have Content-Type with value application/x-www-form-urlencoded or multipart/form-data, a Flux.error(Throwable) will be returned.

HttpData.retain() disables auto memory release on each HttpData published, retaining in order to prevent premature recycling when HttpData is accumulated downstream.

Parameters:

formDecoderBuilder - HttpServerFormDecoderProvider.Builder for HTTP form decoder configuration

Returns:

a Flux of HttpData containing received Attribute/FileUpload

Since:

1.0.11

hostAddress

@Nullable
InetSocketAddress hostAddress()

Returns the address of the host peer or null in case of Unix Domain Sockets.

Returns:

the host's address

remoteAddress

@Nullable
InetSocketAddress remoteAddress()

Returns the address of the remote peer or null in case of Unix Domain Sockets.

Returns:

the peer's address

requestHeaders

HttpHeaders requestHeaders()

Returns inbound HttpHeaders

Returns:

inbound HttpHeaders

scheme

String scheme()

Returns the current protocol scheme

Returns:

the protocol scheme