Nested and Inner Type Summary

Modifier and Type	Class and Description
private static enum	LittleEndianByteArray.JavaLittleEndianBytes Fallback implementation for when Unsafe is not available in our current environment.
private static interface	LittleEndianByteArray.LittleEndianBytes Common interface for retrieving a 64-bit long from a little-endian byte array.
private static enum	LittleEndianByteArray.UnsafeByteArray The only reference to Unsafe is in this nested class.

Field Summary

Modifier and Type	Field and Description
private static final LittleEndianByteArray.LittleEndianBytes	byteArray The instance that actually does the work; delegates to Unsafe or a pure-Java fallback.

Constructor Summary

Access	Constructor and Description
private	LittleEndianByteArray() Deter instantiation of this class.

Method Summary

Modifier and Type	Method and Description
pack-priv static int	Returns: the value found in the array in the form of a long load32(byte[] the input bytes source, int the offset into the array at which to start offset) Load 4 bytes from the provided array at the indicated offset.
pack-priv static long	Returns: a long of a concatenated 8 bytes load64(byte[] the input bytes input, int the offset into the array at which to start offset) Load 8 bytes into long in a little endian manner, from the substring between position and position + 8.
pack-priv static long	Returns: a long of a concatenated 8 bytes load64Safely(byte[] the input bytes input, int the offset into the array at which to start reading offset, int the number of bytes from the input to read length) Similar to load64, but allows offset + 8 > input.length, padding the result with zeroes.
pack-priv static void	store64(byte[] the output byte array sink, int the offset into the array at which to start writing offset, long the value to write value) Store 8 bytes into the provided array at the indicated offset, using the value provided.
pack-priv static boolean	usingUnsafe() Indicates that the loading of Unsafe was successful and the load and store operations will be very efficient.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

byteArray	back to summary
private static final LittleEndianByteArray.LittleEndianBytes byteArray The instance that actually does the work; delegates to Unsafe or a pure-Java fallback.

Constructor Detail

LittleEndianByteArray	back to summary
private LittleEndianByteArray() Deter instantiation of this class.

Method Detail

load32	back to summary
pack-priv static int load32(byte[] source, int offset) Load 4 bytes from the provided array at the indicated offset. Parameters source:byte[] the input bytes offset:int the offset into the array at which to start Returns:int the value found in the array in the form of a long

load32

back to summary

pack-priv static int load32(byte[] source, int offset)

Load 4 bytes from the provided array at the indicated offset.

Parameters

source:byte[]: the input bytes
offset:int: the offset into the array at which to start

Returns:int

the value found in the array in the form of a long

load64	back to summary
pack-priv static long load64(byte[] input, int offset) Load 8 bytes into long in a little endian manner, from the substring between position and position + 8. The array must have at least 8 bytes from offset (inclusive). Parameters input:byte[] the input bytes offset:int the offset into the array at which to start Returns:long a long of a concatenated 8 bytes

load64

back to summary

pack-priv static long load64(byte[] input, int offset)

Load 8 bytes into long in a little endian manner, from the substring between position and position + 8. The array must have at least 8 bytes from offset (inclusive).

Parameters

input:byte[]: the input bytes
offset:int: the offset into the array at which to start

Returns:long

a long of a concatenated 8 bytes

load64Safely	back to summary
pack-priv static long load64Safely(byte[] input, int offset, int length) Similar to load64, but allows offset + 8 > input.length, padding the result with zeroes. This has to explicitly reverse the order of the bytes as it packs them into the result which makes it slower than the native version. Parameters input:byte[] the input bytes offset:int the offset into the array at which to start reading length:int the number of bytes from the input to read Returns:long a long of a concatenated 8 bytes

load64Safely

back to summary

pack-priv static long load64Safely(byte[] input, int offset, int length)

Similar to load64, but allows offset + 8 > input.length, padding the result with zeroes. This has to explicitly reverse the order of the bytes as it packs them into the result which makes it slower than the native version.

Parameters

input:byte[]: the input bytes
offset:int: the offset into the array at which to start reading
length:int: the number of bytes from the input to read

Returns:long

a long of a concatenated 8 bytes

store64	back to summary
pack-priv static void store64(byte[] sink, int offset, long value) Store 8 bytes into the provided array at the indicated offset, using the value provided. Parameters sink:byte[] the output byte array offset:int the offset into the array at which to start writing value:long the value to write

store64

back to summary

pack-priv static void store64(byte[] sink, int offset, long value)

Store 8 bytes into the provided array at the indicated offset, using the value provided.

Parameters

sink:byte[]: the output byte array
offset:int: the offset into the array at which to start writing
value:long: the value to write

usingUnsafe	back to summary
pack-priv static boolean usingUnsafe() Indicates that the loading of Unsafe was successful and the load and store operations will be very efficient. May be useful for calling code to fall back on an alternative implementation that is slower than Unsafe.get/store but faster than the pure-Java mask-and-shift.

com.google.common.hash back to summary

private sealed Enum LittleEndianByteArray.JavaLittleEndianBytes

Class Inheritance

extends Enum<LittleEndianByteArray.JavaLittleEndianBytes>
implements LittleEndianBytes

