org.springframework.security.config.annotation.web

Class AbstractRequestMatcherRegistry<C>

java.lang.Object

org.springframework.security.config.annotation.web.AbstractRequestMatcherRegistry<C>

Type Parameters:

C - The object that is returned or Chained after creating the RequestMatcher

Direct Known Subclasses:

AbstractConfigAttributeRequestMatcherRegistry, HttpSecurity.RequestMatcherConfigurer, WebSecurity.IgnoredRequestConfigurer

public abstract class AbstractRequestMatcherRegistry<C>
extends java.lang.Object

A base class for registering RequestMatcher's. For example, it might allow for specifying which RequestMatcher require a certain level of authorization.

Since:

3.2

Constructor Summary

Constructors

Constructor and Description
AbstractRequestMatcherRegistry()

Method Summary

Modifier and Type	Method and Description
C	antMatchers(org.springframework.http.HttpMethod method) Maps a List of AntPathRequestMatcher instances.
C	antMatchers(org.springframework.http.HttpMethod method, java.lang.String... antPatterns) Maps a List of AntPathRequestMatcher instances.
C	antMatchers(java.lang.String... antPatterns) Maps a List of AntPathRequestMatcher instances that do not care which HttpMethod is used.
C	anyRequest() Maps any request.
protected abstract C	chainRequestMatchers(java.util.List<RequestMatcher> requestMatchers) Subclasses should implement this method for returning the object that is chained to the creation of the RequestMatcher instances.
protected java.util.List<MvcRequestMatcher>	createMvcMatchers(org.springframework.http.HttpMethod method, java.lang.String... mvcPatterns) Creates MvcRequestMatcher instances for the method and patterns passed in
protected org.springframework.context.ApplicationContext	getApplicationContext() Gets the ApplicationContext
abstract C	mvcMatchers(org.springframework.http.HttpMethod method, java.lang.String... mvcPatterns) Maps an MvcRequestMatcher that also specifies a specific HttpMethod to match on.
abstract C	mvcMatchers(java.lang.String... mvcPatterns) Maps an MvcRequestMatcher that does not care which HttpMethod is used.
C	regexMatchers(org.springframework.http.HttpMethod method, java.lang.String... regexPatterns) Maps a List of RegexRequestMatcher instances.
C	regexMatchers(java.lang.String... regexPatterns) Create a List of RegexRequestMatcher instances that do not specify an HttpMethod.
C	requestMatchers(RequestMatcher... requestMatchers) Associates a list of RequestMatcher instances with the AbstractConfigAttributeRequestMatcherRegistry
protected void	setApplicationContext(org.springframework.context.ApplicationContext context)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRequestMatcherRegistry

public AbstractRequestMatcherRegistry()

Method Detail

setApplicationContext

protected final void setApplicationContext(org.springframework.context.ApplicationContext context)

getApplicationContext

protected final org.springframework.context.ApplicationContext getApplicationContext()

Gets the ApplicationContext

Returns:

the ApplicationContext

anyRequest

public C anyRequest()

Maps any request.

Returns:

the object that is chained after creating the RequestMatcher

antMatchers

public C antMatchers(org.springframework.http.HttpMethod method)

Maps a List of AntPathRequestMatcher instances.

Parameters:

method - the HttpMethod to use for any HttpMethod.

Returns:

the object that is chained after creating the RequestMatcher

antMatchers

public C antMatchers(org.springframework.http.HttpMethod method,
                     java.lang.String... antPatterns)

Maps a List of AntPathRequestMatcher instances.

Parameters:

method - the HttpMethod to use or null for any HttpMethod.

antPatterns - the ant patterns to create. If null or empty, then matches on nothing. AntPathRequestMatcher from

Returns:

the object that is chained after creating the RequestMatcher

antMatchers

public C antMatchers(java.lang.String... antPatterns)

Maps a List of AntPathRequestMatcher instances that do not care which HttpMethod is used.

Parameters:

antPatterns - the ant patterns to create AntPathRequestMatcher from

Returns:

the object that is chained after creating the RequestMatcher

mvcMatchers

public abstract C mvcMatchers(java.lang.String... mvcPatterns)

Maps an MvcRequestMatcher that does not care which HttpMethod is used. This matcher will use the same rules that Spring MVC uses for matching. For example, often times a mapping of the path "/path" will match on "/path", "/path/", "/path.html", etc.

If the current request will not be processed by Spring MVC, a reasonable default using the pattern as a ant pattern will be used.

Parameters:

mvcPatterns - the patterns to match on. The rules for matching are defined by Spring MVC

Returns:

the object that is chained after creating the RequestMatcher.

mvcMatchers

public abstract C mvcMatchers(org.springframework.http.HttpMethod method,
                              java.lang.String... mvcPatterns)

Maps an MvcRequestMatcher that also specifies a specific HttpMethod to match on. This matcher will use the same rules that Spring MVC uses for matching. For example, often times a mapping of the path "/path" will match on "/path", "/path/", "/path.html", etc.

If the current request will not be processed by Spring MVC, a reasonable default using the pattern as a ant pattern will be used.

Parameters:

method - the HTTP method to match on

mvcPatterns - the patterns to match on. The rules for matching are defined by Spring MVC

Returns:

the object that is chained after creating the RequestMatcher.

createMvcMatchers

protected final java.util.List<MvcRequestMatcher> createMvcMatchers(org.springframework.http.HttpMethod method,
                                                                    java.lang.String... mvcPatterns)

Creates MvcRequestMatcher instances for the method and patterns passed in

Parameters:

method - the HTTP method to use or null if any should be used

mvcPatterns - the Spring MVC patterns to match on

Returns:

a List of MvcRequestMatcher instances

regexMatchers

public C regexMatchers(org.springframework.http.HttpMethod method,
                       java.lang.String... regexPatterns)

Maps a List of RegexRequestMatcher instances.

Parameters:

method - the HttpMethod to use or null for any HttpMethod.

regexPatterns - the regular expressions to create RegexRequestMatcher from

Returns:

the object that is chained after creating the RequestMatcher

regexMatchers

public C regexMatchers(java.lang.String... regexPatterns)

Create a List of RegexRequestMatcher instances that do not specify an HttpMethod.

Parameters:

regexPatterns - the regular expressions to create RegexRequestMatcher from

Returns:

the object that is chained after creating the RequestMatcher

requestMatchers

public C requestMatchers(RequestMatcher... requestMatchers)

Associates a list of RequestMatcher instances with the AbstractConfigAttributeRequestMatcherRegistry

Parameters:

requestMatchers - the RequestMatcher instances

Returns:

the object that is chained after creating the RequestMatcher

chainRequestMatchers

protected abstract C chainRequestMatchers(java.util.List<RequestMatcher> requestMatchers)

Subclasses should implement this method for returning the object that is chained to the creation of the RequestMatcher instances.

Parameters:

requestMatchers - the RequestMatcher instances that were created

Returns:

the chained Object for the subclass which allows association of something else to the RequestMatcher