Module org.freedesktop.cairo

Package io.github.jwharm.cairobindings

Class MemoryCleaner

java.lang.Object

io.github.jwharm.cairobindings.MemoryCleaner

public final class MemoryCleaner
extends Object

This class keeps a cache of all memory addresses for which a Proxy object was created.

When a new Proxy object is created, a Cleaner is attached to it. When the Proxy object is garbage-collected, the memory is released using the specified free-func.

When ownership of a memory address belongs elsewhere, the cleaner must not free the memory. Ownership is enabled/disabled with takeOwnership(MemorySegment) and yieldOwnership(MemorySegment).

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	register(Proxy proxy)	Register the memory address of this proxy to be cleaned when the proxy gets garbage-collected.
static void	setFreeFunc(MemorySegment address, String freeFunc)	Register a specialized cleanup function for this memory address.
static void	takeOwnership(MemorySegment address)	Take ownership of this memory address: when all proxy objects are garbage-collected, the memory will automatically be released.
static void	yieldOwnership(MemorySegment address)	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

Method Details

register

public static void register(Proxy proxy)

Register the memory address of this proxy to be cleaned when the proxy gets garbage-collected.

Parameters:

proxy - The proxy instance

setFreeFunc

public static void setFreeFunc(MemorySegment address,
 String freeFunc)

Register a specialized cleanup function for this memory address.

Parameters:

address - the memory address

freeFunc - the specialized cleanup function to call

takeOwnership

public static void takeOwnership(MemorySegment address)

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

Parameters:

address - the memory address

yieldOwnership

public static void yieldOwnership(MemorySegment address)

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

Parameters:

address - the memory address

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