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

@InterfaceAudience.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 and Description
	SingleColumnValueExcludeFilter(byte[] family, byte[] qualifier, CompareFilter.CompareOp compareOp, byte[] value) Deprecated.
	SingleColumnValueExcludeFilter(byte[] family, byte[] qualifier, CompareFilter.CompareOp compareOp, ByteArrayComparable comparator) Deprecated. Since 2.0.0. Will be removed in 3.0.0. Use SingleColumnValueExcludeFilter(byte[], byte[], CompareOperator, ByteArrayComparable)
protected	SingleColumnValueExcludeFilter(byte[] family, byte[] qualifier, CompareFilter.CompareOp compareOp, ByteArrayComparable comparator, boolean filterIfMissing, boolean latestVersionOnly) Deprecated. Since 2.0.0. Will be removed in 3.0.0. Use SingleColumnValueExcludeFilter(byte[], byte[], CompareOperator, ByteArrayComparable, boolean, boolean)
	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 and Description
(package private) boolean	areSerializedFieldsEqual(Filter o) Default implementation so that writers of custom filters aren't forced to implement.
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() Fitlers that never filter by modifying the returned List of Cells can inherit this implementation that does nothing.
int	hashCode()
static SingleColumnValueExcludeFilter	parseFrom(byte[] pbBytes)
byte[]	toByteArray() Return length 0 byte array for Filters that don't require special serialization

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

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

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

filterAllRemaining, filterRowKey, 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 Detail

SingleColumnValueExcludeFilter

@Deprecated
public SingleColumnValueExcludeFilter(byte[] family,
                                                  byte[] qualifier,
                                                  CompareFilter.CompareOp compareOp,
                                                  byte[] value)

Deprecated.

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

compareOp - operator

value - value to compare column values against SingleColumnValueExcludeFilter(byte[], byte[], CompareOperator, byte[])

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

@Deprecated
public SingleColumnValueExcludeFilter(byte[] family,
                                                  byte[] qualifier,
                                                  CompareFilter.CompareOp compareOp,
                                                  ByteArrayComparable comparator)

Deprecated. Since 2.0.0. Will be removed in 3.0.0. Use SingleColumnValueExcludeFilter(byte[], byte[], CompareOperator, ByteArrayComparable)

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

compareOp - operator

comparator - Comparator to use.

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

@Deprecated
protected SingleColumnValueExcludeFilter(byte[] family,
                                                     byte[] qualifier,
                                                     CompareFilter.CompareOp compareOp,
                                                     ByteArrayComparable comparator,
                                                     boolean filterIfMissing,
                                                     boolean latestVersionOnly)

Deprecated. Since 2.0.0. Will be removed in 3.0.0. Use SingleColumnValueExcludeFilter(byte[], byte[], CompareOperator, ByteArrayComparable, boolean, boolean)

Constructor for protobuf deserialization only.

Parameters:

family -

qualifier -

compareOp -

comparator -

filterIfMissing -

latestVersionOnly -

SingleColumnValueExcludeFilter

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

Constructor for protobuf deserialization only.

Parameters:

family -

qualifier -

op -

comparator -

filterIfMissing -

latestVersionOnly -

Method Detail

hasFilterRow

public boolean hasFilterRow()

Description copied from class: FilterBase

Fitlers 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()

Description copied from class: FilterBase

Return length 0 byte array for Filters that don't require special serialization

Overrides:

toByteArray in class SingleColumnValueFilter

Returns:

The filter serialized using pb

parseFrom

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

Parameters:

pbBytes - A pb serialized SingleColumnValueExcludeFilter instance

Returns:

An instance of SingleColumnValueExcludeFilter made from bytes

Throws:

DeserializationException

See Also:

toByteArray()

areSerializedFieldsEqual

boolean areSerializedFieldsEqual(Filter o)

Description copied from class: FilterBase

Default implementation so that writers of custom filters aren't forced to implement.

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