reactor.netty.http.server

Interface HttpServerRoutes

All Superinterfaces:

java.util.function.BiFunction<HttpServerRequest,HttpServerResponse,Publisher<java.lang.Void>>

public interface HttpServerRoutes
extends java.util.function.BiFunction<HttpServerRequest,HttpServerResponse,Publisher<java.lang.Void>>

Server routes are unique and only the first matching in order of declaration will be invoked.

Author:

Stephane Maldini

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.function.Predicate<HttpServerRequest>	INDEX_PREDICATE

Method Summary

Modifier and Type	Method and Description
default HttpServerRoutes	delete(java.lang.String path, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) Listen for HTTP DELETE on the passed path to be used as a routing condition.
default HttpServerRoutes	directory(java.lang.String uri, java.nio.file.Path directory) Listen for HTTP GET on the passed path to be used as a routing condition.
HttpServerRoutes	directory(java.lang.String uri, java.nio.file.Path directory, java.util.function.Function<HttpServerResponse,HttpServerResponse> interceptor) Listen for HTTP GET on the passed path to be used as a routing condition.The content of the provided directory will be served.
default HttpServerRoutes	file(java.util.function.Predicate<HttpServerRequest> uri, java.nio.file.Path path, java.util.function.Function<HttpServerResponse,HttpServerResponse> interceptor) Listen for HTTP GET on the passed path to be used as a routing condition.
default HttpServerRoutes	file(java.lang.String uri, java.nio.file.Path path) Listen for HTTP GET on the passed path to be used as a routing condition.
default HttpServerRoutes	file(java.lang.String uri, java.lang.String path) Listen for HTTP GET on the passed path to be used as a routing condition.
default HttpServerRoutes	get(java.lang.String path, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) Listen for HTTP GET on the passed path to be used as a routing condition.
default HttpServerRoutes	head(java.lang.String path, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) Listen for HTTP HEAD on the passed path to be used as a routing condition.
default HttpServerRoutes	index(java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) This route will be invoked when GET "/path" or "/path/" like uri are requested.
static HttpServerRoutes	newRoutes()
default HttpServerRoutes	options(java.lang.String path, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) Listen for HTTP OPTIONS on the passed path to be used as a routing condition.
default HttpServerRoutes	post(java.lang.String path, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) Listen for HTTP POST on the passed path to be used as a routing condition.
default HttpServerRoutes	put(java.lang.String path, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) Listen for HTTP PUT on the passed path to be used as a routing condition.
HttpServerRoutes	route(java.util.function.Predicate<? super HttpServerRequest> condition, java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler) A generic route predicate that if matched invoke the passed req/resp handler.
default HttpServerRoutes	ws(java.util.function.Predicate<? super HttpServerRequest> condition, java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler, java.lang.String protocols) Listen for WebSocket with the given route predicate to invoke the matching handlers
default HttpServerRoutes	ws(java.util.function.Predicate<? super HttpServerRequest> condition, java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler, java.lang.String protocols, int maxFramePayloadLength) Listen for WebSocket with the given route predicate to invoke the matching handlers
default HttpServerRoutes	ws(java.lang.String path, java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler) Listen for WebSocket on the passed path to be used as a routing condition.
default HttpServerRoutes	ws(java.lang.String path, java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler, java.lang.String protocols) Listen for WebSocket on the passed path to be used as a routing condition.

Methods inherited from interface java.util.function.BiFunction

andThen, apply

Field Detail

INDEX_PREDICATE

static final java.util.function.Predicate<HttpServerRequest> INDEX_PREDICATE

Method Detail

newRoutes

static HttpServerRoutes newRoutes()

Returns:

a new default routing registry HttpServerRoutes

delete

