com.oracle.truffle.nfi.impl

Class NativeAllocation

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.PhantomReference<Object>

com.oracle.truffle.nfi.impl.NativeAllocation

public final class NativeAllocation
extends PhantomReference<Object>

Utility class to manage destructors for native allocations.

See Also:

NativeAllocation.Queue.registerNativeAllocation(java.lang.Object, com.oracle.truffle.nfi.impl.NativeAllocation.Destructor)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NativeAllocation.Destructor
static class	NativeAllocation.FreeDestructor
static class	NativeAllocation.Queue

Method Summary

Modifier and Type	Method and Description
static NativeAllocation.Queue	getGlobalQueue() Returns a global default NativeAllocation.Queue.

Methods inherited from class java.lang.ref.PhantomReference

get

Methods inherited from class java.lang.ref.Reference

clear, enqueue, isEnqueued

Methods inherited from class java.lang.Object

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

Method Detail

getGlobalQueue

public static NativeAllocation.Queue getGlobalQueue()

Returns a global default NativeAllocation.Queue. Most users of this class usually want to use this global queue.

Note however that the NativeAllocation.Destructor object will be kept alive by the NativeAllocation.Queue until after the javaObject dies, so care must be taken with potential references from the NativeAllocation.Destructor back to the javaObject. Such a reference cycle will keep the javaObject alive until the NativeAllocation.Queue dies. In that case, a local NativeAllocation.Queue must be used to prevent memory leaks.