com.tangosol.util

Class Unsafe

java.lang.Object

com.tangosol.util.Unsafe

public class Unsafe
extends Object

A collection of "back-door" utilities and helpers used internally.

This class is not intended to be used externally and any usage of this class promises nothing more than un-deterministic behavior which may or may not remain consistent from release to release.

Author:

rhl 2012.12.20

Method Summary

Modifier and Type	Method and Description
int	getArrayOffset(Binary bin) Return the offset into the underlying byte[] for the specified Binary.
byte[]	getByteArray(Binary bin) Return the underlying byte[] for the specified Binary.
static Unsafe	getUnsafe() Return the singleton Unsafe instance.
Binary	newBinary(byte[] ab, int of, int cb) Return a new Binary instance backed by the specified byte[] beginning at the specified offset and of the specified length.

Methods inherited from class java.lang.Object

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

Method Detail

getUnsafe

public static Unsafe getUnsafe()

Return the singleton Unsafe instance. This method may only be called internally. The caller should cache the result.

Returns:

the singleton instance

getByteArray

public byte[] getByteArray(Binary bin)

Return the underlying byte[] for the specified Binary.

Note: unlike the AbstractReadBuffer.toByteArray() method, this method does not create a copy of the underlying array; it is the caller's responsibility not to mutate the contents of the returned array.

Parameters:

bin - the binary

Returns:

the underlying byte[]

getArrayOffset

public int getArrayOffset(Binary bin)

Return the offset into the underlying byte[] for the specified Binary.

Parameters:

bin - the binary

Returns:

the offset into the underlying byte[]

newBinary

public Binary newBinary(byte[] ab,
                        int of,
                        int cb)

Return a new Binary instance backed by the specified byte[] beginning at the specified offset and of the specified length.

Note: unlike the analagous constructor, this method does not create a copy of the passed array; it is the caller's responsibility not to mutate the contents of the array.

Parameters:

ab - the byte array

of - the starting offset

cb - the length of the binary

Returns:

a new Binary based on the specified array