|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.hadoop.hbase.filter.ByteArrayComparable
org.apache.hadoop.hbase.filter.RegexStringComparator
@InterfaceAudience.Public @InterfaceStability.Stable public class RegexStringComparator
This comparator is for use with CompareFilter
implementations, such
as RowFilter
, QualifierFilter
, and ValueFilter
, for
filtering based on the value of a given column. Use it to test if a given
regular expression matches a cell value in the column.
Only EQUAL or NOT_EQUAL comparisons are valid with this comparator.
For example:
ValueFilter vf = new ValueFilter(CompareOp.EQUAL, new RegexStringComparator( // v4 IP address "(((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3,3}" + "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))(\\/[0-9]+)?" + "|" + // v6 IP address "((([\\dA-Fa-f]{1,4}:){7}[\\dA-Fa-f]{1,4})(:([\\d]{1,3}.)" + "{3}[\\d]{1,3})?)(\\/[0-9]+)?"));
Supports Pattern
flags as well:
ValueFilter vf = new ValueFilter(CompareOp.EQUAL, new RegexStringComparator("regex", Pattern.CASE_INSENSITIVE | Pattern.DOTALL));
Pattern
Constructor Summary | |
---|---|
RegexStringComparator(String expr)
Constructor Adds Pattern.DOTALL to the underlying Pattern |
|
RegexStringComparator(String expr,
int flags)
Constructor |
|
RegexStringComparator(String expr,
int flags,
org.apache.hadoop.hbase.filter.RegexStringComparator.EngineType engine)
Constructor |
|
RegexStringComparator(String expr,
org.apache.hadoop.hbase.filter.RegexStringComparator.EngineType engine)
Constructor Adds Pattern.DOTALL to the underlying Pattern |
Method Summary | |
---|---|
int |
compareTo(byte[] value,
int offset,
int length)
Special compareTo method for subclasses, to avoid copying byte[] unnecessarily. |
static RegexStringComparator |
parseFrom(byte[] pbBytes)
|
void |
setCharset(Charset charset)
Specifies the Charset to use to convert the row key to a String. |
byte[] |
toByteArray()
|
Methods inherited from class org.apache.hadoop.hbase.filter.ByteArrayComparable |
---|
compareTo, getValue |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public RegexStringComparator(String expr)
expr
- a valid regular expressionpublic RegexStringComparator(String expr, org.apache.hadoop.hbase.filter.RegexStringComparator.EngineType engine)
expr
- a valid regular expressionengine
- engine implementation typepublic RegexStringComparator(String expr, int flags)
expr
- a valid regular expressionflags
- java.util.regex.Pattern flagspublic RegexStringComparator(String expr, int flags, org.apache.hadoop.hbase.filter.RegexStringComparator.EngineType engine)
expr
- a valid regular expressionflags
- java.util.regex.Pattern flagsengine
- engine implementation typeMethod Detail |
---|
public void setCharset(Charset charset)
Charset
to use to convert the row key to a String.
The row key needs to be converted to a String in order to be matched against the regular expression. This method controls which charset is used to do this conversion.
If the row key is made of arbitrary bytes, the charset ISO-8859-1
is recommended.
charset
- The charset to use.public int compareTo(byte[] value, int offset, int length)
ByteArrayComparable
compareTo
in class ByteArrayComparable
value
- byte[] to compareoffset
- offset into valuelength
- number of bytes to compare
public byte[] toByteArray()
toByteArray
in class ByteArrayComparable
public static RegexStringComparator parseFrom(byte[] pbBytes) throws org.apache.hadoop.hbase.exceptions.DeserializationException
pbBytes
- A pb serialized RegexStringComparator
instance
RegexStringComparator
made from bytes
org.apache.hadoop.hbase.exceptions.DeserializationException
toByteArray()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |