org.apache.shiro.util
Class AntPathMatcher

java.lang.Object
  extended by org.apache.shiro.util.AntPathMatcher
All Implemented Interfaces:
PatternMatcher

public class AntPathMatcher
extends Object
implements PatternMatcher

PathMatcher implementation for Ant-style path patterns. Examples are provided below.

Part of this mapping code has been kindly borrowed from Apache Ant.

The mapping matches URLs using the following rules:

Some examples:

N.B.: This class was borrowed (with much appreciation) from the Spring Framework with modifications. We didn't want to reinvent the wheel of great work they've done, but also didn't want to force every Shiro user to depend on Spring

As per the Apache 2.0 license, the original copyright notice and all author and copyright information have remained in tact.

Since:
16.07.2003

Field Summary
static String DEFAULT_PATH_SEPARATOR
          Default path separator: "/"
 
Constructor Summary
AntPathMatcher()
           
 
Method Summary
protected  boolean doMatch(String pattern, String path, boolean fullMatch)
          Actually match the given path against the given pattern.
 String extractPathWithinPattern(String pattern, String path)
          Given a pattern and a full path, determine the pattern-mapped part.
 boolean isPattern(String path)
           
 boolean match(String pattern, String path)
           
 boolean matches(String pattern, String source)
          Returns true if the given source matches the specified pattern, false otherwise.
 boolean matchStart(String pattern, String path)
           
 void setPathSeparator(String pathSeparator)
          Set the path separator to use for pattern parsing.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_PATH_SEPARATOR

public static final String DEFAULT_PATH_SEPARATOR
Default path separator: "/"

See Also:
Constant Field Values
Constructor Detail

AntPathMatcher

public AntPathMatcher()
Method Detail

setPathSeparator

public void setPathSeparator(String pathSeparator)
Set the path separator to use for pattern parsing. Default is "/", as in Ant.


isPattern

public boolean isPattern(String path)

matches

public boolean matches(String pattern,
                       String source)
Description copied from interface: PatternMatcher
Returns true if the given source matches the specified pattern, false otherwise.

Specified by:
matches in interface PatternMatcher
Parameters:
pattern - the pattern to match against
source - the source to match
Returns:
true if the given source matches the specified pattern, false otherwise.

match

public boolean match(String pattern,
                     String path)

matchStart

public boolean matchStart(String pattern,
                          String path)

doMatch

protected boolean doMatch(String pattern,
                          String path,
                          boolean fullMatch)
Actually match the given path against the given pattern.

Parameters:
pattern - the pattern to match against
path - the path String to test
fullMatch - whether a full pattern match is required (else a pattern match as far as the given base path goes is sufficient)
Returns:
true if the supplied path matched, false if it didn't

extractPathWithinPattern

public String extractPathWithinPattern(String pattern,
                                       String path)
Given a pattern and a full path, determine the pattern-mapped part.

For example:

Assumes that match(java.lang.String, java.lang.String) returns true for 'pattern' and 'path', but does not enforce this.



Copyright © 2004-2012 The Apache Software Foundation. All Rights Reserved.