Package io.github.jwharm.javagi.gobject

Class InstanceCache

java.lang.Object

io.github.jwharm.javagi.gobject.InstanceCache

public class InstanceCache
extends Object

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

Constructor Summary

Constructors

Constructor	Description
InstanceCache()

Method Summary

Modifier and Type	Method	Description
static Proxy	getForType(MemorySegment address, Function<MemorySegment,? extends Proxy> fallback)	Get a Proxy object for the provided native memory address.
static Proxy	getForTypeClass(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, Type objectType, long size, Object... 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.

Methods inherited from class java.lang.Object

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

Constructor Details

InstanceCache

public InstanceCache()

Method Details

getForType

public static 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 Proxy getForTypeClass(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,
 Type objectType,
 long size,
 Object... 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.