Package io.github.jwharm.javagi.interop

Class MemoryCleaner

java.lang.Object

io.github.jwharm.javagi.interop.MemoryCleaner

public class MemoryCleaner
extends Object

This class keeps a cache of all memory addresses for which a Proxy object was created (except for GObject instances; those are handled in the InstanceCache).

When a new Proxy object is created, the reference count in the cache is increased. When a Proxy object is garbage-collected, the reference count in the cache is decreased. When the reference count is 0, the memory is released using GLib.free(MemorySegment) or a specialized method.

When ownership of a memory address is passed to native code, the cleaner will not free the memory. Ownership is enabled/disabled with takeOwnership(Proxy) and yieldOwnership(Proxy).

Constructor Summary

Constructors

Constructor	Description
MemoryCleaner()

Method Summary

Modifier and Type	Method	Description
static void	free(MemorySegment address)	Run the MemoryCleaner.StructFinalizer associated with this memory address, by invoking Cleaner.Cleanable.clean().
static void	setBoxedType(@NotNull Proxy proxy, @NotNull Type boxedType)	For a boxed type, g_boxed_free(type, pointer) will be used as cleanup function.
static void	setFreeFunc(@NotNull Proxy proxy, @NotNull String freeFunc)	Register a specialized cleanup function for this proxy instance, instead of the default GLib.free(MemorySegment).
static void	takeOwnership(@NotNull Proxy proxy)	Take ownership of this memory address: when all proxy objects are garbage-collected, the memory will automatically be released.
static void	yieldOwnership(@NotNull Proxy proxy)	Yield ownership of this memory address: when all proxy objects are garbage-collected, the memory will not be released.

Methods inherited from class java.lang.Object

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

Constructor Details

MemoryCleaner

public MemoryCleaner()

Method Details

setFreeFunc

public static void setFreeFunc(@NotNull
 @NotNull Proxy proxy,
 @NotNull
 @NotNull String freeFunc)

Register a specialized cleanup function for this proxy instance, instead of the default GLib.free(MemorySegment).

Parameters:

proxy - the proxy instance

freeFunc - the specialized cleanup function to call

setBoxedType

public static void setBoxedType(@NotNull
 @NotNull Proxy proxy,
 @NotNull
 @NotNull Type boxedType)

For a boxed type, g_boxed_free(type, pointer) will be used as cleanup function.

Parameters:

proxy - the proxy instance

boxedType - the boxed type

takeOwnership

public static void takeOwnership(@NotNull
 @NotNull Proxy proxy)

Take ownership of this memory address: when all proxy objects are garbage-collected, the memory will automatically be released.

Parameters:

proxy - the proxy instance

yieldOwnership

public static void yieldOwnership(@NotNull
 @NotNull Proxy proxy)

Yield ownership of this memory address: when all proxy objects are garbage-collected, the memory will not be released.

Parameters:

proxy - the proxy instance

free

public static void free(MemorySegment address)

Run the MemoryCleaner.StructFinalizer associated with this memory address, by invoking Cleaner.Cleanable.clean().

Parameters:

address - the memory address to free