Class RequestMappingHandlerMapping

java.lang.Object

org.springframework.context.support.ApplicationObjectSupport

org.springframework.web.reactive.handler.AbstractHandlerMapping

org.springframework.web.reactive.result.method.AbstractHandlerMethodMapping<RequestMappingInfo>

org.springframework.web.reactive.result.method.RequestMappingInfoHandlerMapping

org.springframework.web.reactive.result.method.annotation.RequestMappingHandlerMapping

All Implemented Interfaces:

Aware, BeanNameAware, InitializingBean, ApplicationContextAware, EmbeddedValueResolverAware, Ordered, HandlerMapping

public class RequestMappingHandlerMapping
extends RequestMappingInfoHandlerMapping
implements EmbeddedValueResolverAware

An extension of RequestMappingInfoHandlerMapping that creates RequestMappingInfo instances from type-level and method-level @RequestMapping and @HttpExchange annotations.

Since:

5.0

Author:

Rossen Stoyanchev, Sam Brannen, Olga Maciaszek-Sharma, Yongjun Hong

Field Summary

Fields inherited from class AbstractHandlerMapping

mappingsLogger

Fields inherited from class ApplicationObjectSupport

logger

Fields inherited from interface HandlerMapping

API_VERSION_ATTRIBUTE, BEST_MATCHING_HANDLER_ATTRIBUTE, BEST_MATCHING_PATTERN_ATTRIBUTE, MATRIX_VARIABLES_ATTRIBUTE, PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE, PRODUCIBLE_MEDIA_TYPES_ATTRIBUTE, URI_TEMPLATE_VARIABLES_ATTRIBUTE

Fields inherited from interface Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor	Description
RequestMappingHandlerMapping()

Method Summary

Modifier and Type	Method	Description
void	afterPropertiesSet()	Detects handler methods at initialization.
protected RequestMappingInfo	createRequestMappingInfo(RequestMapping requestMapping, @Nullable RequestCondition<?> customCondition)	Create a RequestMappingInfo from the supplied @RequestMapping annotation, meta-annotation, or synthesized result of merging annotation attributes within an annotation hierarchy.
protected RequestMappingInfo	createRequestMappingInfo(HttpExchange httpExchange, @Nullable RequestCondition<?> customCondition)	Create a RequestMappingInfo from the supplied @HttpExchange annotation, meta-annotation, or synthesized result of merging annotation attributes within an annotation hierarchy.
RequestedContentTypeResolver	getContentTypeResolver()	Return the configured RequestedContentTypeResolver.
protected @Nullable RequestCondition<?>	getCustomMethodCondition(Method method)	Protected method to provide a custom method-level request condition.
protected @Nullable RequestCondition<?>	getCustomTypeCondition(Class<?> handlerType)	Protected method to provide a custom type-level request condition.
protected @Nullable RequestMappingInfo	getMappingForMethod(Method method, Class<?> handlerType)	Uses type-level and method-level @RequestMapping and @HttpExchange annotations to create the RequestMappingInfo.
Map<String, Predicate<Class<?>>>	getPathPrefixes()	The configured path prefixes as a read-only, possibly empty map.
protected @Nullable CorsConfiguration	initCorsConfiguration(Object handler, Method method, RequestMappingInfo mappingInfo)	Extract and return the CORS configuration for the mapping.
protected boolean	isHandler(Class<?> beanType)	Whether the given type is a handler with handler methods.
protected void	registerHandlerMethod(Object handler, Method method, RequestMappingInfo mapping)	Register a handler method and its unique mapping.
void	registerMapping(RequestMappingInfo mapping, Object handler, Method method)	Register the given mapping.
protected String[]	resolveEmbeddedValuesInPatterns(String[] patterns)	Resolve placeholder values in the given array of patterns.
void	setContentTypeResolver(RequestedContentTypeResolver contentTypeResolver)	Set the RequestedContentTypeResolver to use to determine requested media types.
void	setEmbeddedValueResolver(StringValueResolver resolver)	Set the StringValueResolver to use for resolving embedded definition values.
void	setPathPrefixes(Map<String, Predicate<Class<?>>> prefixes)	Configure path prefixes to apply to controller methods.

Methods inherited from class RequestMappingInfoHandlerMapping

getDirectPaths, getHandlerInternal, getMappingComparator, getMatchingMapping, handleMatch, handleNoMatch

Methods inherited from class AbstractHandlerMethodMapping

createHandlerMethod, detectHandlerMethods, getCorsConfiguration, getHandlerMethods, handlerMethodsInitialized, hasCorsConfigurationSource, initHandlerMethods, lookupHandlerMethod, unregisterMapping

Methods inherited from class AbstractHandlerMapping

formatMappingName, getApiVersionStrategy, getCorsProcessor, getHandler, getOrder, getPathPatternParser, setApiVersionStrategy, setBeanName, setCorsConfigurations, setCorsConfigurationSource, setCorsProcessor, setOrder, setUseCaseSensitiveMatch

Methods inherited from class ApplicationObjectSupport

getApplicationContext, getMessageSourceAccessor, initApplicationContext, initApplicationContext, isContextRequired, obtainApplicationContext, requiredContextClass, setApplicationContext

Methods inherited from class Object

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

Constructor Details

RequestMappingHandlerMapping

public RequestMappingHandlerMapping()

Method Details

setPathPrefixes

public void setPathPrefixes(Map<String, Predicate<Class<?>>> prefixes)

Configure path prefixes to apply to controller methods.

Prefixes are used to enrich the mappings of every @RequestMapping method and @HttpExchange method whose controller type is matched by a corresponding Predicate in the map. The prefix for the first matching predicate is used, assuming the input map has predictable order.

