com.alexkasko.unsafe.offheaplong

Class OffHeapLongArray

java.lang.Object

com.alexkasko.unsafe.offheaplong.OffHeapLongArray

All Implemented Interfaces:

OffHeapAddressable, OffHeapDisposable, OffHeapDisposableIterable<Long>, OffHeapLongAddressable, Iterable<Long>

public class OffHeapLongArray
extends Object
implements OffHeapLongAddressable, OffHeapDisposable, Iterable<Long>

Implementation of array of long using OffHeapMemory.

Default implementation uses sun.misc.Unsafe, with all operations guarded with assert keyword. With assertions enabled in runtime (-ea java switch) AssertionError will be thrown on illegal index access. Without assertions illegal index will crash JVM.

Array won't be zeroed after creation (will contain garbage by default). Allocated memory may be freed manually using free() (thread-safe and may be called multiple times) or it will be freed after OffHeapLongArray will be garbage collected.

Note: while class implements Iterable, iterator will create new autoboxed Long object on every next() call, this behaviour is inevitable with iterators in java 6/7.

Author:

alexkasko Date: 2/22/13

Field Summary

Fields

Modifier and Type	Field and Description
private static int	ELEMENT_LENGTH
private OffHeapMemory	ohm

Constructor Summary

Constructors

Modifier	Constructor and Description
	OffHeapLongArray(long size) Constructor
private	OffHeapLongArray(OffHeapMemory ohm) Private constructor for clone() support

Method Summary

Methods

Modifier and Type	Method and Description
OffHeapLongArray	clone()
void	free() Frees allocated memory, may be called multiple times from any thread
long	get(long index) Gets the element at position index
boolean	isUnsafe() Whether unsafe implementation of OffHeapMemory is used
OffHeapDisposableIterator<Long>	iterator()
void	set(long index, long value) Sets the element at position index to the given value
long	size() Returns number of elements in array
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

ELEMENT_LENGTH

private static final int ELEMENT_LENGTH

See Also:

Constant Field Values

ohm

private final OffHeapMemory ohm

Constructor Detail

OffHeapLongArray

public OffHeapLongArray(long size)

Constructor

Parameters:

size - number of elements in array

OffHeapLongArray

private OffHeapLongArray(OffHeapMemory ohm)

Private constructor for clone() support

Parameters:

ohm - cloned memory instance

Method Detail

isUnsafe

public boolean isUnsafe()

Whether unsafe implementation of OffHeapMemory is used

Returns:

whether unsafe implementation of OffHeapMemory is used

get

public long get(long index)

Gets the element at position index

Specified by:

get in interface OffHeapAddressable

Parameters:

index - array index

Returns:

long value

set

public void set(long index,
       long value)

Sets the element at position index to the given value

Specified by:

set in interface OffHeapLongAddressable

Parameters:

index - array index

value - long value

size

public long size()

Returns number of elements in array

Specified by:

size in interface OffHeapAddressable

Returns:

number of elements in array

free

public void free()

Frees allocated memory, may be called multiple times from any thread

Specified by:

free in interface OffHeapDisposable

iterator

public OffHeapDisposableIterator<Long> iterator()

Specified by:

iterator in interface OffHeapDisposableIterable<Long>

Specified by:

iterator in interface Iterable<Long>

clone

public OffHeapLongArray clone()

Overrides:

clone in class Object

toString

public String toString()

Overrides:

toString in class Object