org.springframework.web.reactive

Class DispatcherHandler

java.lang.Object

org.springframework.web.reactive.DispatcherHandler

All Implemented Interfaces:

Aware, ApplicationContextAware, WebHandler

public class DispatcherHandler
extends java.lang.Object
implements WebHandler, ApplicationContextAware

Central dispatcher for HTTP request handlers/controllers. Dispatches to registered handlers for processing a web request, providing convenient mapping facilities.

It can use any HandlerMapping implementation to control the routing of requests to handler objects. HandlerMapping objects can be defined as beans in the application context.

It can use any HandlerAdapter; this allows for using any handler interface. HandlerAdapter objects can be added as beans in the application context.

It can use any HandlerResultHandler; this allows to process the result of the request handling. HandlerResultHandler objects can be added as beans in the application context.

Since:

5.0

Author:

Rossen Stoyanchev, Sebastien Deleuze, Juergen Hoeller

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.Exception	HANDLER_NOT_FOUND_EXCEPTION
private java.util.List<HandlerAdapter>	handlerAdapters
private java.util.List<HandlerMapping>	handlerMappings
private static Log	logger
private java.util.List<HandlerResultHandler>	resultHandlers

Constructor Summary

Constructors

Constructor and Description
DispatcherHandler() Create a new DispatcherHandler which needs to be configured with an ApplicationContext through setApplicationContext(org.springframework.context.ApplicationContext).
DispatcherHandler(ApplicationContext applicationContext) Create a new DispatcherHandler for the given ApplicationContext.

Method Summary

Modifier and Type	Method and Description
private HandlerResultHandler	getResultHandler(HandlerResult handlerResult)
<any>	handle(ServerWebExchange exchange) Handle the web server exchange.
private <any>	handleResult(ServerWebExchange exchange, HandlerResult result)
protected void	initStrategies(ApplicationContext context)
private <any>	invokeHandler(ServerWebExchange exchange, java.lang.Object handler)
void	setApplicationContext(ApplicationContext applicationContext) Set the ApplicationContext that this object runs in.
static HttpHandler	toHttpHandler(ApplicationContext context) Expose a dispatcher-based HttpHandler for the given application context, typically for direct registration with an engine adapter such as ServletHttpHandlerAdapter.
static WebHandler	toWebHandler(ApplicationContext applicationContext) Expose a dispatcher-based WebHandler for the given application context, typically for further configuration with filters and exception handlers through a WebHttpHandlerBuilder.

Methods inherited from class java.lang.Object

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

Field Detail

HANDLER_NOT_FOUND_EXCEPTION

private static final java.lang.Exception HANDLER_NOT_FOUND_EXCEPTION

logger

private static final Log logger

handlerMappings

private java.util.List<HandlerMapping> handlerMappings

handlerAdapters

private java.util.List<HandlerAdapter> handlerAdapters

resultHandlers

private java.util.List<HandlerResultHandler> resultHandlers

Constructor Detail

DispatcherHandler

public DispatcherHandler()

Create a new DispatcherHandler which needs to be configured with an ApplicationContext through setApplicationContext(org.springframework.context.ApplicationContext).

DispatcherHandler

public DispatcherHandler(ApplicationContext applicationContext)

Create a new DispatcherHandler for the given ApplicationContext.

Parameters:

applicationContext - the application context to find the handler beans in

Method Detail

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)

Description copied from interface: ApplicationContextAware

Set the ApplicationContext that this object runs in. Normally this call will be used to initialize the object.

Invoked after population of normal bean properties but before an init callback such as InitializingBean.afterPropertiesSet() or a custom init-method. Invoked after ResourceLoaderAware.setResourceLoader(org.springframework.core.io.ResourceLoader), ApplicationEventPublisherAware.setApplicationEventPublisher(org.springframework.context.ApplicationEventPublisher) and MessageSourceAware, if applicable.

Specified by:

setApplicationContext in interface ApplicationContextAware

Parameters:

applicationContext - the ApplicationContext object to be used by this object

See Also:

BeanInitializationException

initStrategies

protected void initStrategies(ApplicationContext context)

handle

public <any> handle(ServerWebExchange exchange)

Description copied from interface: WebHandler

Handle the web server exchange.

Specified by:

handle in interface WebHandler

Parameters:

exchange - the current server exchange

Returns:

Mono<Void> to indicate when request handling is complete

invokeHandler

private <any> invokeHandler(ServerWebExchange exchange,
                            java.lang.Object handler)

handleResult

private <any> handleResult(ServerWebExchange exchange,
                           HandlerResult result)

getResultHandler

private HandlerResultHandler getResultHandler(HandlerResult handlerResult)

toWebHandler

public static WebHandler toWebHandler(ApplicationContext applicationContext)

Expose a dispatcher-based WebHandler for the given application context, typically for further configuration with filters and exception handlers through a WebHttpHandlerBuilder.

Parameters:

applicationContext - the application context to find the handler beans in

See Also:

DispatcherHandler(ApplicationContext), WebHttpHandlerBuilder.webHandler(org.springframework.web.server.WebHandler)

toHttpHandler

public static HttpHandler toHttpHandler(ApplicationContext context)

Expose a dispatcher-based HttpHandler for the given application context, typically for direct registration with an engine adapter such as ServletHttpHandlerAdapter.

Delegates to WebHttpHandlerBuilder.applicationContext(org.springframework.context.ApplicationContext) that detects the target DispatcherHandler along with WebFilters, and WebExceptionHandlers in the given ApplicationContext.

Parameters:

context - the application context to find the handler beans in

See Also:

DispatcherHandler(ApplicationContext), HttpWebHandlerAdapter, ServletHttpHandlerAdapter, ReactorHttpHandlerAdapter, RxNettyHttpHandlerAdapter, UndertowHttpHandlerAdapter