Package io.helidon.webserver

Class Routing.Builder

java.lang.Object

io.helidon.webserver.Routing.Builder

All Implemented Interfaces:

Builder<Routing>, Routing.Rules<Routing.Builder>, java.util.function.Supplier<Routing>

Enclosing interface:

Routing

public static class Routing.Builder
extends java.lang.Object
implements Routing.Rules<Routing.Builder>, Builder<Routing>

A Routing builder.

Method Summary

Modifier and Type	Method and Description
Routing.Builder	any(Handler... requestHandlers) Routes all requests to provided handler(s).
Routing.Builder	any(PathMatcher pathMatcher, Handler... requestHandlers) Routes all requests with corresponding path to provided handler(s).
Routing.Builder	any(java.lang.String pathPattern, Handler... requestHandlers) Routes all requests with corresponding path to provided handler(s).
Routing.Builder	anyOf(java.lang.Iterable<Http.RequestMethod> methods, Handler... requestHandlers) Routes requests any specified method to provided handler(s).
Routing.Builder	anyOf(java.lang.Iterable<Http.RequestMethod> methods, PathMatcher pathMatcher, Handler... requestHandlers) Routes requests with any specified method and corresponding path to provided handler(s).
Routing.Builder	anyOf(java.lang.Iterable<Http.RequestMethod> methods, java.lang.String pathPattern, Handler... requestHandlers) Routes requests with any specified method and corresponding path to provided handler(s).
Routing	build() Builds a new routing instance.
WebServer	createServer() Creates new WebServer instance with this routing and default configuration.
WebServer	createServer(ServerConfiguration.Builder configurationBuilder) Creates new WebServer instance with provided configuration and this routing.
WebServer	createServer(ServerConfiguration configuration) Creates new WebServer instance with provided configuration and this routing.
Routing.Builder	delete(Handler... requestHandlers) Routes all DELETE requests to provided handler(s).
Routing.Builder	delete(PathMatcher pathMatcher, Handler... requestHandlers) Routes DELETE requests with corresponding path to provided handler(s).
Routing.Builder	delete(java.lang.String pathPattern, Handler... requestHandlers) Routes DELETE requests with corresponding path to provided handler(s).
<T extends java.lang.Throwable> Routing.Builder	error(java.lang.Class<T> exceptionClass, ErrorHandler<T> errorHandler) Registers an error handler that handles the given type of exceptions.
Routing.Builder	get(Handler... requestHandlers) Routes all GET requests to provided handler(s).
Routing.Builder	get(PathMatcher pathMatcher, Handler... requestHandlers) Routes GET requests with corresponding path to provided handler(s).
Routing.Builder	get(java.lang.String pathPattern, Handler... requestHandlers) Routes GET requests with corresponding path to provided handler(s).
Routing.Builder	head(Handler... requestHandlers) Routes all HEAD requests to provided handler(s).
Routing.Builder	head(PathMatcher pathMatcher, Handler... requestHandlers) Routes HEAD requests with corresponding path to provided handler(s).
Routing.Builder	head(java.lang.String pathPattern, Handler... requestHandlers) Routes HEAD requests with corresponding path to provided handler(s).
Routing.Builder	onNewWebServer(java.util.function.Consumer<WebServer> webServerConsumer) Registers callback on created new WebServer instance with this routing.
Routing.Builder	options(Handler... requestHandlers) Routes all OPTIONS requests to provided handler(s).
Routing.Builder	options(PathMatcher pathMatcher, Handler... requestHandlers) Routes OPTIONS requests with corresponding path to provided handler(s).
Routing.Builder	options(java.lang.String pathPattern, Handler... requestHandlers) Routes OPTIONS requests with corresponding path to provided handler(s).
Routing.Builder	post(Handler... requestHandlers) Routes all POST requests to provided handler(s).
Routing.Builder	post(PathMatcher pathMatcher, Handler... requestHandlers) Routes POST requests with corresponding path to provided handler(s).
Routing.Builder	post(java.lang.String pathPattern, Handler... requestHandlers) Routes POST requests with corresponding path to provided handler(s).
Routing.Builder	put(Handler... requestHandlers) Routes all PUT requests to provided handler(s).
Routing.Builder	put(PathMatcher pathMatcher, Handler... requestHandlers) Routes PUT requests with corresponding path to provided handler(s).
Routing.Builder	put(java.lang.String pathPattern, Handler... requestHandlers) Routes PUT requests with corresponding path to provided handler(s).
Routing.Builder	register(Builder<? extends Service>... serviceBuilders) Registers builder consumer.
Routing.Builder	register(Service... services) Registers builder consumer.
Routing.Builder	register(java.lang.String pathPattern, Builder<? extends Service>... serviceBuilders) Registers builder consumer.
Routing.Builder	register(java.lang.String pathPattern, Service... services) Registers builder consumer.
Routing.Builder	trace(Handler... requestHandlers) Routes all TRACE requests to provided handler(s).
Routing.Builder	trace(PathMatcher pathMatcher, Handler... requestHandlers) Routes TRACE requests with corresponding path to provided handler(s).
Routing.Builder	trace(java.lang.String pathPattern, Handler... requestHandlers) Routes TRACE requests with corresponding path to provided handler(s).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.helidon.common.Builder

