Package org.javagi.gobject

Class InstanceCache

java.lang.Object

org.javagi.gobject.InstanceCache

@NullMarked
public class InstanceCache
extends Object

Caches TypeInstances so the same instance is used for the same memory address.

Field Summary

Fields

Modifier and Type	Field	Description
static final MemorySegment	REMOVE_TOGGLE_REF

Constructor Summary

Constructors

Constructor	Description
InstanceCache()

Method Summary

Modifier and Type	Method	Description
static @Nullable Proxy	getForType(MemorySegment address, Function<MemorySegment,? extends Proxy> fallback)	Get a Proxy object for the provided native memory address.
static @Nullable Proxy	getForTypeClass(@Nullable MemorySegment address, Function<MemorySegment,? extends Proxy> fallback)	Get a Proxy object for the provided native memory address of a TypeClass.
static void	newGObject(GObject proxy, @Nullable Type objectType, long size, @Nullable Object @Nullable ... properties)	Construct a new GObject instance and set the provided Java proxy to its address.
static Proxy	put(MemorySegment address, GObject object)	Add the new GObject instance to the cache.
static int	removeToggleRef(MemorySegment address)

Methods inherited from class java.lang.Object

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

Field Details

REMOVE_TOGGLE_REF

public static final MemorySegment REMOVE_TOGGLE_REF

Constructor Details

InstanceCache

public InstanceCache()

Method Details

getForType

public static @Nullable Proxy getForType(MemorySegment address,
 Function<MemorySegment,? extends Proxy> fallback)

Get a Proxy object for the provided native memory address. If a Proxy object does not yet exist for this address, a new Proxy object is instantiated and added to the cache. The type of the Proxy object is read from the gtype field of the native instance. Invalid references are removed from the cache using a GObject toggle reference.

Parameters:

address - memory address of the native object

fallback - fallback constructor to use when the type is not found in the TypeCache

Returns:

a Proxy instance for the provided memory address

getForTypeClass

public static @Nullable Proxy getForTypeClass(@Nullable MemorySegment address,
 Function<MemorySegment,? extends Proxy> fallback)

Get a Proxy object for the provided native memory address of a TypeClass. The type of the Proxy object is read from the gtype field of the native TypeClass.

Parameters:

address - memory address of the native object

fallback - fallback constructor to use when the type is not found in the TypeCache

Returns:

a Proxy instance for the provided memory address

put

public static Proxy put(MemorySegment address,
 GObject object)

Add the new GObject instance to the cache. Floating references are sunk, and a toggle reference is installed.

Parameters:

address - the memory address of the native instance

object - the GObject instance

Returns:

the cached GObject instance

newGObject

public static void newGObject(GObject proxy,
 @Nullable Type objectType,
 long size,
 @Nullable Object @Nullable ... properties)

Construct a new GObject instance and set the provided Java proxy to its address.

Parameters:

proxy - the Java Proxy for the newly constructed GObject instance

objectType - the GType, if null it will be queried from the TypeCache

size - the size of the native instance

properties - pairs of property names and values (optional). A trailing null will be added automatically.

removeToggleRef

public static int removeToggleRef(MemorySegment address)