org.graalvm.nativebridge

Class NativeObject

java.lang.Object

org.graalvm.nativebridge.NativeObject

public class NativeObject
extends Object

Encapsulates a handle to an object in a native image heap where the object's lifetime is bound to the lifetime of the NativeObject instance. At some point, after a NativeObject is garbage collected, a call is made to release the handle, allowing the corresponding object in the native image heap to be collected.

Constructor Summary

Constructors

Constructor and Description
NativeObject(NativeIsolate isolate, long objectHandle) Creates a new NativeObject.

Method Summary

Modifier and Type	Method and Description
long	getHandle() Returns a handle to an object in the native image heap.
NativeIsolate	getIsolate() Returns an isolate in which an object referenced by this handle exists.
void	release() Explicitly releases object in the native image heap referenced by this handle.

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeObject

public NativeObject(NativeIsolate isolate,
                    long objectHandle)

Creates a new NativeObject.

Parameters:

isolate - an isolate in which an object referenced by the handle exists.

objectHandle - a handle to an object in a native image heap

Method Detail

getIsolate

public final NativeIsolate getIsolate()

Returns an isolate in which an object referenced by this handle exists.

getHandle

public final long getHandle()

Returns a handle to an object in the native image heap.

release

public final void release()

Explicitly releases object in the native image heap referenced by this handle. The use of this method should be exceptional. By default, the lifetime of the object in the native image heap is bound to the lifetime of the NativeObject instance.