com.dawninfotek.logx.util

Class AntPathMatcher

java.lang.Object

com.dawninfotek.logx.util.AntPathMatcher

public class AntPathMatcher
extends java.lang.Object

PathMatcher implementation for Ant-style path patterns. The code is borrowed from Springframework Examples are provided below.

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

The mapping matches URLs using the following rules:

• ? matches one character
• * matches zero or more characters
• ** matches zero or more 'directories' in a path

Some examples:

• com/t?st.jsp - matches com/test.jsp but also com/tast.jsp or com/txst.jsp
• com/*.jsp - matches all .jsp files in the com directory
• com/**/test.jsp - matches all test.jsp files underneath the com path
• org/springframework/**/*.jsp - matches all .jsp files underneath the org/springframework path
• org/**/servlet/bla.jsp - matches org/springframework/servlet/bla.jsp but also org/springframework/testing/servlet/bla.jsp and org/servlet/bla.jsp

Since:

16.07.2003

Author:

Alef Arendsen, Juergen Hoeller, Rob Harrop

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_PATH_SEPARATOR Default path separator: "/"

Constructor Summary

Constructors

Constructor and Description
AntPathMatcher()

Method Summary

Modifier and Type	Method and Description
protected boolean	doMatch(java.lang.String pattern, java.lang.String path, boolean fullMatch) Actually match the given path against the given pattern.
java.lang.String	extractPathWithinPattern(java.lang.String pattern, java.lang.String path) Given a pattern and a full path, determine the pattern-mapped part.
boolean	isPattern(java.lang.String path)
boolean	match(java.lang.String pattern, java.lang.String path)
boolean	matchStart(java.lang.String pattern, java.lang.String path)
void	setPathSeparator(java.lang.String pathSeparator) Set the path separator to use for pattern parsing.
static java.lang.String[]	tokenizeToStringArray(java.lang.String str, java.lang.String delimiters) Tokenize the given String into a String array via a StringTokenizer.
static java.lang.String[]	tokenizeToStringArray(java.lang.String str, java.lang.String delimiters, boolean trimTokens, boolean ignoreEmptyTokens) Tokenize the given String into a String array via a StringTokenizer.
static java.lang.String[]	toStringArray(java.util.Collection collection) Copy the given Collection into a String array.

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 java.lang.String DEFAULT_PATH_SEPARATOR

Default path separator: "/"

See Also:

Constant Field Values

Constructor Detail

AntPathMatcher

public AntPathMatcher()

Method Detail

setPathSeparator

public void setPathSeparator(java.lang.String pathSeparator)

Set the path separator to use for pattern parsing. Default is "/", as in Ant.

isPattern

public boolean isPattern(java.lang.String path)

match

public boolean match(java.lang.String pattern,
                     java.lang.String path)

matchStart

public boolean matchStart(java.lang.String pattern,
                          java.lang.String path)

doMatch

protected boolean doMatch(java.lang.String pattern,
                          java.lang.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 java.lang.String extractPathWithinPattern(java.lang.String pattern,
                                                 java.lang.String path)

Given a pattern and a full path, determine the pattern-mapped part.

For example:

• '/docs/cvs/commit.html' and '/docs/cvs/commit.html -> ''
• '/docs/*' and '/docs/cvs/commit -> 'cvs/commit'
• '/docs/cvs/*.html' and '/docs/cvs/commit.html -> 'commit.html'
• '/docs/**' and '/docs/cvs/commit -> 'cvs/commit'
• '/docs/**\/*.html' and '/docs/cvs/commit.html -> 'cvs/commit.html'
• '/*.html' and '/docs/cvs/commit.html -> 'docs/cvs/commit.html'
• '*.html' and '/docs/cvs/commit.html -> '/docs/cvs/commit.html'
• '*' and '/docs/cvs/commit.html -> '/docs/cvs/commit.html'

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

tokenizeToStringArray

public static java.lang.String[] tokenizeToStringArray(java.lang.String str,
                                                       java.lang.String delimiters)

Tokenize the given String into a String array via a StringTokenizer. Trims tokens and omits empty tokens.

The given delimiters string is supposed to consist of any number of delimiter characters. Each of those characters can be used to separate tokens. A delimiter is always a single character; for multi-character delimiters, consider using delimitedListToStringArray

Parameters:

str - the String to tokenize

delimiters - the delimiter characters, assembled as String (each of those characters is individually considered as delimiter).

Returns:

an array of the tokens

See Also:

StringTokenizer, String.trim(), #delimitedListToStringArray

tokenizeToStringArray

public static java.lang.String[] tokenizeToStringArray(java.lang.String str,
                                                       java.lang.String delimiters,
                                                       boolean trimTokens,
                                                       boolean ignoreEmptyTokens)

Tokenize the given String into a String array via a StringTokenizer.

The given delimiters string is supposed to consist of any number of delimiter characters. Each of those characters can be used to separate tokens. A delimiter is always a single character; for multi-character delimiters, consider using delimitedListToStringArray

Parameters:

str - the String to tokenize

delimiters - the delimiter characters, assembled as String (each of those characters is individually considered as delimiter)

trimTokens - trim the tokens via String's trim

ignoreEmptyTokens - omit empty tokens from the result array (only applies to tokens that are empty after trimming; StringTokenizer will not consider subsequent delimiters as token in the first place).

Returns:

an array of the tokens (null if the input String was null)

See Also:

StringTokenizer, String.trim(), #delimitedListToStringArray

toStringArray

public static java.lang.String[] toStringArray(java.util.Collection collection)

Copy the given Collection into a String array. The Collection must contain String elements only.

Parameters:

collection - the Collection to copy

Returns:

the String array (null if the passed-in Collection was null)