public class DGapIntEncoder extends IntEncoderFilter
IntEncoderFilterwhich encodes the gap between the given values, rather than the values themselves. This encoder usually yields better encoding performance space-wise (i.e., the final encoded values consume less space) if the values are 'close' to each other.
NOTE: this encoder assumes the values are given to
encode(int) in an ascending sorted manner, which ensures only
positive values are encoded and thus yields better performance. If you are
not sure whether the values are sorted or not, it is possible to chain this
SortingIntEncoder to ensure the values will be
sorted before encoding.
|Constructor and Description|
Initializes with the given encoder.
|Modifier and Type||Method and Description|
Encodes an integer to the output stream given in
Reinitializes the encoder with the give
public DGapIntEncoder(IntEncoder encoder)
public void encode(int value) throws IOException
public IntDecoder createMatchingDecoder()
IntDecoderwhich matches this encoder. Every encoder must return an
nullis not a valid value. If an encoder is just a filter, it should at least return its wrapped encoder's matching decoder.
NOTE: this method should create a new instance of the matching decoder and leave the instance sharing to the caller. Returning the same instance over and over is risky because encoders and decoders are not thread safe.
public void reInit(OutputStream out)
OutputStream. For re-usability it can be changed without the need to reconstruct a new object.
NOTE: after calling
IntEncoder.close(), one must call
this method even if the output stream itself hasn't changed. An example
case is that the output stream wraps a byte, and the output stream itself
is reset, but its instance hasn't changed. Some implementations of
IntEncoder may write some metadata about themselves to the output
stream, and therefore it is imperative that one calls this method before
encoding any data.