org.pac4j.core.matching

Class PathMatcher

java.lang.Object

org.pac4j.core.matching.PathMatcher

All Implemented Interfaces:

Matcher

Direct Known Subclasses:

ExcludedPathMatcher

public class PathMatcher
extends java.lang.Object
implements Matcher

Matches all request paths except whitelisted (excluded) paths.

Since:

2.0.0

Author:

Rob Ward

Constructor Summary

Constructors

Constructor and Description
PathMatcher()
PathMatcher(java.lang.String regexpPath)

Method Summary

Modifier and Type	Method and Description
PathMatcher	excludeBranch(java.lang.String path) Convenience method for excluding all paths starting with a prefix e.g.
PathMatcher	excludePath(java.lang.String path) Any path exactly matching this string will be excluded.
PathMatcher	excludeRegex(java.lang.String regex) Any path matching this regex will be excluded.
java.util.Set<java.lang.String>	getExcludedPaths()
java.util.Set<java.util.regex.Pattern>	getExcludedPatterns()
boolean	matches(WebContext context) Check if the web context matches.
void	setExcludedPaths(java.util.Collection<java.lang.String> paths)
void	setExcludedPatterns(java.util.Collection<java.lang.String> regularExpressions)

Methods inherited from class java.lang.Object

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

Constructor Detail

PathMatcher

public PathMatcher()

PathMatcher

public PathMatcher(java.lang.String regexpPath)

Method Detail

excludePath

public PathMatcher excludePath(java.lang.String path)

Any path exactly matching this string will be excluded. Use this method if you are excluding a specific path.

Parameters:

path - the path to be excluded

Returns:

this path matcher

excludeBranch

public PathMatcher excludeBranch(java.lang.String path)

Convenience method for excluding all paths starting with a prefix e.g. "/foo" would exclude "/foo", "/foo/bar", etc.

Parameters:

path - the prefix for the paths to be excluded

Returns:

this path matcher

excludeRegex

public PathMatcher excludeRegex(java.lang.String regex)

Any path matching this regex will be excluded.

Parameters:

regex - the regular expression matching the paths to be excluded

Returns:

this path matcher

matches

public boolean matches(WebContext context)

Description copied from interface: Matcher

Check if the web context matches.

Specified by:

matches in interface Matcher

Parameters:

context - the web context

Returns:

whether the web context matches

getExcludedPaths

public java.util.Set<java.lang.String> getExcludedPaths()

getExcludedPatterns

public java.util.Set<java.util.regex.Pattern> getExcludedPatterns()

setExcludedPaths

public void setExcludedPaths(java.util.Collection<java.lang.String> paths)

setExcludedPatterns

public void setExcludedPatterns(java.util.Collection<java.lang.String> regularExpressions)