Interface DBusInterfaceMethodCallFunc

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 DBusInterfaceMethodCallFunc
extends FunctionPointer

Functional interface declaration of the DBusInterfaceMethodCallFunc callback.

See Also:

• run(DBusConnection, String, String, String, String, Variant, DBusMethodInvocation)

Method Summary

Modifier and Type	Method	Description
void	run(DBusConnection connection, @Nullable String sender, String objectPath, @Nullable String interfaceName, String methodName, Variant parameters, DBusMethodInvocation invocation)	The type of the methodCall function in GDBusInterfaceVTable.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(MemorySegment, MemorySegment, MemorySegment, MemorySegment, MemorySegment, MemorySegment, MemorySegment, MemorySegment) method.
default void	upcall(MemorySegment connection, MemorySegment sender, MemorySegment objectPath, MemorySegment interfaceName, MemorySegment methodName, MemorySegment parameters, MemorySegment invocation, MemorySegment userData)	The upcall method is called from native code.

Method Details

run

void run(DBusConnection connection,
 @Nullable String sender,
 String objectPath,
 @Nullable String interfaceName,
 String methodName,
 Variant parameters,
 DBusMethodInvocation invocation)

The type of the methodCall function in GDBusInterfaceVTable.

interfaceName may be NULL if not specified by the sender, although it’s encouraged for the sender to set it. If unset, and the object has only one method (across all interfaces) matching methodName, that method is invoked. Otherwise, behaviour is implementation defined. See the D-Bus specification. It is recommended to return Gio.DBusError.UNKNOWN_METHOD.

Parameters:

connection - A GDBusConnection.

sender - The unique bus name of the remote caller, or NULL if not specified by the caller, e.g. on peer-to-peer connections.

objectPath - The object path that the method was invoked on.

interfaceName - The D-Bus interface name the method was invoked on, or NULL if not specified by the sender.

methodName - The name of the method that was invoked.

parameters - A GVariant tuple with parameters.

invocation - A GDBusMethodInvocation object that must be used to return a value or error.

Since:

2.26

upcall

default void upcall(MemorySegment connection,
 MemorySegment sender,
 MemorySegment objectPath,
 MemorySegment interfaceName,
 MemorySegment methodName,
 MemorySegment parameters,
 MemorySegment invocation,
 MemorySegment userData)

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

toCallback

default MemorySegment toCallback(Arena arena)

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