Class WebFluxConfigurationSupport

java.lang.Object

org.springframework.web.reactive.config.WebFluxConfigurationSupport

All Implemented Interfaces:

Aware, ApplicationContextAware

Direct Known Subclasses:

DelegatingWebFluxConfiguration

public class WebFluxConfigurationSupport
extends Object
implements ApplicationContextAware

The main class for Spring WebFlux configuration.

Import directly or extend and override protected methods to customize.

Since:

5.0

Author:

Rossen Stoyanchev, Brian Clozel

Constructor Summary

Constructors

Constructor	Description
WebFluxConfigurationSupport()

Method Summary

Modifier and Type	Method	Description
protected void	addCorsMappings(CorsRegistry registry)	Override this method to configure cross-origin requests processing.
protected void	addFormatters(FormatterRegistry registry)	Override this method to add custom Converter and/or Formatter delegates to the common FormattingConversionService.
protected void	addResourceHandlers(ResourceHandlerRegistry registry)	Override this method to add resource handlers for serving static resources.
protected void	configureApiVersioning(ApiVersionConfigurer configurer)	Override this method to configure API versioning.
protected void	configureArgumentResolvers(ArgumentResolverConfigurer configurer)	Configure resolvers for custom controller method arguments.
protected void	configureBlockingExecution(BlockingExecutionConfigurer configurer)	Override this method to configure blocking execution.
protected void	configureContentTypeResolver(RequestedContentTypeResolverBuilder builder)	Override to configure how the requested content type is resolved.
protected void	configureErrorResponseInterceptors(List<ErrorResponse.Interceptor> interceptors)	Override this method for control over the ErrorResponse.Interceptor's to apply in result handling when rendering error responses.
protected void	configureHttpMessageCodecs(ServerCodecConfigurer configurer)	Override to configure the HTTP message readers and writers to use.
void	configurePathMatching(PathMatchConfigurer configurer)	Override to configure path matching options.
protected void	configureViewResolvers(ViewResolverRegistry registry)	Configure view resolution for supporting template engines.
protected LocaleContextResolver	createLocaleContextResolver()	Override to plug a subclass of LocaleContextResolver.
protected RequestMappingHandlerAdapter	createRequestMappingHandlerAdapter()	Override to plug a subclass of RequestMappingHandlerAdapter.
protected RequestMappingHandlerMapping	createRequestMappingHandlerMapping()	Override to plug a subclass of RequestMappingHandlerMapping.
protected RouterFunctionMapping	createRouterFunctionMapping()	Override to plug a subclass of RouterFunctionMapping.
final @Nullable ApplicationContext	getApplicationContext()
protected final BlockingExecutionConfigurer	getBlockingExecutionConfigurer()	Callback to build and cache the BlockingExecutionConfigurer.
protected ConfigurableWebBindingInitializer	getConfigurableWebBindingInitializer(FormattingConversionService webFluxConversionService, Validator webFluxValidator)	Return the ConfigurableWebBindingInitializer to use for initializing all WebDataBinder instances.
protected final Map<String, CorsConfiguration>	getCorsConfigurations()	Callback for building the global CORS configuration.
protected final List<ErrorResponse.Interceptor>	getErrorResponseInterceptors()	Provide access to the list of ErrorResponse.Interceptor's to apply in result handlers when rendering error responses.
protected @Nullable MessageCodesResolver	getMessageCodesResolver()	Override this method to provide a custom MessageCodesResolver.
protected final PathMatchConfigurer	getPathMatchConfigurer()	Callback for building the PathMatchConfigurer.
protected @Nullable Validator	getValidator()	Override this method to provide a custom Validator.
protected final ViewResolverRegistry	getViewResolverRegistry()	Callback for building the ViewResolverRegistry.
protected @Nullable WebSocketService	getWebSocketService()
HandlerFunctionAdapter	handlerFunctionAdapter()
LocaleContextResolver	localeContextResolver()
RequestMappingHandlerAdapter	requestMappingHandlerAdapter(ReactiveAdapterRegistry reactiveAdapterRegistry, ServerCodecConfigurer serverCodecConfigurer, FormattingConversionService conversionService, RequestedContentTypeResolver contentTypeResolver, Validator validator)
RequestMappingHandlerMapping	requestMappingHandlerMapping(RequestedContentTypeResolver contentTypeResolver, @Nullable ApiVersionStrategy apiVersionStrategy)
HandlerMapping	resourceHandlerMapping(ResourceUrlProvider resourceUrlProvider)	Return a handler mapping ordered at Integer.MAX_VALUE-1 with mapped resource handlers.
ResourceUrlProvider	resourceUrlProvider()
ResponseBodyResultHandler	responseBodyResultHandler(ReactiveAdapterRegistry reactiveAdapterRegistry, ServerCodecConfigurer serverCodecConfigurer, RequestedContentTypeResolver contentTypeResolver)
ResponseEntityResultHandler	responseEntityResultHandler(ReactiveAdapterRegistry reactiveAdapterRegistry, ServerCodecConfigurer serverCodecConfigurer, RequestedContentTypeResolver contentTypeResolver)
WebExceptionHandler	responseStatusExceptionHandler()
RouterFunctionMapping	routerFunctionMapping(ServerCodecConfigurer serverCodecConfigurer, @Nullable ApiVersionStrategy apiVersionStrategy)
ServerCodecConfigurer	serverCodecConfigurer()	Return the configurer for HTTP message readers and writers.
ServerResponseResultHandler	serverResponseResultHandler(ServerCodecConfigurer serverCodecConfigurer)
void	setApplicationContext(@Nullable ApplicationContext applicationContext)	Set the ApplicationContext that this object runs in.
SimpleHandlerAdapter	simpleHandlerAdapter()
ViewResolutionResultHandler	viewResolutionResultHandler(ReactiveAdapterRegistry reactiveAdapterRegistry, RequestedContentTypeResolver contentTypeResolver)
ReactiveAdapterRegistry	webFluxAdapterRegistry()	Return a ReactiveAdapterRegistry to adapting reactive types.
@Nullable ApiVersionStrategy	webFluxApiVersionStrategy()	Return the central strategy to manage API versioning with, or null if the application does not use versioning.
RequestedContentTypeResolver	webFluxContentTypeResolver()
FormattingConversionService	webFluxConversionService()	Return a FormattingConversionService for use with annotated controllers.
Validator	webFluxValidator()	Return a global Validator instance for example for validating @RequestBody method arguments.
WebSocketHandlerAdapter	webFluxWebSocketHandlerAdapter()
DispatcherHandler	webHandler()

