Package org.gnome.gio

Class DBusObjectManagerClient

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gio.DBusObjectManagerClient

All Implemented Interfaces:

Proxy, AsyncInitable, DBusObjectManager, Initable

@Generated("io.github.jwharm.JavaGI")
public class DBusObjectManagerClient
extends GObject
implements AsyncInitable, DBusObjectManager, Initable

GDBusObjectManagerClient is used to create, monitor and delete object proxies for remote objects exported by a DBusObjectManagerServer (or any code implementing the org.freedesktop.DBus.ObjectManager interface).

Once an instance of this type has been created, you can connect to the Gio.DBusObjectManager::object-added and Gio.DBusObjectManager::object-removed signals and inspect the DBusObjectProxy objects returned by DBusObjectManager.getObjects().

If the name for a GDBusObjectManagerClient is not owned by anyone at object construction time, the default behavior is to request the message bus to launch an owner for the name. This behavior can be disabled using the G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_DO_NOT_AUTO_START flag. It’s also worth noting that this only works if the name of interest is activatable in the first place. E.g. in some cases it is not possible to launch an owner for the requested name. In this case, GDBusObjectManagerClient object construction still succeeds but there will be no object proxies (e.g. DBusObjectManager.getObjects() returns the empty list) and the Gio.DBusObjectManagerClient:name-owner property is NULL.

The owner of the requested name can come and go (for example consider a system service being restarted) – GDBusObjectManagerClient handles this case too; simply connect to the GObject.Object::notify signal to watch for changes on the Gio.DBusObjectManagerClient:name-owner property. When the name owner vanishes, the behavior is that Gio.DBusObjectManagerClient:name-owner is set to NULL (this includes emission of the GObject.Object::notify signal) and then Gio.DBusObjectManager::object-removed signals are synthesized for all currently existing object proxies. Since Gio.DBusObjectManagerClient:name-owner is NULL when this happens, you can use this information to disambiguate a synthesized signal from a genuine signal caused by object removal on the remote DBusObjectManager. Similarly, when a new name owner appears, Gio.DBusObjectManager::object-added signals are synthesized while Gio.DBusObjectManagerClient:name-owner is still NULL. Only when all object proxies have been added, the Gio.DBusObjectManagerClient:name-owner is set to the new name owner (this includes emission of the GObject.Object::notify signal). Furthermore, you are guaranteed that Gio.DBusObjectManagerClient:name-owner will alternate between a name owner (e.g. :1.42) and NULL even in the case where the name of interest is atomically replaced

Ultimately, GDBusObjectManagerClient is used to obtain DBusProxy instances. All signals (including the org.freedesktop.DBus.Properties::PropertiesChanged signal) delivered to DBusProxy instances are guaranteed to originate from the name owner. This guarantee along with the behavior described above, means that certain race conditions including the “half the proxy is from the old owner and the other half is from the new owner” problem cannot happen.

To avoid having the application connect to signals on the returned DBusObjectProxy and DBusProxy objects, the Gio.DBusObject::interface-added, Gio.DBusObject::interface-removed, Gio.DBusProxy::g-properties-changed and Gio.DBusProxy::g-signal signals are also emitted on the GDBusObjectManagerClient instance managing these objects. The signals emitted are Gio.DBusObjectManager::interface-added, Gio.DBusObjectManager::interface-removed, Gio.DBusObjectManagerClient::interface-proxy-properties-changed and Gio.DBusObjectManagerClient::interface-proxy-signal.

Note that all callbacks and signals are emitted in the thread-default main context (see MainContext.pushThreadDefault()) that the GDBusObjectManagerClient object was constructed in. Additionally, the DBusObjectProxy and DBusProxy objects originating from the GDBusObjectManagerClient object will be created in the same context and, consequently, will deliver signals in the same main loop.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DBusObjectManagerClient.Builder<B extends DBusObjectManagerClient.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	DBusObjectManagerClient.DBusObjectManagerClientClass	Class structure for GDBusObjectManagerClient.
static interface	DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback	Functional interface declaration of the InterfaceProxyPropertiesChangedCallback callback.
static interface	DBusObjectManagerClient.InterfaceProxySignalCallback	Functional interface declaration of the InterfaceProxySignalCallback callback.

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gio.AsyncInitable

