org.springframework.web.servlet.handler

Class HandlerMappingIntrospector

java.lang.Object

org.springframework.web.servlet.handler.HandlerMappingIntrospector

All Implemented Interfaces:

Aware, InitializingBean, ApplicationContextAware, CorsConfigurationSource

public class HandlerMappingIntrospector
extends java.lang.Object
implements CorsConfigurationSource, ApplicationContextAware, InitializingBean

Helper class to get information from the HandlerMapping that would serve a specific request.

Provides the following methods:

• getMatchableHandlerMapping(javax.servlet.http.HttpServletRequest) — obtain a HandlerMapping to check request-matching criteria against.
• getCorsConfiguration(javax.servlet.http.HttpServletRequest) — obtain the CORS configuration for the request.

Since:

4.3.1

Author:

Rossen Stoyanchev

Constructor Summary

Constructors

Constructor and Description
HandlerMappingIntrospector() Constructor for use with ApplicationContextAware.
HandlerMappingIntrospector(ApplicationContext context) Deprecated.

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
CorsConfiguration	getCorsConfiguration(HttpServletRequest request) Return a CorsConfiguration based on the incoming request.
java.util.List<HandlerMapping>	getHandlerMappings() Return the configured HandlerMapping's.
MatchableHandlerMapping	getMatchableHandlerMapping(HttpServletRequest request) Find the HandlerMapping that would handle the given request and return it as a MatchableHandlerMapping that can be used to test request-matching criteria.
void	setApplicationContext(ApplicationContext applicationContext) Set the ApplicationContext that this object runs in.

Methods inherited from class java.lang.Object

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

Constructor Detail

HandlerMappingIntrospector

public HandlerMappingIntrospector()

Constructor for use with ApplicationContextAware.

HandlerMappingIntrospector

@Deprecated
public HandlerMappingIntrospector(ApplicationContext context)

Deprecated.

Constructor that detects the configured HandlerMappings in the given ApplicationContext or falls back on "DispatcherServlet.properties" like the DispatcherServlet.

Method Detail

getHandlerMappings

public java.util.List<HandlerMapping> getHandlerMappings()

Return the configured HandlerMapping's.

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

afterPropertiesSet

public void afterPropertiesSet()

Description copied from interface: InitializingBean

Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.

Specified by:

afterPropertiesSet in interface InitializingBean

getMatchableHandlerMapping

@Nullable
public MatchableHandlerMapping getMatchableHandlerMapping(HttpServletRequest request)
                                                             throws java.lang.Exception

Find the HandlerMapping that would handle the given request and return it as a MatchableHandlerMapping that can be used to test request-matching criteria.

If the matching HandlerMapping is not an instance of MatchableHandlerMapping, an IllegalStateException is raised.

Parameters:

request - the current request

Returns:

the resolved matcher, or null

Throws:

java.lang.Exception - if any of the HandlerMapping's raise an exception

getCorsConfiguration

@Nullable
public CorsConfiguration getCorsConfiguration(HttpServletRequest request)

Description copied from interface: CorsConfigurationSource

Return a CorsConfiguration based on the incoming request.

Specified by:

getCorsConfiguration in interface CorsConfigurationSource

Returns:

the associated CorsConfiguration, or null if none