Graal Sdk 24.1.2 · org.graalvm.nativebridge.NativeObjectCleaner

A weak reference performing a given action when a referent becomes weakly reachable and is enqueued into reference queue. The class is not active. The reference queue check is performed anytime a new NativeObjectCleaner#register() is called, or it can be performed explicitly using NativeObjectCleaner#processPendingCleaners().

Field Summary

Modifier and Type	Field and Description
private static final ReferenceQueue<Object>	cleanersQueue
private static final Object	INVALID_ISOLATE_THREAD
pack-priv final NativeIsolate	isolate

Constructor Summary

Access	Constructor and Description
protected	NativeObjectCleaner(T object the new weak reference will refer to referent, NativeIsolate the native object isolate isolate) Creates a new `NativeObjectCleaner`.

Method Summary

Modifier and Type	Method and Description
private static void	cleanImpl(long isolateThread, NativeObjectCleaner<?> cleaner)
protected abstract void	cleanUp(long the isolate thread address to call into isolate. isolateThread) At some point after a `referent` is garbage collected the `NativeIsolate` is entered and the `cleanUp(long)` is executed with the isolate thread address parameter.
public static void	processPendingCleaners() Performs an explicit clean up of enqueued `NativeObjectCleaner`s.
public final NativeObjectCleaner<T>	register() Registers `NativeObjectCleaner` for cleanup.

Field Detail

cleanersQueue	back to summary
private static final ReferenceQueue<Object> cleanersQueue

INVALID_ISOLATE_THREAD	back to summary
private static final Object INVALID_ISOLATE_THREAD

isolate	back to summary
pack-priv final NativeIsolate isolate

Constructor Detail

NativeObjectCleaner back to summary

NativeObjectCleaner	back to summary
protected NativeObjectCleaner(T referent, NativeIsolate isolate) Creates a new `NativeObjectCleaner`. Parameters referent:T object the new weak reference will refer to isolate:NativeIsolate the native object isolate

protected NativeObjectCleaner(T referent, NativeIsolate isolate)

Creates a new NativeObjectCleaner.

Parameters

referent:T: object the new weak reference will refer to
isolate:NativeIsolate: the native object isolate

Method Detail

cleanImpl	back to summary
private static void cleanImpl(long isolateThread, NativeObjectCleaner<?> cleaner)

cleanUp back to summary

cleanUp	back to summary
protected abstract void cleanUp(long isolateThread) At some point after a `referent` is garbage collected the `NativeIsolate` is entered and the `cleanUp(long)` is executed with the isolate thread address parameter. This method should perform cleanup in the isolate heap. Parameters isolateThread:long the isolate thread address to call into isolate.

protected abstract void cleanUp(long isolateThread)

At some point after a referent is garbage collected the NativeIsolate is entered and the cleanUp(long) is executed with the isolate thread address parameter. This method should perform cleanup in the isolate heap.