get

Method Detail

register

public Routing.Builder register(Builder<? extends Service>... serviceBuilders)

Description copied from interface: Routing.Rules

Registers builder consumer. It enables to separate complex routing definitions to dedicated classes.

Specified by:

register in interface Routing.Rules<Routing.Builder>

Parameters:

serviceBuilders - service builder to register; they will be built as a first step of this method execution

Returns:

Updated routing configuration

register

public Routing.Builder register(Service... services)

Description copied from interface: Routing.Rules

Registers builder consumer. It enables to separate complex routing definitions to dedicated classes.

Specified by:

register in interface Routing.Rules<Routing.Builder>

Parameters:

services - services to register

Returns:

Updated routing configuration

register

public Routing.Builder register(java.lang.String pathPattern,
                                Service... services)

Description copied from interface: Routing.Rules

Registers builder consumer. It enables to separate complex routing definitions to dedicated classes.

Specified by:

register in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

services - services to register

Returns:

Updated routing configuration

register

public Routing.Builder register(java.lang.String pathPattern,
                                Builder<? extends Service>... serviceBuilders)

Description copied from interface: Routing.Rules

Registers builder consumer. It enables to separate complex routing definitions to dedicated classes.

Specified by:

register in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

serviceBuilders - service builder to register; they will be built as a first step of this method execution

Returns:

an updated routing configuration

get

