Package org.springframework.web.servlet.handler

Class AbstractHandlerMethodMapping<T>

java.lang.Object

org.springframework.context.support.ApplicationObjectSupport

org.springframework.web.context.support.WebApplicationObjectSupport

org.springframework.web.servlet.handler.AbstractHandlerMapping

org.springframework.web.servlet.handler.AbstractHandlerMethodMapping<T>

Type Parameters:

T - the mapping for a HandlerMethod containing the conditions needed to match the handler method to an incoming request.

All Implemented Interfaces:

Aware, BeanNameAware, InitializingBean, ApplicationContextAware, Ordered, ServletContextAware, HandlerMapping

Direct Known Subclasses:

RequestMappingInfoHandlerMapping

public abstract class AbstractHandlerMethodMapping<T>
extends AbstractHandlerMapping
implements InitializingBean

Abstract base class for HandlerMapping implementations that define a mapping between a request and a HandlerMethod.

For each registered handler method, a unique mapping is maintained with subclasses defining the details of the mapping type <T>.

Since:

3.1

Author:

Arjen Poutsma, Rossen Stoyanchev, Juergen Hoeller, Sam Brannen

Field Summary

Fields inherited from class org.springframework.web.servlet.handler.AbstractHandlerMapping

mappingsLogger

Fields inherited from class org.springframework.context.support.ApplicationObjectSupport

logger

Fields inherited from interface org.springframework.web.servlet.HandlerMapping

BEST_MATCHING_HANDLER_ATTRIBUTE, BEST_MATCHING_PATTERN_ATTRIBUTE, INTROSPECT_TYPE_LEVEL_MAPPING, LOOKUP_PATH, MATRIX_VARIABLES_ATTRIBUTE, PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE, PRODUCIBLE_MEDIA_TYPES_ATTRIBUTE, URI_TEMPLATE_VARIABLES_ATTRIBUTE

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor	Description
AbstractHandlerMethodMapping()

Method Summary

Modifier and Type	Method	Description
void	afterPropertiesSet()	Detects handler methods at initialization.
protected HandlerMethod	createHandlerMethod(Object handler, Method method)	Create the HandlerMethod instance.
protected void	detectHandlerMethods(Object handler)	Look for handler methods in the specified handler bean.
protected String[]	getCandidateBeanNames()	Determine the names of candidate beans in the application context.
protected CorsConfiguration	getCorsConfiguration(Object handler, HttpServletRequest request)	Retrieve the CORS configuration for the given handler.
protected Set<String>	getDirectPaths(T mapping)	Return the request mapping paths that are not patterns.
protected HandlerMethod	getHandlerInternal(HttpServletRequest request)	Look up a handler method for the given request.
Map<T,HandlerMethod>	getHandlerMethods()	Return a (read-only) map with all mappings and HandlerMethod's.
List<HandlerMethod>	getHandlerMethodsForMappingName(String mappingName)	Return the handler methods for the given mapping name.
protected abstract Comparator<T>	getMappingComparator(HttpServletRequest request)	Return a comparator for sorting matching mappings.
protected abstract T	getMappingForMethod(Method method, Class<?> handlerType)	Provide the mapping for a handler method.
protected Set<String>	getMappingPathPatterns(T mapping)	Deprecated. as of 5.3 in favor of providing non-pattern mappings via getDirectPaths(Object) instead
protected abstract T	getMatchingMapping(T mapping, HttpServletRequest request)	Check if a mapping matches the current request and return a (potentially new) mapping with conditions relevant to the current request.
HandlerMethodMappingNamingStrategy<T>	getNamingStrategy()	Return the configured naming strategy or null.
protected void	handleMatch(T mapping, String lookupPath, HttpServletRequest request)	Invoked when a matching mapping is found.
protected HandlerMethod	handleNoMatch(Set<T> mappings, String lookupPath, HttpServletRequest request)	Invoked when no matching mapping is not found.
protected void	handlerMethodsInitialized(Map<T,HandlerMethod> handlerMethods)	Invoked after all handler methods have been detected.
protected boolean	hasCorsConfigurationSource(Object handler)	Return true if there is a CorsConfigurationSource for this handler.
protected CorsConfiguration	initCorsConfiguration(Object handler, Method method, T mapping)	Extract and return the CORS configuration for the mapping.
protected void	initHandlerMethods()	Scan beans in the ApplicationContext, detect and register handler methods.
protected abstract boolean	isHandler(Class<?> beanType)	Whether the given type is a handler with handler methods.
protected HandlerMethod	lookupHandlerMethod(String lookupPath, HttpServletRequest request)	Look up the best-matching handler method for the current request.
protected void	processCandidateBean(String beanName)	Determine the type of the specified candidate bean and call detectHandlerMethods(java.lang.Object) if identified as a handler type.
protected void	registerHandlerMethod(Object handler, Method method, T mapping)	Register a handler method and its unique mapping.
void	registerMapping(T mapping, Object handler, Method method)	Register the given mapping.
void	setDetectHandlerMethodsInAncestorContexts(boolean detectHandlerMethodsInAncestorContexts)	Whether to detect handler methods in beans in ancestor ApplicationContexts.
void	setHandlerMethodMappingNamingStrategy(HandlerMethodMappingNamingStrategy<T> namingStrategy)	Configure the naming strategy to use for assigning a default name to every mapped handler method.
void	setPatternParser(PathPatternParser patternParser)	Set the PathPatternParser to parse patterns with for URL path matching.
void	unregisterMapping(T mapping)	Un-register the given mapping.