Consider using HandlerTypePredicate to group controllers.

Parameters:

prefixes - a map with path prefixes as key

Since:

5.1

See Also:

• HandlerTypePredicate

getPathPrefixes

public Map<String, Predicate<Class<?>>> getPathPrefixes()

The configured path prefixes as a read-only, possibly empty map.

Since:

5.1

setContentTypeResolver

public void setContentTypeResolver(RequestedContentTypeResolver contentTypeResolver)

Set the RequestedContentTypeResolver to use to determine requested media types. If not set, the default constructor is used.

getContentTypeResolver

public RequestedContentTypeResolver getContentTypeResolver()

Return the configured RequestedContentTypeResolver.

setEmbeddedValueResolver

public void setEmbeddedValueResolver(StringValueResolver resolver)

Description copied from interface: EmbeddedValueResolverAware

Set the StringValueResolver to use for resolving embedded definition values.

Specified by:

setEmbeddedValueResolver in interface EmbeddedValueResolverAware

afterPropertiesSet

public void afterPropertiesSet()

Description copied from class: AbstractHandlerMethodMapping

Detects handler methods at initialization.

Specified by:

afterPropertiesSet in interface InitializingBean

Overrides:

afterPropertiesSet in class AbstractHandlerMethodMapping<RequestMappingInfo>

isHandler

protected boolean isHandler(Class<?> beanType)

Whether the given type is a handler with handler methods.

Expects a handler to have a type-level @Controller annotation.

Specified by:

isHandler in class AbstractHandlerMethodMapping<RequestMappingInfo>

Parameters:

beanType - the type of the bean being checked

Returns:

"true" if this a handler type, "false" otherwise.

getMappingForMethod

protected @Nullable RequestMappingInfo getMappingForMethod(Method method,
 Class<?> handlerType)

Uses type-level and method-level @RequestMapping and @HttpExchange annotations to create the RequestMappingInfo.

For CGLIB proxy classes, additional validation is performed based on method visibility:

• Private methods cannot be overridden and therefore cannot be used as handler methods.
• Package-private methods from different packages are inaccessible and must be changed to public or protected.

Specified by:

getMappingForMethod in class AbstractHandlerMethodMapping<RequestMappingInfo>

Parameters:

method - the method to provide a mapping for

handlerType - the handler type, possibly a subtype of the method's declaring class

Returns:

the created RequestMappingInfo, or null if the method does not have a @RequestMapping or @HttpExchange annotation

See Also:

• getCustomMethodCondition(Method)
• getCustomTypeCondition(Class)

getCustomTypeCondition

protected @Nullable RequestCondition<?> getCustomTypeCondition(Class<?> handlerType)

Protected method to provide a custom type-level request condition.

The custom RequestCondition can be of any type so long as the same condition type is returned from all calls to this method in order to ensure custom request conditions can be combined and compared.

Consider extending AbstractRequestCondition for custom condition types and using CompositeRequestCondition to provide multiple custom conditions.

Parameters:

handlerType - the handler type for which to create the condition

Returns:

the condition, or null

getCustomMethodCondition

protected @Nullable RequestCondition<?> getCustomMethodCondition(Method method)

Protected method to provide a custom method-level request condition.

The custom RequestCondition can be of any type so long as the same condition type is returned from all calls to this method in order to ensure custom request conditions can be combined and compared.

Consider extending AbstractRequestCondition for custom condition types and using CompositeRequestCondition to provide multiple custom conditions.

Parameters:

method - the handler method for which to create the condition

Returns:

the condition, or null

createRequestMappingInfo

protected RequestMappingInfo createRequestMappingInfo(RequestMapping requestMapping,
 @Nullable RequestCondition<?> customCondition)

Create a RequestMappingInfo from the supplied @RequestMapping annotation, meta-annotation, or synthesized result of merging annotation attributes within an annotation hierarchy.

createRequestMappingInfo

protected RequestMappingInfo createRequestMappingInfo(HttpExchange httpExchange,
 @Nullable RequestCondition<?> customCondition)

Create a RequestMappingInfo from the supplied @HttpExchange annotation, meta-annotation, or synthesized result of merging annotation attributes within an annotation hierarchy.

Since:

6.1

resolveEmbeddedValuesInPatterns

protected String[] resolveEmbeddedValuesInPatterns(String[] patterns)

Resolve placeholder values in the given array of patterns.

Returns:

a new array with updated patterns

registerMapping

public void registerMapping(RequestMappingInfo mapping,
 Object handler,
 Method method)

Description copied from class: AbstractHandlerMethodMapping

Register the given mapping.

This method may be invoked at runtime after initialization has completed.

Overrides:

registerMapping in class AbstractHandlerMethodMapping<RequestMappingInfo>

Parameters:

mapping - the mapping for the handler method

handler - the handler

method - the method

registerHandlerMethod

protected void registerHandlerMethod(Object handler,
 Method method,
 RequestMappingInfo mapping)

Description copied from class: AbstractHandlerMethodMapping

Register a handler method and its unique mapping. Invoked at startup for each detected handler method.

Overrides:

registerHandlerMethod in class AbstractHandlerMethodMapping<RequestMappingInfo>

Parameters:

handler - the bean name of the handler or the handler instance

method - the method to register

mapping - the mapping conditions associated with the handler method

initCorsConfiguration

protected @Nullable CorsConfiguration initCorsConfiguration(Object handler,
 Method method,
 RequestMappingInfo mappingInfo)

Description copied from class: AbstractHandlerMethodMapping

Extract and return the CORS configuration for the mapping.

Overrides:

initCorsConfiguration in class AbstractHandlerMethodMapping<RequestMappingInfo>