Package org.apache.hadoop.hbase.filter

Class SingleColumnValueExcludeFilter

java.lang.Object

org.apache.hadoop.hbase.filter.Filter

org.apache.hadoop.hbase.filter.FilterBase

org.apache.hadoop.hbase.filter.SingleColumnValueFilter

org.apache.hadoop.hbase.filter.SingleColumnValueExcludeFilter

@Public
public class SingleColumnValueExcludeFilter
extends SingleColumnValueFilter

A Filter that checks a single column value, but does not emit the tested column. This will enable a performance boost over SingleColumnValueFilter, if the tested column value is not actually needed as input (besides for the filtering itself).

Nested Class Summary

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

Filter.ReturnCode

Field Summary

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

columnFamily, columnQualifier, comparator, filterIfMissing, foundColumn, latestVersionOnly, matchedColumn, op

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

reversed

Constructor Summary

Constructors

Modifier	Constructor	Description
	SingleColumnValueExcludeFilter(byte[] family, byte[] qualifier, CompareOperator op, byte[] value)	Constructor for binary compare of the value of a single column.
	SingleColumnValueExcludeFilter(byte[] family, byte[] qualifier, CompareOperator op, ByteArrayComparable comparator)	Constructor for binary compare of the value of a single column.
protected	SingleColumnValueExcludeFilter(byte[] family, byte[] qualifier, CompareOperator op, ByteArrayComparable comparator, boolean filterIfMissing, boolean latestVersionOnly)	Constructor for protobuf deserialization only.

Method Summary

Modifier and Type	Method	Description
(package private) boolean	areSerializedFieldsEqual(Filter o)	Returns true if and only if the fields of the filter that are serialized are equal to the corresponding fields in other.
static Filter	createFilterFromArguments(ArrayList<byte[]> filterArguments)
boolean	equals(Object obj)
void	filterRowCells(List<Cell> kvs)	Filters that never filter by modifying the returned List of Cells can inherit this implementation that does nothing.
boolean	hasFilterRow()	Filters that never filter by modifying the returned List of Cells can inherit this implementation that does nothing.
int	hashCode()
static SingleColumnValueExcludeFilter	parseFrom(byte[] pbBytes)	Parse a serialized representation of SingleColumnValueExcludeFilter
byte[]	toByteArray()	Returns The filter serialized using pb

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

convert, filterCell, filterRow, filterRowKey, getComparator, getCompareOperator, getFamily, getFilterIfMissing, getLatestVersionOnly, getQualifier, isFamilyEssential, reset, setFilterIfMissing, setLatestVersionOnly, toString

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

filterAllRemaining, getNextCellHint, transformCell

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

isReversed, setReversed

Methods inherited from class java.lang.Object

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

Constructor Details

SingleColumnValueExcludeFilter

public SingleColumnValueExcludeFilter(byte[] family,
 byte[] qualifier,
 CompareOperator op,
 byte[] value)

Constructor for binary compare of the value of a single column. If the column is found and the condition passes, all columns of the row will be emitted; except for the tested column value. If the column is not found or the condition fails, the row will not be emitted.

Parameters:

family - name of column family

qualifier - name of column qualifier

op - operator

value - value to compare column values against

SingleColumnValueExcludeFilter

public SingleColumnValueExcludeFilter(byte[] family,
 byte[] qualifier,
 CompareOperator op,
 ByteArrayComparable comparator)

Constructor for binary compare of the value of a single column. If the column is found and the condition passes, all columns of the row will be emitted; except for the tested column value. If the condition fails, the row will not be emitted.

Use the filterIfColumnMissing flag to set whether the rest of the columns in a row will be emitted if the specified column to check is not found in the row.

Parameters:

family - name of column family

qualifier - name of column qualifier

op - operator

comparator - Comparator to use.

SingleColumnValueExcludeFilter

protected SingleColumnValueExcludeFilter(byte[] family,
 byte[] qualifier,
 CompareOperator op,
 ByteArrayComparable comparator,
 boolean filterIfMissing,
 boolean latestVersionOnly)

Constructor for protobuf deserialization only.

Method Details

hasFilterRow

public boolean hasFilterRow()

Description copied from class: FilterBase

Filters that never filter by modifying the returned List of Cells can inherit this implementation that does nothing. Primarily used to check for conflicts with scans(such as scans that do not read a full row at a time).

Overrides:

hasFilterRow in class SingleColumnValueFilter

Returns:

True if this filter actively uses filterRowCells(List) or filterRow().

filterRowCells

public void filterRowCells(List<Cell> kvs)

Description copied from class: FilterBase

Filters that never filter by modifying the returned List of Cells can inherit this implementation that does nothing. Chance to alter the list of Cells to be submitted. Modifications to the list will carry on Concrete implementers can signal a failure condition in their code by throwing an IOException.

Overrides:

filterRowCells in class FilterBase

Parameters:

kvs - the list of Cells to be filtered

createFilterFromArguments

public static Filter createFilterFromArguments(ArrayList<byte[]> filterArguments)

toByteArray

public byte[] toByteArray()

Returns The filter serialized using pb

Overrides:

toByteArray in class SingleColumnValueFilter

Returns:

The filter serialized using pb

parseFrom

public static SingleColumnValueExcludeFilter parseFrom(byte[] pbBytes)
                                                throws DeserializationException

Parse a serialized representation of SingleColumnValueExcludeFilter

Parameters:

pbBytes - A pb serialized SingleColumnValueExcludeFilter instance

Returns:

An instance of SingleColumnValueExcludeFilter made from bytes

Throws:

DeserializationException - if an error occurred

See Also:

• toByteArray()

areSerializedFieldsEqual

boolean areSerializedFieldsEqual(Filter o)

Returns true if and only if the fields of the filter that are serialized are equal to the corresponding fields in other. Used for testing.

Overrides:

areSerializedFieldsEqual in class SingleColumnValueFilter

Returns:

true if and only if the fields of the filter that are serialized are equal to the corresponding fields in other. Used for testing.

equals

public boolean equals(Object obj)

Overrides:

equals in class SingleColumnValueFilter

hashCode

public int hashCode()

Overrides:

hashCode in class SingleColumnValueFilter