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 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 qualifier, use QualifierFilter.

To filter by value, use SingleColumnValueFilter.

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

Modifier and Type	Class and Description
static class	CompareFilter.CompareOp Comparison operators.

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 CompareFilter.CompareOp	compareOp

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

reversed

Constructor Summary

Constructors

Constructor and Description
CompareFilter(CompareFilter.CompareOp compareOp, ByteArrayComparable comparator) Constructor.

Method Summary

Modifier and Type	Method and Description
protected boolean	compareFamily(CompareFilter.CompareOp compareOp, ByteArrayComparable comparator, Cell cell)
protected boolean	compareQualifier(CompareFilter.CompareOp compareOp, ByteArrayComparable comparator, Cell cell)
protected boolean	compareRow(CompareFilter.CompareOp compareOp, ByteArrayComparable comparator, Cell cell)
protected boolean	compareValue(CompareFilter.CompareOp compareOp, ByteArrayComparable comparator, Cell cell)
static ArrayList<Object>	extractArguments(ArrayList<byte[]> filterArguments)
boolean	filterRowKey(Cell cell) Filters a row based on the row key.
ByteArrayComparable	getComparator()
CompareFilter.CompareOp	getOperator()
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, filterRowKey, getNextCellHint, hasFilterRow, isFamilyEssential, reset, toByteArray, transformCell

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

filterKeyValue, isReversed, parseFrom, setReversed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

compareOp

protected CompareFilter.CompareOp compareOp

comparator

protected ByteArrayComparable comparator

Constructor Detail

CompareFilter

public CompareFilter(CompareFilter.CompareOp compareOp,
                     ByteArrayComparable comparator)

Constructor.

Parameters:

compareOp - the compare op for row matching

comparator - the comparator for row matching

Method Detail

getOperator

public CompareFilter.CompareOp getOperator()

Returns:

operator

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.filterKeyValue(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 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(CompareFilter.CompareOp compareOp,
                             ByteArrayComparable comparator,
                             Cell cell)

compareFamily

protected boolean compareFamily(CompareFilter.CompareOp compareOp,
                                ByteArrayComparable comparator,
                                Cell cell)

compareQualifier

protected boolean compareQualifier(CompareFilter.CompareOp compareOp,
                                   ByteArrayComparable comparator,
                                   Cell cell)

compareValue

protected boolean compareValue(CompareFilter.CompareOp compareOp,
                               ByteArrayComparable comparator,
                               Cell cell)

extractArguments

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

toString

public String toString()

Description copied from class: FilterBase

Return filter's info for debugging and logging purpose.

Overrides:

toString in class FilterBase