jetbrains.exodus.bindings

Class LongBinding

java.lang.Object

jetbrains.exodus.bindings.ComparableBinding

jetbrains.exodus.bindings.LongBinding

public class LongBinding
extends ComparableBinding

ComparableBinding for Long values. In addition to typical longToEntry(long) and entryToLong(ByteIterable) methods operating with ByteIterables of length 8, LongBinding has a pair of methods for serialization/deserialization of non-negative values to/from compressed entries: longToCompressedEntry(long) and compressedEntryToLong(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 LongBinding	BINDING

Method Summary

Modifier and Type	Method and Description
static long	compressedEntryToLong(@NotNull ByteIterable entry) De-serializes compressed ByteIterable entry to an unsigned long value.
static long	compressedEntryToSignedLong(@NotNull ByteIterable entry) De-serializes compressed ByteIterable entry to a signed long value.
static long	entryToLong(@NotNull ByteIterable entry) De-serializes ByteIterable entry to a long value.
static long	entryToUnsignedLong(@NotNull byte[] bytes, int offset, int length)
static long	entryToUnsignedLong(@NotNull ByteIterator bi, int length)
static ArrayByteIterable	longToCompressedEntry(long object) Serializes unsigned long value to the compressed ArrayByteIterable entry.
static ArrayByteIterable	longToEntry(long object) Serializes long value to the ArrayByteIterable entry.
static long	readCompressed(@NotNull java.io.ByteArrayInputStream iterator)
static long	readCompressed(@NotNull ByteIterator iterator)
java.lang.Long	readObject(@NotNull java.io.ByteArrayInputStream stream)
static ArrayByteIterable	signedLongToCompressedEntry(long object) Serializes signed long value in the range [Long.MIN_VALUE/2..Long.MAX_VALUE/2] to the compressed ArrayByteIterable entry.
static void	writeCompressed(@NotNull LightOutputStream output, long l)
static void	writeCompressed(@NotNull LightOutputStream output, long l, int[] bytes)
void	writeObject(@NotNull LightOutputStream output, @NotNull java.lang.Comparable object)
static void	writeUnsignedLong(long l, int bytesPerLong, @NotNull LightOutputStream output)

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 LongBinding BINDING

Method Detail

readObject

public java.lang.Long 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

entryToLong

public static long entryToLong(@NotNull
                               @NotNull ByteIterable entry)

De-serializes ByteIterable entry to a long value. The entry should be an output of longToEntry(long).

Parameters:

entry - ByteIterable instance

Returns:

de-serialized value

See Also:

longToEntry(long), compressedEntryToLong(ByteIterable), longToCompressedEntry(long), compressedEntryToSignedLong(ByteIterable), signedLongToCompressedEntry(long)

longToEntry

public static ArrayByteIterable longToEntry(long object)

Serializes long value to the ArrayByteIterable entry.

Parameters:

object - value to serialize

Returns:

ArrayByteIterable entry

See Also:

entryToLong(ByteIterable), compressedEntryToLong(ByteIterable), longToCompressedEntry(long), compressedEntryToSignedLong(ByteIterable), signedLongToCompressedEntry(long)

compressedEntryToLong

public static long compressedEntryToLong(@NotNull
                                         @NotNull ByteIterable entry)

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

Parameters:

entry - ByteIterable instance

Returns:

de-serialized value

See Also:

entryToLong(ByteIterable), longToEntry(long), longToCompressedEntry(long), compressedEntryToSignedLong(ByteIterable), signedLongToCompressedEntry(long)

longToCompressedEntry

public static ArrayByteIterable longToCompressedEntry(long object)

Serializes unsigned long value to the compressed ArrayByteIterable entry.

Parameters:

object - non-negative value to serialize

Returns:

ArrayByteIterable entry

See Also:

entryToLong(ByteIterable), longToEntry(long), compressedEntryToLong(ByteIterable), compressedEntryToSignedLong(ByteIterable), signedLongToCompressedEntry(long)

compressedEntryToSignedLong

public static long compressedEntryToSignedLong(@NotNull
                                               @NotNull ByteIterable entry)

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

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:

entryToLong(ByteIterable), longToEntry(long), compressedEntryToLong(ByteIterable), longToCompressedEntry(long), signedLongToCompressedEntry(long)

signedLongToCompressedEntry

public static ArrayByteIterable signedLongToCompressedEntry(long object)

Serializes signed long value in the range [Long.MIN_VALUE/2..Long.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 [Long.MIN_VALUE/2..Long.MAX_VALUE/2]

Returns:

ArrayByteIterable entry

See Also:

entryToLong(ByteIterable), longToEntry(long), compressedEntryToLong(ByteIterable), longToCompressedEntry(long), compressedEntryToSignedLong(ByteIterable)

writeUnsignedLong

public static void writeUnsignedLong(long l,
                                     int bytesPerLong,
                                     @NotNull
                                     @NotNull LightOutputStream output)

entryToUnsignedLong

public static long entryToUnsignedLong(@NotNull
                                       @NotNull ByteIterator bi,
                                       int length)

entryToUnsignedLong

public static long entryToUnsignedLong(@NotNull
                                       @NotNull byte[] bytes,
                                       int offset,
                                       int length)

readCompressed

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

readCompressed

public static long readCompressed(@NotNull
                                  @NotNull java.io.ByteArrayInputStream iterator)

writeCompressed

public static void writeCompressed(@NotNull
                                   @NotNull LightOutputStream output,
                                   long l)

writeCompressed

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