AsyncInitable.AsyncInitableIface, AsyncInitable.AsyncInitableImpl

Nested classes/interfaces inherited from interface org.gnome.gio.DBusObjectManager

DBusObjectManager.DBusObjectManagerIface, DBusObjectManager.DBusObjectManagerImpl, DBusObjectManager.InterfaceAddedCallback, DBusObjectManager.InterfaceRemovedCallback, DBusObjectManager.ObjectAddedCallback, DBusObjectManager.ObjectRemovedCallback

Nested classes/interfaces inherited from interface org.gnome.gio.Initable

Initable.InitableIface, Initable.InitableImpl

Constructor Summary

Constructors

Constructor	Description
DBusObjectManagerClient(MemorySegment address)	Create a DBusObjectManagerClient proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected DBusObjectManagerClient	asParent()	Returns this instance as if it were its parent type.
static DBusObjectManagerClient.Builder<? extends DBusObjectManagerClient.Builder>	builder()	A DBusObjectManagerClient.Builder object constructs a DBusObjectManagerClient with the specified properties.
void	emitInterfaceProxyPropertiesChanged(DBusObjectProxy objectProxy, DBusProxy interfaceProxy, Variant changedProperties, String[] invalidatedProperties)	Emits the "interface-proxy-properties-changed" signal.
void	emitInterfaceProxySignal(DBusObjectProxy objectProxy, DBusProxy interfaceProxy, String senderName, String signalName, Variant parameters)	Emits the "interface-proxy-signal" signal.
static DBusObjectManagerClient	finish(AsyncResult res)	Finishes an operation started with g_dbus_object_manager_client_new().
static DBusObjectManagerClient	forBusFinish(AsyncResult res)	Finishes an operation started with g_dbus_object_manager_client_new_for_bus().
static DBusObjectManagerClient	forBusSync(BusType busType, Set<DBusObjectManagerClientFlags> flags, String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable)	Like g_dbus_object_manager_client_new_sync() but takes a GBusType instead of a GDBusConnection.
static DBusObjectManagerClient	forBusSync(BusType busType, DBusObjectManagerClientFlags flags, String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable)	Like g_dbus_object_manager_client_new_sync() but takes a GBusType instead of a GDBusConnection.
DBusConnection	getConnection()	Gets the GDBusConnection used by this DBusObjectManagerClient.
Set<DBusObjectManagerClientFlags>	getFlags()	Gets the flags that this DBusObjectManagerClient was constructed with.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
String	getName()	Gets the name that this DBusObjectManagerClient is for, or null if not a message bus connection.
String	getNameOwner()	The unique name that owns the name that this DBusObjectManagerClient is for or null if no-one currently owns that name.
static Type	getType()	Get the GType of the DBusObjectManagerClient class
protected void	interfaceProxyPropertiesChanged(DBusObjectProxy objectProxy, DBusProxy interfaceProxy, Variant changedProperties, String invalidatedProperties)	Signal class handler for the GDBusObjectManagerClient::interface-proxy-properties-changed signal.
protected void	interfaceProxySignal(DBusObjectProxy objectProxy, DBusProxy interfaceProxy, String senderName, String signalName, Variant parameters)	Signal class handler for the GDBusObjectManagerClient::interface-proxy-signal signal.
static void	new_(DBusConnection connection, Set<DBusObjectManagerClientFlags> flags, String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable, @Nullable AsyncReadyCallback callback)	Asynchronously creates a new GDBusObjectManagerClient object.
static void	new_(DBusConnection connection, DBusObjectManagerClientFlags flags, String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable, @Nullable AsyncReadyCallback callback)	Asynchronously creates a new GDBusObjectManagerClient object.
static void	newForBus(BusType busType, Set<DBusObjectManagerClientFlags> flags, String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable, @Nullable AsyncReadyCallback callback)	Like g_dbus_object_manager_client_new() but takes a GBusType instead of a GDBusConnection.
static void	newForBus(BusType busType, DBusObjectManagerClientFlags flags, String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable, @Nullable AsyncReadyCallback callback)	Like g_dbus_object_manager_client_new() but takes a GBusType instead of a GDBusConnection.
SignalConnection<DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback>	onInterfaceProxyPropertiesChanged(DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback handler)	Emitted when one or more D-Bus properties on proxy changes.
SignalConnection<DBusObjectManagerClient.InterfaceProxySignalCallback>	onInterfaceProxySignal(DBusObjectManagerClient.InterfaceProxySignalCallback handler)	Emitted when a D-Bus signal is received on interfaceProxy.
static DBusObjectManagerClient	sync(DBusConnection connection, Set<DBusObjectManagerClientFlags> flags, @Nullable String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable)	Creates a new GDBusObjectManagerClient object.
static DBusObjectManagerClient	sync(DBusConnection connection, DBusObjectManagerClientFlags flags, @Nullable String name, String objectPath, @Nullable DBusProxyTypeFunc getProxyTypeFunc, @Nullable Cancellable cancellable)	Creates a new GDBusObjectManagerClient object.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newInstance, newInstance, newv, notify_, notify_, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, getPrivate, readGClass, writeGClass

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gnome.gio.AsyncInitable

