org.springframework.web.server.adapter

Class WebHttpHandlerBuilder

java.lang.Object

org.springframework.web.server.adapter.WebHttpHandlerBuilder

public class WebHttpHandlerBuilder
extends Object

This builder has two purposes:

One is to assemble a processing chain that consists of a target WebHandler, then decorated with a set of WebFilters, then further decorated with a set of WebExceptionHandlers.

The second purpose is to adapt the resulting processing chain to an HttpHandler: the lowest-level reactive HTTP handling abstraction which can then be used with any of the supported runtimes. The adaptation is done with the help of HttpWebHandlerAdapter.

The processing chain can be assembled manually via builder methods, or detected from a Spring ApplicationContext via applicationContext, or a mix of both.

Since:

5.0

Author:

Rossen Stoyanchev, Sebastien Deleuze

See Also:

HttpWebHandlerAdapter

Field Summary

Fields

Modifier and Type	Field and Description
static String	LOCALE_CONTEXT_RESOLVER_BEAN_NAME Well-known name for the LocaleContextResolver in the bean factory.
static String	SERVER_CODEC_CONFIGURER_BEAN_NAME Well-known name for the ServerCodecConfigurer in the bean factory.
static String	WEB_HANDLER_BEAN_NAME Well-known name for the target WebHandler in the bean factory.
static String	WEB_SESSION_MANAGER_BEAN_NAME Well-known name for the WebSessionManager in the bean factory.

Method Summary

Modifier and Type	Method and Description
static WebHttpHandlerBuilder	applicationContext(ApplicationContext context) Static factory method to create a new builder instance by detecting beans in an ApplicationContext.
HttpHandler	build() Build the HttpHandler.
WebHttpHandlerBuilder	clone() Clone this WebHttpHandlerBuilder.
WebHttpHandlerBuilder	codecConfigurer(ServerCodecConfigurer codecConfigurer) Configure the ServerCodecConfigurer to set on the WebServerExchange.
WebHttpHandlerBuilder	exceptionHandler(WebExceptionHandler... handlers) Add the given exception handler(s).
WebHttpHandlerBuilder	exceptionHandlers(Consumer<List<WebExceptionHandler>> consumer) Manipulate the "live" list of currently configured exception handlers.
WebHttpHandlerBuilder	filter(WebFilter... filters) Add the given filter(s).
WebHttpHandlerBuilder	filters(Consumer<List<WebFilter>> consumer) Manipulate the "live" list of currently configured filters.
boolean	hasCodecConfigurer() Whether a ServerCodecConfigurer is configured or not, either detected from an ApplicationContext or explicitly configured via codecConfigurer.
boolean	hasLocaleContextResolver() Whether a LocaleContextResolver is configured or not, either detected from an ApplicationContext or explicitly configured via localeContextResolver.
boolean	hasSessionManager() Whether a WebSessionManager is configured or not, either detected from an ApplicationContext or explicitly configured via sessionManager.
WebHttpHandlerBuilder	localeContextResolver(LocaleContextResolver localeContextResolver) Configure the LocaleContextResolver to set on the WebServerExchange.
WebHttpHandlerBuilder	sessionManager(WebSessionManager manager) Configure the WebSessionManager to set on the WebServerExchange.
static WebHttpHandlerBuilder	webHandler(WebHandler webHandler) Static factory method to create a new builder instance.

Methods inherited from class java.lang.Object

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

Field Detail

WEB_HANDLER_BEAN_NAME

public static final String WEB_HANDLER_BEAN_NAME

Well-known name for the target WebHandler in the bean factory.

See Also:

Constant Field Values

WEB_SESSION_MANAGER_BEAN_NAME

public static final String WEB_SESSION_MANAGER_BEAN_NAME

Well-known name for the WebSessionManager in the bean factory.

See Also:

Constant Field Values

SERVER_CODEC_CONFIGURER_BEAN_NAME

public static final String SERVER_CODEC_CONFIGURER_BEAN_NAME