java.lang.Object
java.lang.Enum
com.google.common.hash.LittleEndianByteArray.JavaLittleEndianBytes

All Implemented Interfaces

com.google.common.hash.LittleEndianByteArray.LittleEndianBytes

Fallback implementation for when Unsafe is not available in our current environment.

Field Summary

Modifier and Type	Field and Description
public static final LittleEndianByteArray.JavaLittleEndianBytes	INSTANCE

Constructor Summary

Access	Constructor and Description
private	JavaLittleEndianBytes()

Method Summary

Modifier and Type	Method and Description
public static LittleEndianByteArray.JavaLittleEndianBytes	valueOf(String name)
public static LittleEndianByteArray.JavaLittleEndianBytes[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

INSTANCE	back to summary
public static final LittleEndianByteArray.JavaLittleEndianBytes INSTANCE

Constructor Detail

JavaLittleEndianBytes	back to summary
private JavaLittleEndianBytes()

Method Detail

valueOf	back to summary
public static LittleEndianByteArray.JavaLittleEndianBytes valueOf(String name)

values	back to summary
public static LittleEndianByteArray.JavaLittleEndianBytes[] values()

com.google.common.hash back to summary

private Interface LittleEndianByteArray.LittleEndianBytes

Known Direct Implementers: com.google.common.hash.LittleEndianByteArray.UnsafeByteArray, com.google.common.hash.LittleEndianByteArray.JavaLittleEndianBytes

Common interface for retrieving a 64-bit long from a little-endian byte array.

This abstraction allows us to use single-instruction load and put when available, or fall back on the slower approach of using Longs.fromBytes(byte...).

Method Summary

Modifier and Type	Method and Description
public long	getLongLittleEndian(byte[] array, int offset)
public void	putLongLittleEndian(byte[] array, int offset, long value)

Method Detail

getLongLittleEndian	back to summary
public long getLongLittleEndian(byte[] array, int offset)

putLongLittleEndian	back to summary
public void putLongLittleEndian(byte[] array, int offset, long value)

com.google.common.hash back to summary

private sealed Enum LittleEndianByteArray.UnsafeByteArray

Class Inheritance

extends Enum<LittleEndianByteArray.UnsafeByteArray>
implements LittleEndianBytes

java.lang.Object
java.lang.Enum
com.google.common.hash.LittleEndianByteArray.UnsafeByteArray

All Implemented Interfaces

com.google.common.hash.LittleEndianByteArray.LittleEndianBytes

The only reference to Unsafe is in this nested class. We set things up so that if Unsafe.theUnsafe is inaccessible, the attempt to load the nested class fails, and the outer class's static initializer can fall back on a non-Unsafe version.

Field Summary

Modifier and Type	Field and Description
private static final int	BYTE_ARRAY_BASE_OFFSET
private static final Unsafe	theUnsafe
public static final LittleEndianByteArray.UnsafeByteArray	UNSAFE_BIG_ENDIAN
public static final LittleEndianByteArray.UnsafeByteArray	UNSAFE_LITTLE_ENDIAN

Constructor Summary

Access	Constructor and Description
private	UnsafeByteArray()

Method Summary

Modifier and Type	Method and Description
private static Unsafe	Returns: an Unsafe instance if successful getUnsafe() Returns an Unsafe.
public static LittleEndianByteArray.UnsafeByteArray	valueOf(String name)
public static LittleEndianByteArray.UnsafeByteArray[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

BYTE_ARRAY_BASE_OFFSET	back to summary
private static final int BYTE_ARRAY_BASE_OFFSET

theUnsafe	back to summary
private static final Unsafe theUnsafe

UNSAFE_BIG_ENDIAN	back to summary
public static final LittleEndianByteArray.UnsafeByteArray UNSAFE_BIG_ENDIAN

UNSAFE_LITTLE_ENDIAN	back to summary
public static final LittleEndianByteArray.UnsafeByteArray UNSAFE_LITTLE_ENDIAN

Constructor Detail

UnsafeByteArray	back to summary
private UnsafeByteArray()

Method Detail

getUnsafe	back to summary
private static Unsafe getUnsafe() Returns an Unsafe. Suitable for use in a 3rd party package. Replace with a simple call to Unsafe.getUnsafe when integrating into a JDK. Returns:Unsafe an Unsafe instance if successful

getUnsafe

back to summary

private static Unsafe getUnsafe()

Returns an Unsafe. Suitable for use in a 3rd party package. Replace with a simple call to Unsafe.getUnsafe when integrating into a JDK.

Returns:Unsafe: an Unsafe instance if successful

valueOf	back to summary
public static LittleEndianByteArray.UnsafeByteArray valueOf(String name)

values	back to summary
public static LittleEndianByteArray.UnsafeByteArray[] values()

pack-priv final Class LittleEndianByteArray

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private sealed Enum LittleEndianByteArray.JavaLittleEndianBytes

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Interface LittleEndianByteArray.LittleEndianBytes

Method Summary

Method Detail

private sealed Enum LittleEndianByteArray.UnsafeByteArray

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail