Package org.gnome.gio

Interface DBusServer.NewConnectionCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

DBusServer

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 DBusServer.NewConnectionCallback
extends FunctionPointer

Functional interface declaration of the NewConnectionCallback callback.

See Also:

• run(org.gnome.gio.DBusConnection)

Method Summary

Modifier and Type	Method	Description
boolean	run(@Nullable DBusConnection connection)	Emitted when a new authenticated connection has been made.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment) method.
default int	upcall(MemorySegment sourceDBusServer, MemorySegment connection)	The upcall method is called from native code.

Method Details

run

boolean run(@Nullable DBusConnection connection)

Emitted when a new authenticated connection has been made. Use g_dbus_connection_get_peer_credentials() to figure out what identity (if any), was authenticated.

If you want to accept the connection, take a reference to the connection object and return true. When you are done with the connection call g_dbus_connection_close() and give up your reference. Note that the other peer may disconnect at any time - a typical thing to do when accepting a connection is to listen to the GDBusConnection::closed signal.

If GDBusServer:flags contains DBusServerFlags.RUN_IN_THREAD then the signal is emitted in a new thread dedicated to the connection. Otherwise the signal is emitted in the thread-default main context (see MainContext.pushThreadDefault()) of the thread that server was constructed in.

You are guaranteed that signal handlers for this signal runs before incoming messages on connection are processed. This means that it's suitable to call g_dbus_connection_register_object() or similar from the signal handler.

Since:

2.26

upcall

default int upcall(MemorySegment sourceDBusServer,
 MemorySegment connection)

The upcall method is called from native code. The parameters are marshaled and run(org.gnome.gio.DBusConnection) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

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

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the arena in which the function pointer is allocated

Returns:

the native function pointer