initAsync, initFinish

Methods inherited from interface org.gnome.gio.DBusObjectManager

emitInterfaceAdded, emitInterfaceRemoved, emitObjectAdded, emitObjectRemoved, getInterface, getObject, getObjectPath, getObjects, onInterfaceAdded, onInterfaceRemoved, onObjectAdded, onObjectRemoved

Methods inherited from interface org.gnome.gio.Initable

init

Methods inherited from interface io.github.jwharm.javagi.base.Proxy

handle

Constructor Details

DBusObjectManagerClient

public DBusObjectManagerClient(MemorySegment address)

Create a DBusObjectManagerClient proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Method Details

getType

public static Type getType()

Get the GType of the DBusObjectManagerClient class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected DBusObjectManagerClient asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

finish

public static DBusObjectManagerClient finish(AsyncResult res)
                                      throws GErrorException

Finishes an operation started with g_dbus_object_manager_client_new().

Parameters:

res - A GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_object_manager_client_new().

Returns:

A GDBusObjectManagerClient object or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

forBusFinish

public static DBusObjectManagerClient forBusFinish(AsyncResult res)
                                            throws GErrorException

Finishes an operation started with g_dbus_object_manager_client_new_for_bus().

Parameters:

res - A GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_object_manager_client_new_for_bus().

Returns:

A GDBusObjectManagerClient object or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

forBusSync

public static DBusObjectManagerClient forBusSync(BusType busType,
 Set<DBusObjectManagerClientFlags> flags,
 String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable)
                                          throws GErrorException

Like g_dbus_object_manager_client_new_sync() but takes a GBusType instead of a GDBusConnection.

This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new_for_bus() for the asynchronous version.

Parameters:

busType - A GBusType.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name).

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

Returns:

A GDBusObjectManagerClient object or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

forBusSync

public static DBusObjectManagerClient forBusSync(BusType busType,
 DBusObjectManagerClientFlags flags,
 String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable)
                                          throws GErrorException

Like g_dbus_object_manager_client_new_sync() but takes a GBusType instead of a GDBusConnection.

This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new_for_bus() for the asynchronous version.

Parameters:

busType - A GBusType.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name).

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

Returns:

A GDBusObjectManagerClient object or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

