Interface Settings.ChangedCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

Settings

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public static interface Settings.ChangedCallback
extends FunctionPointer

Functional interface declaration of the ChangedCallback callback.

See Also:

• run(String)

Method Summary

Modifier and Type	Method	Description
void	run(String key)	Emitted when a key has potentially changed.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(MemorySegment, MemorySegment) method.
default void	upcall(MemorySegment sourceSettings, MemorySegment key)	The upcall method is called from native code.

Method Details

run

void run(String key)

Emitted when a key has potentially changed.

You should call one of the Settings.get(String, String, Object...) calls to check the new value.

This signal supports detailed connections. You can connect to the detailed signal changed::x in order to only receive callbacks when key x changes.

Note that settings only emits this signal if you have read key at least once while a signal handler was already connected for key.

upcall

default void upcall(MemorySegment sourceSettings,
 MemorySegment key)

The upcall method is called from native code. The parameters are marshaled and run(String) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(MemorySegment, MemorySegment) method.

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the arena in which the function pointer is allocated

Returns:

the native function pointer