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 Details

  • 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.