org.springframework.web.servlet.config.annotation

Class PathMatchConfigurer

java.lang.Object

org.springframework.web.servlet.config.annotation.PathMatchConfigurer

public class PathMatchConfigurer
extends Object

Helps with configuring HandlerMappings path matching options such as trailing slash match, suffix registration, path matcher and path helper.

Configured path matcher and path helper instances are shared for:

• RequestMappings
• ViewControllerMappings
• ResourcesMappings

Since:

4.0.3

Author:

Brian Clozel

See Also:

RequestMappingHandlerMapping, SimpleUrlHandlerMapping

Constructor Summary

Constructors

Constructor and Description
PathMatchConfigurer()

Method Summary

Modifier and Type	Method and Description
PathMatcher	getPathMatcher()
UrlPathHelper	getUrlPathHelper()
Boolean	isUseRegisteredSuffixPatternMatch()
Boolean	isUseSuffixPatternMatch()
Boolean	isUseTrailingSlashMatch()
PathMatchConfigurer	setPathMatcher(PathMatcher pathMatcher) Set the PathMatcher implementation to use for matching URL paths against registered URL patterns.
PathMatchConfigurer	setUrlPathHelper(UrlPathHelper urlPathHelper) Set the UrlPathHelper to use for resolution of lookup paths.
PathMatchConfigurer	setUseRegisteredSuffixPatternMatch(Boolean registeredSuffixPatternMatch) Whether suffix pattern matching should work only against path extensions explicitly registered when you configure content negotiation.
PathMatchConfigurer	setUseSuffixPatternMatch(Boolean suffixPatternMatch) Whether to use suffix pattern match (".*") when matching patterns to requests.
PathMatchConfigurer	setUseTrailingSlashMatch(Boolean trailingSlashMatch) Whether to match to URLs irrespective of the presence of a trailing slash.

Methods inherited from class java.lang.Object

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

Constructor Detail

PathMatchConfigurer

public PathMatchConfigurer()

Method Detail

setUseSuffixPatternMatch

public PathMatchConfigurer setUseSuffixPatternMatch(Boolean suffixPatternMatch)

Whether to use suffix pattern match (".*") when matching patterns to requests. If enabled a method mapped to "/users" also matches to "/users.*".

By default this is set to true.

See Also:

registeredSuffixPatternMatch

setUseTrailingSlashMatch

public PathMatchConfigurer setUseTrailingSlashMatch(Boolean trailingSlashMatch)

Whether to match to URLs irrespective of the presence of a trailing slash. If enabled a method mapped to "/users" also matches to "/users/".

The default value is true.

setUseRegisteredSuffixPatternMatch

public PathMatchConfigurer setUseRegisteredSuffixPatternMatch(Boolean registeredSuffixPatternMatch)

Whether suffix pattern matching should work only against path extensions explicitly registered when you configure content negotiation. This is generally recommended to reduce ambiguity and to avoid issues such as when a "." appears in the path for other reasons.

By default this is set to "false".

See Also:

WebMvcConfigurer.configureContentNegotiation(org.springframework.web.servlet.config.annotation.ContentNegotiationConfigurer)

setUrlPathHelper

public PathMatchConfigurer setUrlPathHelper(UrlPathHelper urlPathHelper)

Set the UrlPathHelper to use for resolution of lookup paths.

Use this to override the default UrlPathHelper with a custom subclass, or to share common UrlPathHelper settings across multiple HandlerMappings and MethodNameResolvers.

setPathMatcher

public PathMatchConfigurer setPathMatcher(PathMatcher pathMatcher)

Set the PathMatcher implementation to use for matching URL paths against registered URL patterns. Default is AntPathMatcher.

See Also:

AntPathMatcher

isUseSuffixPatternMatch

@Nullable
public Boolean isUseSuffixPatternMatch()

isUseTrailingSlashMatch

@Nullable
public Boolean isUseTrailingSlashMatch()

isUseRegisteredSuffixPatternMatch

@Nullable
public Boolean isUseRegisteredSuffixPatternMatch()

getUrlPathHelper

@Nullable
public UrlPathHelper getUrlPathHelper()

getPathMatcher

@Nullable
public PathMatcher getPathMatcher()