## org.apache.lucene.search.regex
Class JavaUtilRegexCapabilities

    java.lang.Object
      org.apache.lucene.search.regex.JavaUtilRegexCapabilities

All Implemented Interfaces:
  RegexCapabilities

    public class JavaUtilRegexCapabilities

extends java.lang.Object
implements RegexCapabilities

An implementation tying Java's built-in java.util.regex to RegexQuery. Note that because this implementation currently only returns null from `prefix()` that queries using this implementation will enumerate and attempt to `match(java.lang.String)` each term for the specified field in the index.

Field Summary
`static int` `FLAG_CANON_EQ`
`static int` `FLAG_CASE_INSENSITIVE`
`static int` `FLAG_COMMENTS`
`static int` `FLAG_DOTALL`
`static int` `FLAG_LITERAL`
`static int` `FLAG_MULTILINE`
`static int` `FLAG_UNICODE_CASE`
`static int` `FLAG_UNIX_LINES`

Constructor Summary
`JavaUtilRegexCapabilities()` Default constructor that uses java.util.regex.Pattern with its default flags.
`JavaUtilRegexCapabilities(int flags)` Constructor that allows for the modification of the flags that the java.util.regex.Pattern will use to compile the regular expression.

Method Summary
`void` `compile(java.lang.String pattern)` Called by the constructor of `RegexTermEnum` allowing implementations to cache a compiled version of the regular expression pattern.
`boolean` `equals(java.lang.Object o)`
`int` `hashCode()`
`boolean` `match(java.lang.String string)`
`java.lang.String` `prefix()` A wise prefix implementation can reduce the term enumeration (and thus increase performance) of RegexQuery dramatically!

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### FLAG_CANON_EQ

    public static final int FLAG_CANON_EQ

See Also:
  Constant Field Values

### FLAG_CASE_INSENSITIVE

    public static final int FLAG_CASE_INSENSITIVE

See Also:
  Constant Field Values

### FLAG_COMMENTS

    public static final int FLAG_COMMENTS

See Also:
  Constant Field Values

### FLAG_DOTALL

    public static final int FLAG_DOTALL

See Also:
  Constant Field Values

### FLAG_LITERAL

    public static final int FLAG_LITERAL

See Also:
  Constant Field Values

### FLAG_MULTILINE

    public static final int FLAG_MULTILINE

See Also:
  Constant Field Values

### FLAG_UNICODE_CASE

    public static final int FLAG_UNICODE_CASE

See Also:
  Constant Field Values

### FLAG_UNIX_LINES

    public static final int FLAG_UNIX_LINES

See Also:
  Constant Field Values

Constructor Detail

### JavaUtilRegexCapabilities

    public JavaUtilRegexCapabilities()

  Default constructor that uses java.util.regex.Pattern with its default flags.

### JavaUtilRegexCapabilities

    public JavaUtilRegexCapabilities(int flags)

  Constructor that allows for the modification of the flags that the java.util.regex.Pattern will use to compile the regular expression. This gives the user the ability to fine-tune how the regular expression to match the functionality that they need. The `Pattern` class supports specifying these fields via the regular expression text itself, but this gives the caller another option to modify the behavior. Useful in cases where the regular expression text cannot be modified, or if doing so is undesired.

  Parameters:
    `flags` - The flags that are ORed together.

Method Detail

### compile

    public void compile(java.lang.String pattern)

  Description copied from interface: `RegexCapabilities`
  Called by the constructor of `RegexTermEnum` allowing implementations to cache a compiled version of the regular expression pattern.

  Specified by:
    `compile` in interface `RegexCapabilities`
  Parameters:
    `pattern` - regular expression pattern

### match

    public boolean match(java.lang.String string)

  Specified by:
    `match` in interface `RegexCapabilities`
  Returns:
    true if string matches the pattern last passed to `RegexCapabilities.compile(java.lang.String)`.

### prefix

    public java.lang.String prefix()

  Description copied from interface: `RegexCapabilities`
  A wise prefix implementation can reduce the term enumeration (and thus increase performance) of RegexQuery dramatically!

  Specified by:
    `prefix` in interface `RegexCapabilities`
  Returns:
    static non-regex prefix of the pattern last passed to `RegexCapabilities.compile(java.lang.String)`. May return null.

### equals

    public boolean equals(java.lang.Object o)

  Overrides:
    `equals` in class `java.lang.Object`

### hashCode

    public int hashCode()

  Overrides:
    `hashCode` in class `java.lang.Object`

Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.