Class NativeAllocation

java.lang.Object

java.lang.ref.Reference<Object>

java.lang.ref.PhantomReference<Object>

com.oracle.truffle.nfi.backend.libffi.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.backend.libffi.NativeAllocation.Destructor)

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	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, clone, enqueue, isEnqueued, reachabilityFence, refersTo

Methods inherited from class java.lang.Object

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

Method Details

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.