|
||||||||||
| 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 |
|
| 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 expression
public RegexStringComparator(String expr,
int flags)
expr - a valid regular expressionflags - java.util.regex.Pattern flags| Method 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 ByteArrayComparablevalue - 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 DeserializationException
pbBytes - A pb serialized RegexStringComparator instance
RegexStringComparator made from bytes
DeserializationExceptiontoByteArray()
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||