sync

public static DBusObjectManagerClient sync(DBusConnection connection,
 Set<DBusObjectManagerClientFlags> flags,
 @Nullable
 @Nullable String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable)
                                    throws GErrorException

Creates a new GDBusObjectManagerClient object.

This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new() for the asynchronous version.

Parameters:

connection - A GDBusConnection.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name), or null when not using a message bus connection.

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

Returns:

A GDBusObjectManagerClient object or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

sync

public static DBusObjectManagerClient sync(DBusConnection connection,
 DBusObjectManagerClientFlags flags,
 @Nullable
 @Nullable String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable)
                                    throws GErrorException

Creates a new GDBusObjectManagerClient object.

This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new() for the asynchronous version.

Parameters:

connection - A GDBusConnection.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name), or null when not using a message bus connection.

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

Returns:

A GDBusObjectManagerClient object or null if error is set. Free with g_object_unref().

Throws:

GErrorException - see GError

new_

public static void new_(DBusConnection connection,
 Set<DBusObjectManagerClientFlags> flags,
 String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable,
 @Nullable
 @Nullable AsyncReadyCallback callback)

Asynchronously creates a new GDBusObjectManagerClient object.

This is an asynchronous failable constructor. When the result is ready, callback will be invoked in the [thread-default main context][g-main-context-push-thread-default] of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_finish() to get the result. See g_dbus_object_manager_client_new_sync() for the synchronous version.

Parameters:

connection - A GDBusConnection.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name).

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

callback - A GAsyncReadyCallback to call when the request is satisfied.

new_

public static void new_(DBusConnection connection,
 DBusObjectManagerClientFlags flags,
 String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable,
 @Nullable
 @Nullable AsyncReadyCallback callback)

Asynchronously creates a new GDBusObjectManagerClient object.

This is an asynchronous failable constructor. When the result is ready, callback will be invoked in the [thread-default main context][g-main-context-push-thread-default] of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_finish() to get the result. See g_dbus_object_manager_client_new_sync() for the synchronous version.

Parameters:

connection - A GDBusConnection.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name).

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

callback - A GAsyncReadyCallback to call when the request is satisfied.

newForBus

public static void newForBus(BusType busType,
 Set<DBusObjectManagerClientFlags> flags,
 String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable,
 @Nullable
 @Nullable AsyncReadyCallback callback)

Like g_dbus_object_manager_client_new() but takes a GBusType instead of a GDBusConnection.

This is an asynchronous failable constructor. When the result is ready, callback will be invoked in the [thread-default main loop][g-main-context-push-thread-default] of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version.

Parameters:

busType - A GBusType.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name).

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

callback - A GAsyncReadyCallback to call when the request is satisfied.

newForBus

public static void newForBus(BusType busType,
 DBusObjectManagerClientFlags flags,
 String name,
 String objectPath,
 @Nullable
 @Nullable DBusProxyTypeFunc getProxyTypeFunc,
 @Nullable
 @Nullable Cancellable cancellable,
 @Nullable
 @Nullable AsyncReadyCallback callback)

Like g_dbus_object_manager_client_new() but takes a GBusType instead of a GDBusConnection.

This is an asynchronous failable constructor. When the result is ready, callback will be invoked in the [thread-default main loop][g-main-context-push-thread-default] of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version.

Parameters:

busType - A GBusType.

flags - Zero or more flags from the GDBusObjectManagerClientFlags enumeration.

name - The owner of the control object (unique or well-known name).

objectPath - The object path of the control object.

getProxyTypeFunc - A GDBusProxyTypeFunc function or null to always construct GDBusProxy proxies.

cancellable - A GCancellable or null

callback - A GAsyncReadyCallback to call when the request is satisfied.

getConnection

public DBusConnection getConnection()

Gets the GDBusConnection used by this DBusObjectManagerClient.

Returns:

A GDBusConnection object. Do not free, the object belongs to this DBusObjectManagerClient.

