org.apache.hadoop.hbase.codec.prefixtree

Class PrefixTreeCodec

java.lang.Object

org.apache.hadoop.hbase.codec.prefixtree.PrefixTreeCodec

All Implemented Interfaces:

DataBlockEncoder

@InterfaceAudience.Private
public class PrefixTreeCodec
extends Object
implements DataBlockEncoder

This class is created via reflection in DataBlockEncoding enum. Update the enum if class name or package changes.

PrefixTreeDataBlockEncoder implementation of DataBlockEncoder. This is the primary entry point for PrefixTree encoding and decoding. Encoding is delegated to instances of PrefixTreeEncoder, and decoding is delegated to instances of CellSearcher. Encoder and decoder instances are created and recycled by static PtEncoderFactory and PtDecoderFactory.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.hadoop.hbase.io.encoding.DataBlockEncoder

DataBlockEncoder.EncodedSeeker

Constructor Summary

Constructors

Constructor and Description
PrefixTreeCodec() no-arg constructor for reflection

Method Summary

Methods

Modifier and Type	Method and Description
DataBlockEncoder.EncodedSeeker	createSeeker(KeyValue.KVComparator comparator, HFileBlockDecodingContext decodingCtx) Is this the correct handling of an illegal comparator? How to prevent that from getting all the way to this point.
ByteBuffer	decodeKeyValues(DataInputStream source, HFileBlockDecodingContext decodingCtx) Decode.
ByteBuffer	decodeKeyValues(DataInputStream source, int allocateHeaderLength, int skipLastBytes, HFileBlockDecodingContext decodingCtx) I don't think this method is called during normal HBase operation, so efficiency is not important.
void	encodeKeyValues(ByteBuffer in, HFileBlockEncodingContext blkEncodingCtx) Copied from BufferedDataBlockEncoder.
ByteBuffer	getFirstKeyInBlock(ByteBuffer block) Return first key in block.
HFileBlockDecodingContext	newDataBlockDecodingContext(HFileContext meta) Creates an encoder specific decoding context, which will prepare the data before actual decoding
HFileBlockEncodingContext	newDataBlockEncodingContext(DataBlockEncoding encoding, byte[] header, HFileContext meta) Creates a encoder specific encoding context

Methods inherited from class java.lang.Object

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

Constructor Detail

PrefixTreeCodec

public PrefixTreeCodec()

no-arg constructor for reflection

Method Detail

encodeKeyValues

public void encodeKeyValues(ByteBuffer in,
                   HFileBlockEncodingContext blkEncodingCtx)
                     throws IOException

Copied from BufferedDataBlockEncoder. Almost definitely can be improved, but i'm not familiar enough with the concept of the HFileBlockEncodingContext.

Specified by:

encodeKeyValues in interface DataBlockEncoder

Parameters:

in - Source of KeyValue for compression.

blkEncodingCtx - the encoding context which will contain encoded uncompressed bytes as well as compressed encoded bytes if compression is enabled, and also it will reuse resources across multiple calls.

Throws:

IOException - If there is an error writing to output stream.

decodeKeyValues

public ByteBuffer decodeKeyValues(DataInputStream source,
                         HFileBlockDecodingContext decodingCtx)
                           throws IOException

Description copied from interface: DataBlockEncoder

Decode.

Specified by:

decodeKeyValues in interface DataBlockEncoder

Parameters:

source - Compressed stream of KeyValues.

Returns:

Uncompressed block of KeyValues.

Throws:

IOException - If there is an error in source.

decodeKeyValues

public ByteBuffer decodeKeyValues(DataInputStream source,
                         int allocateHeaderLength,
                         int skipLastBytes,
                         HFileBlockDecodingContext decodingCtx)
                           throws IOException

I don't think this method is called during normal HBase operation, so efficiency is not important.

Throws:

IOException

getFirstKeyInBlock

public ByteBuffer getFirstKeyInBlock(ByteBuffer block)

Description copied from interface: DataBlockEncoder

Return first key in block. Useful for indexing. Typically does not make a deep copy but returns a buffer wrapping a segment of the actual block's byte array. This is because the first key in block is usually stored unencoded.

Specified by:

getFirstKeyInBlock in interface DataBlockEncoder

Parameters:

block - encoded block we want index, the position will not change

Returns:

First key in block.

newDataBlockEncodingContext

public HFileBlockEncodingContext newDataBlockEncodingContext(DataBlockEncoding encoding,
                                                    byte[] header,
                                                    HFileContext meta)

Description copied from interface: DataBlockEncoder

Creates a encoder specific encoding context

Specified by:

newDataBlockEncodingContext in interface DataBlockEncoder

Parameters:

encoding - encoding strategy used

header - header bytes to be written, put a dummy header here if the header is unknown

meta - HFile meta data

Returns:

a newly created encoding context

newDataBlockDecodingContext

public HFileBlockDecodingContext newDataBlockDecodingContext(HFileContext meta)

Description copied from interface: DataBlockEncoder

Creates an encoder specific decoding context, which will prepare the data before actual decoding

Specified by:

newDataBlockDecodingContext in interface DataBlockEncoder

Parameters:

meta - HFile meta data

Returns:

a newly created decoding context

createSeeker

public DataBlockEncoder.EncodedSeeker createSeeker(KeyValue.KVComparator comparator,
                                          HFileBlockDecodingContext decodingCtx)

Is this the correct handling of an illegal comparator? How to prevent that from getting all the way to this point.

Specified by:

createSeeker in interface DataBlockEncoder

Parameters:

comparator - what kind of comparison should be used

Returns:

A newly created seeker.