public interface WebMvcConfigurer
@EnableWebMvc
.
@EnableWebMvc
-annotated configuration classes may implement
this interface to be called back and given a chance to customize the
default configuration. Consider extending WebMvcConfigurerAdapter
,
which provides a stub implementation of all interface methods.
Modifier and Type | Method and Description |
---|---|
void |
addArgumentResolvers(java.util.List<HandlerMethodArgumentResolver> argumentResolvers)
Add resolvers to support custom controller method argument types.
|
void |
addFormatters(FormatterRegistry registry)
|
void |
addInterceptors(InterceptorRegistry registry)
Add Spring MVC lifecycle interceptors for pre- and post-processing of
controller method invocations.
|
void |
addResourceHandlers(ResourceHandlerRegistry registry)
Add handlers to serve static resources such as images, js, and, css
files from specific locations under web application root, the classpath,
and others.
|
void |
addReturnValueHandlers(java.util.List<HandlerMethodReturnValueHandler> returnValueHandlers)
Add handlers to support custom controller method return value types.
|
void |
addViewControllers(ViewControllerRegistry registry)
Add view controllers to create a direct mapping between a URL path and
view name without the need for a controller in between.
|
void |
configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)
Configure a handler to delegate unhandled requests by forwarding to the
Servlet container's "default" servlet.
|
void |
configureHandlerExceptionResolvers(java.util.List<HandlerExceptionResolver> exceptionResolvers)
Configure the
HandlerExceptionResolver s to handle unresolved
controller exceptions. |
void |
configureMessageConverters(java.util.List<HttpMessageConverter<?>> converters)
Configure the
HttpMessageConverter s to use in argument resolvers
and return value handlers that support reading and/or writing to the
body of the request and response. |
Validator |
getValidator()
Provide a custom
Validator instead of the one created by default. |
void addFormatters(FormatterRegistry registry)
void configureMessageConverters(java.util.List<HttpMessageConverter<?>> converters)
HttpMessageConverter
s to use in argument resolvers
and return value handlers that support reading and/or writing to the
body of the request and response. If no message converters are added to
the list, default converters are added instead.converters
- initially an empty list of convertersValidator getValidator()
Validator
instead of the one created by default.
The default implementation, assuming JSR-303 is on the classpath, is:
LocalValidatorFactoryBean
.
Leave the return value as null
to keep the default.void addArgumentResolvers(java.util.List<HandlerMethodArgumentResolver> argumentResolvers)
This does not override the built-in support for resolving handler
method arguments. To customize the built-in support for argument
resolution, configure RequestMappingHandlerAdapter
directly.
argumentResolvers
- initially an empty listvoid addReturnValueHandlers(java.util.List<HandlerMethodReturnValueHandler> returnValueHandlers)
Using this option does not override the built-in support for handling return values. To customize the built-in support for handling return values, configure RequestMappingHandlerAdapter directly.
returnValueHandlers
- initially an empty listvoid configureHandlerExceptionResolvers(java.util.List<HandlerExceptionResolver> exceptionResolvers)
HandlerExceptionResolver
s to handle unresolved
controller exceptions. If no resolvers are added to the list, default
exception resolvers are added instead.exceptionResolvers
- initially an empty listvoid addInterceptors(InterceptorRegistry registry)
void addViewControllers(ViewControllerRegistry registry)
void addResourceHandlers(ResourceHandlerRegistry registry)
void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)
DispatcherServlet
is mapped to "/" thus overriding the
Servlet container's default handling of static resources.