public Routing.Builder get(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all GET requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

get in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

get

public Routing.Builder get(java.lang.String pathPattern,
                           Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes GET requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

get in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

get

public Routing.Builder get(PathMatcher pathMatcher,
                           Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes GET requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

get in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

put

public Routing.Builder put(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all PUT requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

put in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

put

public Routing.Builder put(java.lang.String pathPattern,
                           Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes PUT requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

put in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

put

public Routing.Builder put(PathMatcher pathMatcher,
                           Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes PUT requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

put in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for a registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

post

public Routing.Builder post(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all POST requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

post in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

post

public Routing.Builder post(java.lang.String pathPattern,
                            Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes POST requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

post in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

post

public Routing.Builder post(PathMatcher pathMatcher,
                            Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes POST requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

post in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

delete

public Routing.Builder delete(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all DELETE requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

delete in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

delete

public Routing.Builder delete(java.lang.String pathPattern,
                              Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes DELETE requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

delete in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

delete

public Routing.Builder delete(PathMatcher pathMatcher,
                              Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes DELETE requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

delete in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

options

public Routing.Builder options(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all OPTIONS requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

options in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

options

public Routing.Builder options(java.lang.String pathPattern,
                               Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes OPTIONS requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

options in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

options

public Routing.Builder options(PathMatcher pathMatcher,
                               Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes OPTIONS requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

options in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

head

public Routing.Builder head(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all HEAD requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

head in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

head

public Routing.Builder head(java.lang.String pathPattern,
                            Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes HEAD requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

head in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

head

public Routing.Builder head(PathMatcher pathMatcher,
                            Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes HEAD requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

head in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

trace

public Routing.Builder trace(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all TRACE requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

trace in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

trace

public Routing.Builder trace(java.lang.String pathPattern,
                             Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes TRACE requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

trace in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

trace

public Routing.Builder trace(PathMatcher pathMatcher,
                             Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes TRACE requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

trace in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

any

public Routing.Builder any(Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all requests to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

any in interface Routing.Rules<Routing.Builder>

Parameters:

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

any

public Routing.Builder any(java.lang.String pathPattern,
                           Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

any in interface Routing.Rules<Routing.Builder>

Parameters:

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

any

public Routing.Builder any(PathMatcher pathMatcher,
                           Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes all requests with corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

any in interface Routing.Rules<Routing.Builder>

Parameters:

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

anyOf

public Routing.Builder anyOf(java.lang.Iterable<Http.RequestMethod> methods,
                             Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes requests any specified method to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

anyOf in interface Routing.Rules<Routing.Builder>

Parameters:

methods - HTTP methods

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

anyOf

public Routing.Builder anyOf(java.lang.Iterable<Http.RequestMethod> methods,
                             java.lang.String pathPattern,
                             Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes requests with any specified method and corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

anyOf in interface Routing.Rules<Routing.Builder>

Parameters:

methods - HTTP methods

pathPattern - a URI path pattern. See PathMatcher for pattern syntax reference.

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

anyOf

public Routing.Builder anyOf(java.lang.Iterable<Http.RequestMethod> methods,
                             PathMatcher pathMatcher,
                             Handler... requestHandlers)

Description copied from interface: Routing.Rules

Routes requests with any specified method and corresponding path to provided handler(s). Request handler can call ServerRequest.next() to continue processing on the next registered handler.

Specified by:

anyOf in interface Routing.Rules<Routing.Builder>

Parameters:

methods - HTTP methods

pathMatcher - define path for registered router

requestHandlers - handlers to tryProcess HTTP request

Returns:

an updated routing configuration

onNewWebServer

public Routing.Builder onNewWebServer(java.util.function.Consumer<WebServer> webServerConsumer)

Description copied from interface: Routing.Rules

Registers callback on created new WebServer instance with this routing.

Specified by:

onNewWebServer in interface Routing.Rules<Routing.Builder>

Parameters:

webServerConsumer - a WebServer creation callback

Returns:

updated routing configuration

error

public <T extends java.lang.Throwable> Routing.Builder error(java.lang.Class<T> exceptionClass,
                                                             ErrorHandler<T> errorHandler)

Registers an error handler that handles the given type of exceptions.

Type Parameters:

T - an error handler type

Parameters:

exceptionClass - the type of exception to handle by this handler

errorHandler - the error handler

Returns:

an updated builder

build

public Routing build()

Builds a new routing instance.

Specified by:

build in interface Builder<Routing>

Returns:

a new instance

createServer

public WebServer createServer(ServerConfiguration configuration)

Creates new WebServer instance with provided configuration and this routing.

Parameters:

configuration - a web server configuration

Returns:

new WebServer instance

Throws:

java.lang.IllegalStateException - if none SPI implementation found

createServer

public WebServer createServer(ServerConfiguration.Builder configurationBuilder)

Creates new WebServer instance with provided configuration and this routing.

Parameters:

configurationBuilder - a web server configuration builder

Returns:

new WebServer instance

Throws:

java.lang.IllegalStateException - if none SPI implementation found

createServer

public WebServer createServer()

Creates new WebServer instance with this routing and default configuration.

Returns:

new WebServer instance

Throws:

java.lang.IllegalStateException - if none SPI implementation found