DBusObjectManagerServer

Object Hierarchy:

Description:

[ CCode ( type_id = "g_dbus_object_manager_server_get_type ()" ) ]
[ Version ( since = "2.30" ) ]
public class DBusObjectManagerServer : Object, DBusObjectManager

`GDBusObjectManagerServer` is used to export [iface@Gio.

DBusObject] instances using the standardized `org.freedesktop.DBus.ObjectManager` interface. For example, remote D-Bus clients can get all objects and properties in a single call. Additionally, any change in the object hierarchy is broadcast using signals. This means that D-Bus clients can keep caches up to date by only listening to D-Bus signals.

The recommended path to export an object manager at is the path form of the well-known name of a D-Bus service, or below. For example, if a D-Bus service is available at the well-known name `net.example.ExampleService1`, the object manager should typically be exported at `/net/example/ExampleService1`, or below (to allow for multiple object managers in a service).

It is supported, but not recommended, to export an object manager at the root path, `/`.

See [class@Gio.DBusObjectManagerClient] for the client-side code that is intended to be used with `GDBusObjectManagerServer` or any D-Bus object implementing the `org.freedesktop.DBus.ObjectManager` interface.

Namespace: GLib

Package: gio-2.0

Content:

Properties:

public DBusConnection connection { owned get; set; }
The DBusConnection to export objects on.
public string object_path { owned get; construct; }
The object path to register the manager object at.

Creation methods:

public DBusObjectManagerServer (string object_path)
Creates a new DBusObjectManagerServer object.

Methods:

public void export (DBusObjectSkeleton object)
Exports object on this.
public void export_uniquely (DBusObjectSkeleton object)
Like export but appends a string of the form _N (with N being a natural number) to object's object path if an object with the given path already exists.
public DBusConnection? get_connection ()
Gets the DBusConnection used by this.
public bool is_exported (DBusObjectSkeleton object)
Returns whether object is currently exported on this.
public void set_connection (DBusConnection? connection)
Exports all objects managed by this on connection.
public bool unexport (string object_path)
If this has an object at path , removes the object.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface GLib.DBusObjectManager