PrefixTreeCodec (Apache HBase 1.2.12 API)

java.lang.Object
- org.apache.hadoop.hbase.codec.prefixtree.PrefixTreeCodec

All Implemented Interfaces:

DataBlockEncoder

Deprecated.
Since 1.2.7. Will be removed in 2.0.0. Write the dev list if you would like to take on the maintainence of this facility.
```
@Deprecated
@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
Modifier and Type Class and Description

private static class PrefixTreeCodec.PrefixTreeEncodingState
Deprecated.
- Nested classes/interfaces inherited from interface org.apache.hadoop.hbase.io.encoding.DataBlockEncoder
  DataBlockEncoder.EncodedSeeker

Nested Classes
Modifier and Type	Class and Description
`private static class`	`PrefixTreeCodec.PrefixTreeEncodingState` Deprecated.

Constructor Summary

Constructors
Constructor and Description

PrefixTreeCodec()
Deprecated.

no-arg constructor for reflection

Constructors
Constructor and Description
`PrefixTreeCodec()` Deprecated. no-arg constructor for reflection

Method Summary

Methods
Modifier and Type	Method and Description
`DataBlockEncoder.EncodedSeeker`	`createSeeker(KeyValue.KVComparator comparator, HFileBlockDecodingContext decodingCtx)` Deprecated. 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)` Deprecated. Decode.
`ByteBuffer`	`decodeKeyValues(DataInputStream source, int allocateHeaderLength, int skipLastBytes, HFileBlockDecodingContext decodingCtx)` Deprecated. I don't think this method is called during normal HBase operation, so efficiency is not important.
`int`	`encode(Cell cell, HFileBlockEncodingContext encodingCtx, DataOutputStream out)` Deprecated. Encodes a KeyValue.
`void`	`endBlockEncoding(HFileBlockEncodingContext encodingCtx, DataOutputStream out, byte[] uncompressedBytesWithHeader)` Deprecated. Ends encoding for a block of KeyValues.
`ByteBuffer`	`getFirstKeyInBlock(ByteBuffer block)` Deprecated. Return first key in block.
`HFileBlockDecodingContext`	`newDataBlockDecodingContext(HFileContext meta)` Deprecated. Creates an encoder specific decoding context, which will prepare the data before actual decoding
`HFileBlockEncodingContext`	`newDataBlockEncodingContext(DataBlockEncoding encoding, byte[] header, HFileContext meta)` Deprecated. Creates a encoder specific encoding context
`void`	`startBlockEncoding(HFileBlockEncodingContext blkEncodingCtx, DataOutputStream out)` Deprecated. Starts encoding for a block of KeyValues.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - PrefixTreeCodec
```
public PrefixTreeCodec()
```
    Deprecated.
    
    no-arg constructor for reflection
- Method Detail
  - decodeKeyValues
```
public ByteBuffer decodeKeyValues(DataInputStream source,
                         HFileBlockDecodingContext decodingCtx)
                           throws IOException
```
    Deprecated.
    
    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
```
    Deprecated.
    
    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)
```
    Deprecated.
    
    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)
```
    Deprecated.
    
    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)
```
    Deprecated.
    
    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)
```
    Deprecated.
    
    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.
  - encode
```
public int encode(Cell cell,
         HFileBlockEncodingContext encodingCtx,
         DataOutputStream out)
           throws IOException
```
    Deprecated.
    
    Description copied from interface: DataBlockEncoder
    
    Encodes a KeyValue.
    
    Specified by:
    
    encode in interface DataBlockEncoder
    
    Returns:
    unencoded kv size written
    
    Throws:
    
    IOException
  - startBlockEncoding
```
public void startBlockEncoding(HFileBlockEncodingContext blkEncodingCtx,
                      DataOutputStream out)
                        throws IOException
```
    Deprecated.
    
    Description copied from interface: DataBlockEncoder
    
    Starts encoding for a block of KeyValues. Call DataBlockEncoder.endBlockEncoding(HFileBlockEncodingContext, DataOutputStream, byte[]) to finish encoding of a block.
    
    Specified by:
    
    startBlockEncoding in interface DataBlockEncoder
    
    Throws:
    
    IOException
  - endBlockEncoding
```
public void endBlockEncoding(HFileBlockEncodingContext encodingCtx,
                    DataOutputStream out,
                    byte[] uncompressedBytesWithHeader)
                      throws IOException
```
    Deprecated.
    
    Description copied from interface: DataBlockEncoder
    
    Ends encoding for a block of KeyValues. Gives a chance for the encoder to do the finishing stuff for the encoded block. It must be called at the end of block encoding.
    
    Specified by:
    
    endBlockEncoding in interface DataBlockEncoder
    
    Throws:
    
    IOException

Class PrefixTreeCodec

Nested Class Summary

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PrefixTreeCodec

Method Detail

decodeKeyValues

decodeKeyValues

getFirstKeyInBlock

newDataBlockEncodingContext

newDataBlockDecodingContext

createSeeker

encode

startBlockEncoding

endBlockEncoding