Package org.apache.juneau.utils

Class StringExpressionMatcher

java.lang.Object

org.apache.juneau.utils.StringExpressionMatcher

public class StringExpressionMatcher
extends Object

Utility class for matching strings against string expressions.

Supports the following string constructs:

• "foo" - Single arguments.
• "foo,bar,baz" - Multiple OR'ed arguments.
• "foo | bar | bqz" - Multiple OR'ed arguments, pipe syntax.
• "foo || bar || bqz" - Multiple OR'ed arguments, Java-OR syntax.
• "fo*" - Patterns including '*' and '?'.
• "fo* & *oo" - Multiple AND'ed arguments, ampersand syntax.
• "fo* && *oo" - Multiple AND'ed arguments, Java-AND syntax.
• "fo* || (*oo || bar)" - Parenthesis.

Notes:

• AND operations take precedence over OR operations (as expected).
• Whitespace is ignored.
• null or empty expressions always match as false.

See Also:

Constructor Summary

Constructors

Constructor	Description
StringExpressionMatcher(String expression)	Constructor.

Method Summary

Modifier and Type	Method	Description
Set<String>	getTokens()	Returns all the tokens used in this expression.
boolean	matches(String input)	Returns true if the specified string matches this expression.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

StringExpressionMatcher

public StringExpressionMatcher(String expression)
                        throws ParseException

Constructor.

Parameters:

expression - The string expression.

Throws:

ParseException - Malformed input encountered.

Method Details

matches

public boolean matches(String input)

Returns true if the specified string matches this expression.

Parameters:

input - The input string.

Returns:

true if the specified string matches this expression.
Always false if the string is null.

toString

public String toString()

Overrides:

toString in class Object

getTokens

public Set<String> getTokens()

Returns all the tokens used in this expression.

Returns:

All the tokens used in this expression.