getFlags

public Set<DBusObjectManagerClientFlags> getFlags()

Gets the flags that this DBusObjectManagerClient was constructed with.

Returns:

Zero of more flags from the GDBusObjectManagerClientFlags enumeration.

getName

public String getName()

Gets the name that this DBusObjectManagerClient is for, or null if not a message bus connection.

Returns:

A unique or well-known name. Do not free, the string belongs to this DBusObjectManagerClient.

getNameOwner

public String getNameOwner()

The unique name that owns the name that this DBusObjectManagerClient is for or null if no-one currently owns that name. You can connect to the GObject::notify signal to track changes to the GDBusObjectManagerClient:name-owner property.

Returns:

The name owner or null if no name owner exists. Free with g_free().

interfaceProxyPropertiesChanged

protected void interfaceProxyPropertiesChanged(DBusObjectProxy objectProxy,
 DBusProxy interfaceProxy,
 Variant changedProperties,
 String invalidatedProperties)

Signal class handler for the GDBusObjectManagerClient::interface-proxy-properties-changed signal.

interfaceProxySignal

protected void interfaceProxySignal(DBusObjectProxy objectProxy,
 DBusProxy interfaceProxy,
 String senderName,
 String signalName,
 Variant parameters)

Signal class handler for the GDBusObjectManagerClient::interface-proxy-signal signal.

onInterfaceProxyPropertiesChanged

public SignalConnection<DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback> onInterfaceProxyPropertiesChanged(DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback handler)

Emitted when one or more D-Bus properties on proxy changes. The local cache has already been updated when this signal fires. Note that both changedProperties and invalidatedProperties are guaranteed to never be null (either may be empty though).

This signal exists purely as a convenience to avoid having to connect signals to all interface proxies managed by manager.

This signal is emitted in the [thread-default main context][g-main-context-push-thread-default] that manager was constructed in.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback.run(org.gnome.gio.DBusObjectProxy, org.gnome.gio.DBusProxy, org.gnome.glib.Variant, java.lang.String[])

emitInterfaceProxyPropertiesChanged

public void emitInterfaceProxyPropertiesChanged(DBusObjectProxy objectProxy,
 DBusProxy interfaceProxy,
 Variant changedProperties,
 String[] invalidatedProperties)

Emits the "interface-proxy-properties-changed" signal. See onInterfaceProxyPropertiesChanged(org.gnome.gio.DBusObjectManagerClient.InterfaceProxyPropertiesChangedCallback).

onInterfaceProxySignal

public SignalConnection<DBusObjectManagerClient.InterfaceProxySignalCallback> onInterfaceProxySignal(DBusObjectManagerClient.InterfaceProxySignalCallback handler)

Emitted when a D-Bus signal is received on interfaceProxy.

This signal exists purely as a convenience to avoid having to connect signals to all interface proxies managed by manager.

This signal is emitted in the [thread-default main context][g-main-context-push-thread-default] that manager was constructed in.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• DBusObjectManagerClient.InterfaceProxySignalCallback.run(org.gnome.gio.DBusObjectProxy, org.gnome.gio.DBusProxy, java.lang.String, java.lang.String, org.gnome.glib.Variant)

emitInterfaceProxySignal

public void emitInterfaceProxySignal(DBusObjectProxy objectProxy,
 DBusProxy interfaceProxy,
 String senderName,
 String signalName,
 Variant parameters)

Emits the "interface-proxy-signal" signal. See onInterfaceProxySignal(org.gnome.gio.DBusObjectManagerClient.InterfaceProxySignalCallback).

builder

public static DBusObjectManagerClient.Builder<? extends DBusObjectManagerClient.Builder> builder()

A DBusObjectManagerClient.Builder object constructs a DBusObjectManagerClient with the specified properties. Use the various set...() methods to set properties, and finish construction with DBusObjectManagerClient.Builder.build().