Interface DBusSubtreeIntrospectFunc

All Superinterfaces:

FunctionPointer

Functional Interface:

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

@FunctionalInterface
@Generated("org.javagi.JavaGI")
public interface DBusSubtreeIntrospectFunc
extends FunctionPointer

Functional interface declaration of the DBusSubtreeIntrospectFunc callback.

See Also:

• run(DBusConnection, String, String, String)

Method Summary

Modifier and Type	Method	Description
DBusInterfaceInfo[]	run(DBusConnection connection, String sender, String objectPath, String node)	The type of the introspect function in GDBusSubtreeVTable.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment, MemorySegment, MemorySegment) method.
default MemorySegment	upcall(MemorySegment connection, MemorySegment sender, MemorySegment objectPath, MemorySegment node, MemorySegment userData)	The upcall method is called from native code.

Method Details

run

DBusInterfaceInfo[] run(DBusConnection connection,
 String sender,
 String objectPath,
 String node)

The type of the introspect function in GDBusSubtreeVTable.

Subtrees are flat. node, if non-null, is always exactly one segment of the object path (ie: it never contains a slash).

This function should return null to indicate that there is no object at this node.

If this function returns non-null, the return value is expected to be a null-terminated array of pointers to GDBusInterfaceInfo structures describing the interfaces implemented by node. This array will have g_dbus_interface_info_unref() called on each item before being freed with g_free().

The difference between returning null and an array containing zero items is that the standard DBus interfaces will returned to the remote introspector in the empty array case, but not in the null case.

Parameters:

connection - A GDBusConnection.

sender - The unique bus name of the remote caller.

objectPath - The object path that was registered with g_dbus_connection_register_subtree().

node - A node that is a child of objectPath (relative to objectPath) or null for the root of the subtree.

Returns:

A null-terminated array of pointers to GDBusInterfaceInfo, or null.

Since:

2.26

upcall

default MemorySegment upcall(MemorySegment connection,
 MemorySegment sender,
 MemorySegment objectPath,
 MemorySegment node,
 MemorySegment userData)

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

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment, 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