Methods inherited from class org.springframework.web.servlet.handler.AbstractHandlerMapping

adaptInterceptor, detectMappedInterceptors, extendInterceptors, formatMappingName, getAdaptedInterceptors, getCorsConfigurationSource, getCorsHandlerExecutionChain, getCorsProcessor, getDefaultHandler, getHandler, getHandlerExecutionChain, getMappedInterceptors, getOrder, getPathMatcher, getPatternParser, getUrlPathHelper, initApplicationContext, initInterceptors, initLookupPath, setAlwaysUseFullPath, setBeanName, setCorsConfigurations, setCorsConfigurationSource, setCorsProcessor, setDefaultHandler, setInterceptors, setOrder, setPathMatcher, setRemoveSemicolonContent, setUrlDecode, setUrlPathHelper, usesPathPatterns

Methods inherited from class org.springframework.web.context.support.WebApplicationObjectSupport

getServletContext, getTempDir, getWebApplicationContext, initApplicationContext, initServletContext, isContextRequired, setServletContext

Methods inherited from class org.springframework.context.support.ApplicationObjectSupport

getApplicationContext, getMessageSourceAccessor, obtainApplicationContext, requiredContextClass, setApplicationContext

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractHandlerMethodMapping

public AbstractHandlerMethodMapping()

Method Details

setPatternParser

public void setPatternParser(@Nullable
 PathPatternParser patternParser)

Description copied from class: AbstractHandlerMapping

Set the PathPatternParser to parse patterns with for URL path matching. Parsed patterns provide a more modern and efficient alternative to String path matching via AntPathMatcher.

Note: This property is mutually exclusive with the below properties, all of which are not necessary for parsed patterns and are ignored when a PathPatternParser is available:

• AbstractHandlerMapping.setAlwaysUseFullPath(boolean) -- parsed patterns always use the full path and consider the servletPath only when a Servlet is mapped by path prefix.
• AbstractHandlerMapping.setRemoveSemicolonContent(boolean) -- parsed patterns always ignore semicolon content for path matching purposes, but path parameters remain available for use in controllers via @MatrixVariable.
• AbstractHandlerMapping.setUrlDecode(boolean) -- parsed patterns match one decoded path segment at a time and therefore don't need to decode the full path.
• AbstractHandlerMapping.setUrlPathHelper(org.springframework.web.util.UrlPathHelper) -- for parsed patterns, the request path is parsed once in DispatcherServlet or in ServletRequestPathFilter using ServletRequestPathUtils and cached in a request attribute.
• AbstractHandlerMapping.setPathMatcher(org.springframework.util.PathMatcher) -- a parsed patterns encapsulates the logic for path matching and does need a PathMatcher.

By default, as of 6.0, this is set to a PathPatternParser instance with default settings and therefore use of parsed patterns is enabled. Set this to null to switch to String path matching via AntPathMatcher instead.

Overrides:

setPatternParser in class AbstractHandlerMapping

Parameters:

patternParser - the parser to use

setDetectHandlerMethodsInAncestorContexts

public void setDetectHandlerMethodsInAncestorContexts(boolean detectHandlerMethodsInAncestorContexts)

Whether to detect handler methods in beans in ancestor ApplicationContexts.

Default is "false": Only beans in the current ApplicationContext are considered, i.e. only in the context that this HandlerMapping itself is defined in (typically the current DispatcherServlet's context).

Switch this flag on to detect handler beans in ancestor contexts (typically the Spring root WebApplicationContext) as well.

See Also:

• getCandidateBeanNames()

setHandlerMethodMappingNamingStrategy

public void setHandlerMethodMappingNamingStrategy(HandlerMethodMappingNamingStrategy<