GLib.DBusObjectManagerServer – gio-2.0

Description:

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

DBusObjectManagerServer is used to export 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 DBusObjectManagerClient for the client-side code that is intended to be used with DBusObjectManagerServer 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

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref