gio/org.gtkkn.bindings.gio/DBusObjectManagerServer

DBusObjectManagerServer

open class DBusObjectManagerServer(pointer: <Error class: unknown class><<Error class: unknown class>>) : 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.

Skipped during bindings generation

method object-path: Property has no getter nor setter

Since

2.30

Constructors

DBusObjectManagerServer

constructor(objectPath: String)

Creates a new #GDBusObjectManagerServer object.

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion

Properties

connection

open var connection: DBusConnection?

The #GDBusConnection to export objects on.

gioDBusObjectManagerPointer

open override val gioDBusObjectManagerPointer: <Error class: unknown class><<Error class: unknown class>>

gioDBusObjectManagerServerPointer

val gioDBusObjectManagerServerPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

connectInterfaceAdded

open fun connectInterfaceAdded(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (object: DBusObject, interface: DBusInterface) -> Unit): <Error class: unknown class>

Emitted when @interface is added to @object.

connectInterfaceRemoved

open fun connectInterfaceRemoved(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (object: DBusObject, interface: DBusInterface) -> Unit): <Error class: unknown class>

Emitted when @interface has been removed from @object.

connectObjectAdded

open fun connectObjectAdded(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (object: DBusObject) -> Unit): <Error class: unknown class>

Emitted when @object is added to @manager.

connectObjectRemoved

open fun connectObjectRemoved(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (object: DBusObject) -> Unit): <Error class: unknown class>

Emitted when @object is removed from @manager.

export

open fun export(object: DBusObjectSkeleton)

Exports @object on @manager.

exportUniquely

open fun exportUniquely(object: DBusObjectSkeleton)

Like g_dbus_object_manager_server_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. As such, the #GDBusObjectProxy:g-object-path property of @object may be modified.

getConnection

open fun getConnection(): DBusConnection?

Gets the #GDBusConnection used by @manager.

getInterface