org.springframework.security.web.util.matcher

Class RegexRequestMatcher

java.lang.Object

org.springframework.security.web.util.matcher.RegexRequestMatcher

All Implemented Interfaces:

RequestMatcher

public final class RegexRequestMatcher
extends java.lang.Object
implements RequestMatcher

Uses a regular expression to decide whether a supplied the URL of a supplied HttpServletRequest. Can also be configured to match a specific HTTP method. The match is performed against the servletPath + pathInfo + queryString of the request and is case-sensitive by default. Case-insensitive matching can be used by using the constructor which takes the caseInsensitive argument.

Since:

3.1

Constructor Summary

Constructors

Constructor and Description
RegexRequestMatcher(java.lang.String pattern, java.lang.String httpMethod) Creates a case-sensitive Pattern instance to match against the request.
RegexRequestMatcher(java.lang.String pattern, java.lang.String httpMethod, boolean caseInsensitive) As above, but allows setting of whether case-insensitive matching should be used.

Method Summary

Modifier and Type	Method and Description
boolean	matches(javax.servlet.http.HttpServletRequest request) Performs the match of the request URL (servletPath + pathInfo + queryString ) against the compiled pattern.

Methods inherited from class java.lang.Object

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

Constructor Detail

RegexRequestMatcher

public RegexRequestMatcher(java.lang.String pattern,
                           java.lang.String httpMethod)

Creates a case-sensitive Pattern instance to match against the request.

Parameters:

pattern - the regular expression to compile into a pattern.

httpMethod - the HTTP method to match. May be null to match all methods.

RegexRequestMatcher

public RegexRequestMatcher(java.lang.String pattern,
                           java.lang.String httpMethod,
                           boolean caseInsensitive)

As above, but allows setting of whether case-insensitive matching should be used.

Parameters:

pattern - the regular expression to compile into a pattern.

httpMethod - the HTTP method to match. May be null to match all methods.

caseInsensitive - if true, the pattern will be compiled with the Pattern.CASE_INSENSITIVE flag set.

Method Detail

matches

public boolean matches(javax.servlet.http.HttpServletRequest request)

Performs the match of the request URL (servletPath + pathInfo + queryString ) against the compiled pattern. If the query string is present, a question mark will be prepended.

Specified by:

matches in interface RequestMatcher

Parameters:

request - the request to match

Returns:

true if the pattern matches the URL, false otherwise.