public class NOnesIntEncoder extends FourFlagsIntEncoder
FourFlagsIntEncoderwhich translates the data as follows:
value+1(2 ⇒ 3, 3 ⇒ 4 and so forth).
Noccurrences of 1 are encoded as a single 2.
Integer.MAX_VALUE. 0 is not supported because it's not supported by
Integer.MAX_VALUEbecause this encoder translates N to N+1, which will cause an overflow and
Integer.MAX_VALUEwill become a negative number, which is not supported as well.
Integer.MAX_VALUE. If it is not the first value to encode, and you wrap this encoder with
DGapIntEncoder, then the value that will be sent to this encoder will be
MAX_VAL - prev.
encodeQueue, encodeQueueSize, encoder, indicator, ordinal
|Constructor and Description|
Constructs an encoder with a given value of N (N: Number of consecutive '1's to be translated into single target value '2').
|Modifier and Type||Method and Description|
Instructs the encoder to finish the encoding process.
Small values (<=3) are stored in the
Reinitializes the encoder with the give
public NOnesIntEncoder(int n)
public void close() throws IOException
reInit. An implementation may do here additional cleanup required to complete the encoding, such as flushing internal buffers, etc.
encodeshould be made before first calling
NOTE: overriding classes should make sure they either call
super.close() or close the output stream themselves.
public void encode(int value) throws IOException
indicatorwhile larger values are saved for later encoding in the
ChunksIntEncoder.encodeQueue. Since Vint8 will only encode values larger or equal to 4, the values saves for encoded are transformed to (value - 4).
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.