org.apache.hadoop.hbase.filter

Class CompareFilter

java.lang.Object

org.apache.hadoop.hbase.filter.Filter

org.apache.hadoop.hbase.filter.FilterBase

org.apache.hadoop.hbase.filter.CompareFilter

Direct Known Subclasses:

DependentColumnFilter, FamilyFilter, QualifierFilter, RowFilter, ValueFilter

@InterfaceAudience.Public
public abstract class CompareFilter
extends org.apache.hadoop.hbase.filter.FilterBase

This is a generic filter to be used to filter by comparison. It takes an operator (equal, greater, not equal, etc) and a byte [] comparator.

To filter by row key, use RowFilter.

To filter by column family, use FamilyFilter.

To filter by column qualifier, use QualifierFilter.

To filter by value, use ValueFilter.

These filters can be wrapped with SkipFilter and WhileMatchFilter to add more control.

Multiple filters can be combined using FilterList.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.hbase.filter.Filter

Filter.ReturnCode

Field Summary

Fields

Modifier and Type	Field and Description
protected ByteArrayComparable	comparator
protected CompareOperator	op

Fields inherited from class org.apache.hadoop.hbase.filter.Filter

reversed

Constructor Summary

Constructors

Constructor and Description
CompareFilter(CompareOperator op, ByteArrayComparable comparator) Constructor.

Method Summary

Modifier and Type	Method and Description
protected boolean	compareFamily(CompareOperator op, ByteArrayComparable comparator, Cell cell)
protected boolean	compareQualifier(CompareOperator op, ByteArrayComparable comparator, Cell cell)
protected boolean	compareRow(CompareOperator op, ByteArrayComparable comparator, Cell cell)
protected boolean	compareValue(CompareOperator op, ByteArrayComparable comparator, Cell cell)
boolean	equals(Object obj)
static ArrayList<Object>	extractArguments(ArrayList<byte[]> filterArguments) Returns an array of heterogeneous objects
boolean	filterRowKey(Cell cell) Filters a row based on the row key.
ByteArrayComparable	getComparator() Returns the comparator
CompareOperator	getCompareOperator()
int	hashCode()
String	toString() Return filter's info for debugging and logging purpose.

Methods inherited from class org.apache.hadoop.hbase.filter.FilterBase

createFilterFromArguments, filterAllRemaining, filterRow, filterRowCells, getNextCellHint, hasFilterRow, isFamilyEssential, reset, toByteArray, transformCell

Methods inherited from class org.apache.hadoop.hbase.filter.Filter

filterCell, isReversed, parseFrom, setReversed

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

op

protected CompareOperator op

comparator

protected ByteArrayComparable comparator

Constructor Detail

CompareFilter

public CompareFilter(CompareOperator op,
                     ByteArrayComparable comparator)

Constructor.

Parameters:

op - the compare op for row matching

comparator - the comparator for row matching

Method Detail

getCompareOperator

public CompareOperator getCompareOperator()

getComparator

public ByteArrayComparable getComparator()

Returns the comparator

filterRowKey

public boolean filterRowKey(Cell cell)
                     throws IOException

Description copied from class: Filter

Filters a row based on the row key. If this returns true, the entire row will be excluded. If false, each KeyValue in the row will be passed to Filter.filterCell(Cell) below. If Filter.filterAllRemaining() returns true, then Filter.filterRowKey(Cell) should also return true. Concrete implementers can signal a failure condition in their code by throwing an IOException.

Overrides:

filterRowKey in class org.apache.hadoop.hbase.filter.FilterBase

Parameters:

cell - The first cell coming in the new row

Returns:

true, remove entire row, false, include the row (maybe).

Throws:

IOException - in case an I/O or an filter specific failure needs to be signaled.

compareRow

protected boolean compareRow(CompareOperator op,
                             ByteArrayComparable comparator,
                             Cell cell)

compareFamily

protected boolean compareFamily(CompareOperator op,
                                ByteArrayComparable comparator,
                                Cell cell)

compareQualifier

protected boolean compareQualifier(CompareOperator op,
                                   ByteArrayComparable comparator,
                                   Cell cell)

compareValue

protected boolean compareValue(CompareOperator op,
                               ByteArrayComparable comparator,
                               Cell cell)

extractArguments

public static ArrayList<Object> extractArguments(ArrayList<byte[]> filterArguments)

Returns an array of heterogeneous objects

toString

public String toString()

Description copied from class: org.apache.hadoop.hbase.filter.FilterBase

Return filter's info for debugging and logging purpose.

Overrides:

toString in class org.apache.hadoop.hbase.filter.FilterBase

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object