org.apache.hadoop.hbase.io.encoding

Interface DataBlockEncoder.EncodedSeeker

All Known Implementing Classes:

AbstractDataBlockEncoder.AbstractEncodedSeeker, RowIndexSeekerV1

Enclosing interface:

DataBlockEncoder

public static interface DataBlockEncoder.EncodedSeeker

An interface which enable to seek while underlying data is encoded. It works on one HFileBlock, but it is reusable. See setCurrentBuffer(ByteBuff).

Method Summary

Modifier and Type	Method and Description
int	compareKey(CellComparator comparator, Cell key) Compare the given key against the current key
Cell	getCell()
Cell	getKey() From the current position creates a cell using the key part of the current buffer
ByteBuffer	getValueShallowCopy() Does a shallow copy of the value at the current position.
boolean	next() Move to next position
void	rewind() Set position to beginning of given block
int	seekToKeyInBlock(Cell key, boolean seekBefore) Moves the seeker position within the current block to: the last key that that is less than or equal to the given key if seekBefore is false the last key that is strictly less than the given key if seekBefore is true.
void	setCurrentBuffer(ByteBuff buffer) Set on which buffer there will be done seeking.

Method Detail

setCurrentBuffer

void setCurrentBuffer(ByteBuff buffer)

Set on which buffer there will be done seeking.

Parameters:

buffer - Used for seeking.

getKey

Cell getKey()

From the current position creates a cell using the key part of the current buffer

Returns:

key at current position

getValueShallowCopy

ByteBuffer getValueShallowCopy()

Does a shallow copy of the value at the current position. A shallow copy is possible because the returned buffer refers to the backing array of the original encoded buffer.

Returns:

value at current position

getCell

Cell getCell()

Returns:

the Cell at the current position. Includes memstore timestamp.

rewind

void rewind()

Set position to beginning of given block

next

boolean next()

Move to next position

Returns:

true on success, false if there is no more positions.

seekToKeyInBlock

int seekToKeyInBlock(Cell key,
                     boolean seekBefore)

Moves the seeker position within the current block to:

• the last key that that is less than or equal to the given key if seekBefore is false
• the last key that is strictly less than the given key if seekBefore is true. The caller is responsible for loading the previous block if the requested key turns out to be the first key of the current block.

Parameters:

key - - Cell to which the seek should happen

seekBefore - find the key strictly less than the given key in case of an exact match. Does not matter in case of an inexact match.

Returns:

0 on exact match, 1 on inexact match.

compareKey

int compareKey(CellComparator comparator,
               Cell key)

Compare the given key against the current key

Parameters:

comparator -

key -

Returns:

-1 is the passed key is smaller than the current key, 0 if equal and 1 if greater