Well-known name for the ServerCodecConfigurer in the bean factory.

See Also:

Constant Field Values

LOCALE_CONTEXT_RESOLVER_BEAN_NAME

public static final String LOCALE_CONTEXT_RESOLVER_BEAN_NAME

Well-known name for the LocaleContextResolver in the bean factory.

See Also:

Constant Field Values

Method Detail

webHandler

public static WebHttpHandlerBuilder webHandler(WebHandler webHandler)

Static factory method to create a new builder instance.

Parameters:

webHandler - the target handler for the request

Returns:

the prepared builder

applicationContext

public static WebHttpHandlerBuilder applicationContext(ApplicationContext context)

Static factory method to create a new builder instance by detecting beans in an ApplicationContext. The following are detected:

• WebHandler [1] -- looked up by the name WEB_HANDLER_BEAN_NAME.
• WebFilter [0..N] -- detected by type and ordered, see AnnotationAwareOrderComparator.
• WebExceptionHandler [0..N] -- detected by type and ordered.
• WebSessionManager [0..1] -- looked up by the name WEB_SESSION_MANAGER_BEAN_NAME.
• ServerCodecConfigurer [0..1] -- looked up by the name SERVER_CODEC_CONFIGURER_BEAN_NAME.
• LocaleContextResolver [0..1] -- looked up by the name LOCALE_CONTEXT_RESOLVER_BEAN_NAME.

Parameters:

context - the application context to use for the lookup

Returns:

the prepared builder

filter

public WebHttpHandlerBuilder filter(WebFilter... filters)

Add the given filter(s).

Parameters:

filters - the filter(s) to add that's

filters

public WebHttpHandlerBuilder filters(Consumer<List<WebFilter>> consumer)

Manipulate the "live" list of currently configured filters.

Parameters:

consumer - the consumer to use

exceptionHandler

public WebHttpHandlerBuilder exceptionHandler(WebExceptionHandler... handlers)

Add the given exception handler(s).

Parameters:

handlers - the exception handler(s)

exceptionHandlers

public WebHttpHandlerBuilder exceptionHandlers(Consumer<List<WebExceptionHandler>> consumer)

Manipulate the "live" list of currently configured exception handlers.

Parameters:

consumer - the consumer to use

sessionManager

public WebHttpHandlerBuilder sessionManager(WebSessionManager manager)

Configure the WebSessionManager to set on the WebServerExchange.

By default DefaultWebSessionManager is used.

Parameters:

manager - the session manager

See Also:

HttpWebHandlerAdapter.setSessionManager(WebSessionManager)

hasSessionManager

public boolean hasSessionManager()

Whether a WebSessionManager is configured or not, either detected from an ApplicationContext or explicitly configured via sessionManager.

Since:

5.0.9

codecConfigurer

public WebHttpHandlerBuilder codecConfigurer(ServerCodecConfigurer codecConfigurer)

Configure the ServerCodecConfigurer to set on the WebServerExchange.

Parameters:

codecConfigurer - the codec configurer

hasCodecConfigurer

public boolean hasCodecConfigurer()

Whether a ServerCodecConfigurer is configured or not, either detected from an ApplicationContext or explicitly configured via codecConfigurer.

Since:

5.0.9

localeContextResolver

public WebHttpHandlerBuilder localeContextResolver(LocaleContextResolver localeContextResolver)

Configure the LocaleContextResolver to set on the WebServerExchange.

Parameters:

localeContextResolver - the locale context resolver

hasLocaleContextResolver

public boolean hasLocaleContextResolver()

Whether a LocaleContextResolver is configured or not, either detected from an ApplicationContext or explicitly configured via localeContextResolver.

Since:

5.0.9

build

public HttpHandler build()

Build the HttpHandler.

clone

public WebHttpHandlerBuilder clone()

Clone this WebHttpHandlerBuilder.

Overrides:

clone in class Object

Returns:

the cloned builder instance