Methods inherited from class Object

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

Constructor Details

WebFluxConfigurationSupport

public WebFluxConfigurationSupport()

Method Details

setApplicationContext

public void setApplicationContext(@Nullable 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(ResourceLoader), ApplicationEventPublisherAware.setApplicationEventPublisher(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

getApplicationContext

public final @Nullable ApplicationContext getApplicationContext()

webHandler

@Bean
public DispatcherHandler webHandler()

responseStatusExceptionHandler

@Bean
@Order(0)
public WebExceptionHandler responseStatusExceptionHandler()

requestMappingHandlerMapping

@Bean
public RequestMappingHandlerMapping requestMappingHandlerMapping(@Qualifier("webFluxContentTypeResolver")
 RequestedContentTypeResolver contentTypeResolver,
 @Qualifier("webFluxApiVersionStrategy")
 @Nullable ApiVersionStrategy apiVersionStrategy)

createRequestMappingHandlerMapping

protected RequestMappingHandlerMapping createRequestMappingHandlerMapping()

Override to plug a subclass of RequestMappingHandlerMapping.

webFluxContentTypeResolver

@Bean
public RequestedContentTypeResolver webFluxContentTypeResolver()

configureContentTypeResolver

protected void configureContentTypeResolver(RequestedContentTypeResolverBuilder builder)

Override to configure how the requested content type is resolved.

webFluxApiVersionStrategy

@Bean
public @Nullable ApiVersionStrategy webFluxApiVersionStrategy()

Return the central strategy to manage API versioning with, or null if the application does not use versioning.

Since:

7.0

configureApiVersioning

protected void configureApiVersioning(ApiVersionConfigurer configurer)

Override this method to configure API versioning.

Since:

7.0

getCorsConfigurations

protected final Map<String, CorsConfiguration> getCorsConfigurations()

Callback for building the global CORS configuration. This method is final. Use addCorsMappings(CorsRegistry) to customize the CORS config.

addCorsMappings

protected void addCorsMappings(CorsRegistry registry)

Override this method to configure cross-origin requests processing.

See Also:

• CorsRegistry

getPathMatchConfigurer

protected final PathMatchConfigurer getPathMatchConfigurer()

Callback for building the PathMatchConfigurer. This method is final, use configurePathMatching(PathMatchConfigurer) to customize path matching.

configurePathMatching

public void configurePathMatching(PathMatchConfigurer configurer)

Override to configure path matching options.

routerFunctionMapping

@Bean
public RouterFunctionMapping routerFunctionMapping(ServerCodecConfigurer serverCodecConfigurer,
 @Nullable ApiVersionStrategy apiVersionStrategy)

createRouterFunctionMapping

protected RouterFunctionMapping createRouterFunctionMapping()

Override to plug a subclass of RouterFunctionMapping.

resourceHandlerMapping

@Bean
public HandlerMapping resourceHandlerMapping(ResourceUrlProvider resourceUrlProvider)

Return a handler mapping ordered at Integer.MAX_VALUE-1 with mapped resource handlers. To configure resource handling, override addResourceHandlers(ResourceHandlerRegistry).

resourceUrlProvider

@Bean
public ResourceUrlProvider resourceUrlProvider()

addResourceHandlers

protected void addResourceHandlers(ResourceHandlerRegistry registry)

Override this method to add resource handlers for serving static resources.

See Also:

• ResourceHandlerRegistry

requestMappingHandlerAdapter

@Bean
public RequestMappingHandlerAdapter requestMappingHandlerAdapter(@Qualifier("webFluxAdapterRegistry")
 ReactiveAdapterRegistry reactiveAdapterRegistry,
 ServerCodecConfigurer serverCodecConfigurer,
 @Qualifier("webFluxConversionService")
 FormattingConversionService conversionService,
 @Qualifier("webFluxContentTypeResolver")
 RequestedContentTypeResolver contentTypeResolver,
 @Qualifier("webFluxValidator")
 Validator validator)

createRequestMappingHandlerAdapter

protected RequestMappingHandlerAdapter createRequestMappingHandlerAdapter()

Override to plug a subclass of RequestMappingHandlerAdapter.

configureArgumentResolvers

protected void configureArgumentResolvers(ArgumentResolverConfigurer configurer)

Configure resolvers for custom controller method arguments.

serverCodecConfigurer

@Bean
public ServerCodecConfigurer serverCodecConfigurer()

Return the configurer for HTTP message readers and writers.

Use configureHttpMessageCodecs(ServerCodecConfigurer) to configure the readers and writers.

createLocaleContextResolver

protected LocaleContextResolver createLocaleContextResolver()

Override to plug a subclass of LocaleContextResolver.

localeContextResolver

@Bean
public LocaleContextResolver localeContextResolver()

configureHttpMessageCodecs

protected void configureHttpMessageCodecs(ServerCodecConfigurer configurer)

Override to configure the HTTP message readers and writers to use.

getConfigurableWebBindingInitializer

protected ConfigurableWebBindingInitializer getConfigurableWebBindingInitializer(FormattingConversionService webFluxConversionService,
 Validator webFluxValidator)

Return the ConfigurableWebBindingInitializer to use for initializing all WebDataBinder instances.

webFluxConversionService

@Bean
public FormattingConversionService webFluxConversionService()

Return a FormattingConversionService for use with annotated controllers.

See addFormatters(FormatterRegistry) as an alternative to overriding this method.

addFormatters

protected void addFormatters(FormatterRegistry registry)

Override this method to add custom Converter and/or Formatter delegates to the common FormattingConversionService.

See Also:

• webFluxConversionService()

webFluxAdapterRegistry

@Bean
public ReactiveAdapterRegistry webFluxAdapterRegistry()

Return a ReactiveAdapterRegistry to adapting reactive types.

webFluxValidator

@Bean
public Validator webFluxValidator()

Return a global Validator instance for example for validating @RequestBody method arguments.

Delegates to getValidator() first. If that returns null checks the classpath for the presence of a JSR-303 implementations before creating a OptionalValidatorFactoryBean. If a JSR-303 implementation is not available, a "no-op" Validator is returned.

getValidator

protected @Nullable Validator getValidator()

Override this method to provide a custom Validator.

getMessageCodesResolver

protected @Nullable MessageCodesResolver getMessageCodesResolver()

Override this method to provide a custom MessageCodesResolver.

getBlockingExecutionConfigurer

protected final BlockingExecutionConfigurer getBlockingExecutionConfigurer()

Callback to build and cache the BlockingExecutionConfigurer. This method is final, but subclasses can override configureBlockingExecution(BlockingExecutionConfigurer).

Since:

6.1

configureBlockingExecution

protected void configureBlockingExecution(BlockingExecutionConfigurer configurer)

Override this method to configure blocking execution.

Since:

6.1

handlerFunctionAdapter

@Bean
public HandlerFunctionAdapter handlerFunctionAdapter()

simpleHandlerAdapter

@Bean
public SimpleHandlerAdapter simpleHandlerAdapter()

webFluxWebSocketHandlerAdapter

@Bean
public WebSocketHandlerAdapter webFluxWebSocketHandlerAdapter()

getWebSocketService

protected @Nullable WebSocketService getWebSocketService()

responseEntityResultHandler

@Bean
public ResponseEntityResultHandler responseEntityResultHandler(@Qualifier("webFluxAdapterRegistry")
 ReactiveAdapterRegistry reactiveAdapterRegistry,
 ServerCodecConfigurer serverCodecConfigurer,
 @Qualifier("webFluxContentTypeResolver")
 RequestedContentTypeResolver contentTypeResolver)

responseBodyResultHandler

@Bean
public ResponseBodyResultHandler responseBodyResultHandler(@Qualifier("webFluxAdapterRegistry")
 ReactiveAdapterRegistry reactiveAdapterRegistry,
 ServerCodecConfigurer serverCodecConfigurer,
 @Qualifier("webFluxContentTypeResolver")
 RequestedContentTypeResolver contentTypeResolver)

viewResolutionResultHandler

@Bean
public ViewResolutionResultHandler viewResolutionResultHandler(@Qualifier("webFluxAdapterRegistry")
 ReactiveAdapterRegistry reactiveAdapterRegistry,
 @Qualifier("webFluxContentTypeResolver")
 RequestedContentTypeResolver contentTypeResolver)

serverResponseResultHandler

@Bean
public ServerResponseResultHandler serverResponseResultHandler(ServerCodecConfigurer serverCodecConfigurer)

getErrorResponseInterceptors

protected final List<ErrorResponse.Interceptor> getErrorResponseInterceptors()

Provide access to the list of ErrorResponse.Interceptor's to apply in result handlers when rendering error responses.

This method cannot be overridden; use configureErrorResponseInterceptors(List) instead.

Since:

6.2

configureErrorResponseInterceptors

protected void configureErrorResponseInterceptors(List<ErrorResponse.Interceptor> interceptors)

Override this method for control over the ErrorResponse.Interceptor's to apply in result handling when rendering error responses.

Parameters:

interceptors - the list to add handlers to

Since:

6.2

getViewResolverRegistry

protected final ViewResolverRegistry getViewResolverRegistry()

Callback for building the ViewResolverRegistry. This method is final, use configureViewResolvers(ViewResolverRegistry) to customize view resolvers.

configureViewResolvers

protected void configureViewResolvers(ViewResolverRegistry registry)

Configure view resolution for supporting template engines.

See Also:

• ViewResolverRegistry