jetbrains.exodus.bindings

Class IntegerBinding

java.lang.Object

jetbrains.exodus.bindings.ComparableBinding

jetbrains.exodus.bindings.IntegerBinding

public class IntegerBinding
extends ComparableBinding

ComparableBinding for Integer values. In addition to typical intToEntry(int) and entryToInt(ByteIterable) methods operating with ByteIterables of length 4, IntegerBinding has a pair of methods for serialization/deserialization of non-negative values to/from compressed entries: intToCompressedEntry(int) and compressedEntryToInt(ByteIterable). The lower the value, the shorter the compressed entry. In some cases, compressed entries let you significantly decrease database size. Serialization of non-negative integers and longs to compressed entries also saves the order of values.

See Also:

ComparableBinding

Field Summary

Fields

Modifier and Type	Field and Description
static IntegerBinding	BINDING

Method Summary

Modifier and Type	Method and Description
static int	compressedEntryToInt(@NotNull ByteIterable entry) De-serializes compressed ByteIterable entry to an unsigned int value.
static int	compressedEntryToSignedInt(@NotNull ByteIterable entry) De-serializes compressed ByteIterable entry to a signed int value.
static int	entryToInt(@NotNull ByteIterable entry) De-serializes ByteIterable entry to an int value.
static ArrayByteIterable	intToCompressedEntry(int object) Serializes unsigned int value to the compressed ArrayByteIterable entry.
static ArrayByteIterable	intToEntry(int object) Serializes int value to the ArrayByteIterable entry.
static int	readCompressed(@NotNull byte[] bytes)
static int	readCompressed(@NotNull ByteIterator iterator)
java.lang.Integer	readObject(@NotNull java.io.ByteArrayInputStream stream)
static ArrayByteIterable	signedIntToCompressedEntry(int object) Serializes signed int value in the range [Integer.MIN_VALUE/2..Integer.MAX_VALUE/2] to the compressed ArrayByteIterable entry.
static void	writeCompressed(@NotNull LightOutputStream output, int i)
static void	writeCompressed(@NotNull LightOutputStream output, int i, int[] bytes)
void	writeObject(@NotNull LightOutputStream output, @NotNull java.lang.Comparable object)

Methods inherited from class jetbrains.exodus.bindings.ComparableBinding

entryToObject, objectToEntry

Methods inherited from class java.lang.Object

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

Field Detail

BINDING

public static final IntegerBinding BINDING

Method Detail

readObject

public java.lang.Integer readObject(@NotNull
                                    @NotNull java.io.ByteArrayInputStream stream)

Specified by:

readObject in class ComparableBinding

writeObject

public void writeObject(@NotNull
                        @NotNull LightOutputStream output,
                        @NotNull
                        @NotNull java.lang.Comparable object)

Specified by:

writeObject in class ComparableBinding

entryToInt

public static int entryToInt(@NotNull
                             @NotNull ByteIterable entry)

De-serializes ByteIterable entry to an int value. The entry should an output of intToEntry(int).

Parameters:

entry - ByteIterable instance

Returns:

de-serialized value

See Also:

intToEntry(int), compressedEntryToInt(ByteIterable), intToCompressedEntry(int), compressedEntryToSignedInt(ByteIterable), signedIntToCompressedEntry(int)

intToEntry

public static ArrayByteIterable intToEntry(int object)

Serializes int value to the ArrayByteIterable entry.

Parameters:

object - value to serialize

Returns:

ArrayByteIterable entry

See Also:

entryToInt(ByteIterable), compressedEntryToInt(ByteIterable), intToCompressedEntry(int), compressedEntryToSignedInt(ByteIterable), signedIntToCompressedEntry(int)

compressedEntryToInt

public static int compressedEntryToInt(@NotNull
                                       @NotNull ByteIterable entry)

De-serializes compressed ByteIterable entry to an unsigned int value. The entry should be an output of intToCompressedEntry(int).

Parameters:

entry - ByteIterable instance

Returns:

de-serialized value

See Also:

entryToInt(ByteIterable), intToEntry(int), intToCompressedEntry(int), compressedEntryToSignedInt(ByteIterable), signedIntToCompressedEntry(int)

intToCompressedEntry

public static ArrayByteIterable intToCompressedEntry(int object)

Serializes unsigned int value to the compressed ArrayByteIterable entry.

Parameters:

object - non-negative value to serialize

Returns:

ArrayByteIterable entry

See Also:

entryToInt(ByteIterable), intToEntry(int), compressedEntryToInt(ByteIterable), compressedEntryToSignedInt(ByteIterable), signedIntToCompressedEntry(int)

compressedEntryToSignedInt

public static int compressedEntryToSignedInt(@NotNull
                                             @NotNull ByteIterable entry)

De-serializes compressed ByteIterable entry to a signed int value. The entry should be an output of signedIntToCompressedEntry(int).

ZigZag encoding is used, so it doesn't save the order of values like other ComparableBindings do.

Parameters:

entry - ByteIterable instance

Returns:

de-serialized value

See Also:

entryToInt(ByteIterable), intToEntry(int), compressedEntryToInt(ByteIterable), intToCompressedEntry(int), signedIntToCompressedEntry(int)

signedIntToCompressedEntry

public static ArrayByteIterable signedIntToCompressedEntry(int object)

Serializes signed int value in the range [Integer.MIN_VALUE/2..Integer.MAX_VALUE/2] to the compressed ArrayByteIterable entry.

ZigZag encoding is used, so it doesn't save the order of values like other ComparableBindings do.

Parameters:

object - value to serialize in the range [Integer.MIN_VALUE/2..Integer.MAX_VALUE/2]

Returns:

ArrayByteIterable entry

See Also:

entryToInt(ByteIterable), intToEntry(int), compressedEntryToInt(ByteIterable), intToCompressedEntry(int), compressedEntryToSignedInt(ByteIterable)

readCompressed

public static int readCompressed(@NotNull
                                 @NotNull ByteIterator iterator)

readCompressed

public static int readCompressed(@NotNull
                                 @NotNull byte[] bytes)

writeCompressed

public static void writeCompressed(@NotNull
                                   @NotNull LightOutputStream output,
                                   int i)

writeCompressed

public static void writeCompressed(@NotNull
                                   @NotNull LightOutputStream output,
                                   int i,
                                   int[] bytes)