default HttpServerRoutes delete(java.lang.String path,
                                java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

Listen for HTTP DELETE on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available, e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

path - The DELETE path used by clients.

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

directory

default HttpServerRoutes directory(java.lang.String uri,
                                   java.nio.file.Path directory)

Listen for HTTP GET on the passed path to be used as a routing condition. The content of the provided directory will be served.

Additional regex matching is available, e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

uri - The GET path used by clients

directory - the root prefix to serve from in file system, e.g. "/Users/me/resources"

Returns:

this HttpServerRoutes

directory

HttpServerRoutes directory(java.lang.String uri,
                           java.nio.file.Path directory,
                           @Nullable
                           java.util.function.Function<HttpServerResponse,HttpServerResponse> interceptor)

Listen for HTTP GET on the passed path to be used as a routing condition.The content of the provided directory will be served.

Additional regex matching is available, e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

uri - The GET path used by clients

directory - the root prefix to serve from in file system, e.g. "/Users/me/resources"

interceptor - a pre response processor

Returns:

this HttpServerRoutes

file

default HttpServerRoutes file(java.lang.String uri,
                              java.nio.file.Path path)

Listen for HTTP GET on the passed path to be used as a routing condition. The provided File will be served.

Additional regex matching is available, e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

uri - The GET path used by clients

path - the resource Path to serve

Returns:

this HttpServerRoutes

file

default HttpServerRoutes file(java.lang.String uri,
                              java.lang.String path)

Listen for HTTP GET on the passed path to be used as a routing condition. The file at provided path will be served.

Additional regex matching is available, e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

uri - The GET path used by clients

path - the resource path to serve

Returns:

this HttpServerRoutes

file

default HttpServerRoutes file(java.util.function.Predicate<HttpServerRequest> uri,
                              java.nio.file.Path path,
                              @Nullable
                              java.util.function.Function<HttpServerResponse,HttpServerResponse> interceptor)

Listen for HTTP GET on the passed path to be used as a routing condition. The file on the provided Path is served.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

uri - The HttpPredicate to use to trigger the route, pattern matching and capture are supported

path - the Path to the file to serve

interceptor - a channel pre-intercepting handler e.g. for content type header

Returns:

this HttpServerRoutes

get

default HttpServerRoutes get(java.lang.String path,
                             java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

Listen for HTTP GET on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

path - The GET path used by clients

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

head

default HttpServerRoutes head(java.lang.String path,
                              java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

Listen for HTTP HEAD on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

path - The HEAD path used by clients

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

index

default HttpServerRoutes index(java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

This route will be invoked when GET "/path" or "/path/" like uri are requested.

Parameters:

handler - an handler to invoke on index/root request

Returns:

this HttpServerRoutes

options

default HttpServerRoutes options(java.lang.String path,
                                 java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

Listen for HTTP OPTIONS on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

path - The OPTIONS path used by clients

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

post

default HttpServerRoutes post(java.lang.String path,
                              java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

Listen for HTTP POST on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

path - The POST path used by clients

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

put

default HttpServerRoutes put(java.lang.String path,
                             java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

Listen for HTTP PUT on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence)

Parameters:

path - The PUT path used by clients

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

route

HttpServerRoutes route(java.util.function.Predicate<? super HttpServerRequest> condition,
                       java.util.function.BiFunction<? super HttpServerRequest,? super HttpServerResponse,? extends Publisher<java.lang.Void>> handler)

A generic route predicate that if matched invoke the passed req/resp handler.

Parameters:

condition - a predicate given each inbound request

handler - the handler to invoke on match

Returns:

this HttpServerRoutes

ws

default HttpServerRoutes ws(java.lang.String path,
                            java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler)

Listen for WebSocket on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence) They are not accessible in the handler provided as parameter.

Parameters:

path - The websocket path used by clients

handler - an handler to invoke for the given condition

Returns:

this HttpServerRoutes

ws

default HttpServerRoutes ws(java.lang.String path,
                            java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler,
                            @Nullable
                            java.lang.String protocols)

Listen for WebSocket on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers.

Additional regex matching is available e.g. "/test/{param}". Params are resolved using HttpServerRequest.param(CharSequence) They are not accessible in the handler provided as parameter.

Parameters:

path - The websocket path used by clients

handler - an handler to invoke for the given condition

protocols - sub-protocol to use in WS handshake signature

Returns:

a new handler

ws

default HttpServerRoutes ws(java.util.function.Predicate<? super HttpServerRequest> condition,
                            java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler,
                            @Nullable
                            java.lang.String protocols)

Listen for WebSocket with the given route predicate to invoke the matching handlers

Parameters:

condition - a predicate given each inbound request

handler - an handler to invoke for the given condition

protocols - sub-protocol to use in WS handshake signature

Returns:

a new handler

ws

default HttpServerRoutes ws(java.util.function.Predicate<? super HttpServerRequest> condition,
                            java.util.function.BiFunction<? super WebsocketInbound,? super WebsocketOutbound,? extends Publisher<java.lang.Void>> handler,
                            @Nullable
                            java.lang.String protocols,
                            int maxFramePayloadLength)

Listen for WebSocket with the given route predicate to invoke the matching handlers

Parameters:

condition - a predicate given each inbound request

handler - an handler to invoke for the given condition

protocols - sub-protocol to use in WS handshake signature

Returns:

a new handler