EBackend.SubprocessFactory

g EBackend.SubprocessFactory EBackend.SubprocessFactory GObject.GInterface GObject.GInterface Gio.Initable Gio.Initable GObject.GInterface->Gio.Initable GObject.Object GObject.Object GObject.Object->EBackend.SubprocessFactory Gio.Initable->EBackend.SubprocessFactory

Subclasses:

None

Methods

Inherited:

GObject.Object (37), Gio.Initable (2)

Structs:

GObject.ObjectClass (5)

class

construct_path ()

call_backends_prepare_shutdown ()

get_backends_list ()

get_registry ()

open_backend (connection, uid, backend_factory_type_name, module_filename, proxy, cancellable)

ref_initable_backend (uid, backend_factory_type_name, module_filename, cancellable)

set_backend_callbacks (backend, proxy)

Virtual Methods

Inherited:

GObject.Object (7), Gio.Initable (1)

do_backend_closed (backend)

do_backend_created (backend)

do_open_data (backend, connection, data, cancellable)

Properties

Name

Type

Flags

Short Description

registry

EDataServer.SourceRegistry

r

Data source registry

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent

GObject.Object

r

Class Details

class EBackend.SubprocessFactory(**kwargs)
Bases:

GObject.Object, Gio.Initable

Abstract:

No

Structure:

EBackend.SubprocessFactoryClass

Contains only private data that should be read and manipulated using the functions below.

New in version 3.16.

classmethod construct_path()
Returns:

a newly allocated string, representing the object path for the D-Bus interface.

This function is here for a lack of a better place

Return type:

str

Returns a new and unique object path for a D-Bus interface based in the data object path prefix of the subprocess_factory

New in version 3.16.

call_backends_prepare_shutdown()

Calls EBackend.Backend.prepare_shutdown() for the list of used backends.

New in version 3.16.

get_backends_list()
Returns:

A GLib.List that contains a list of used backends. The list should be freed by the caller using: g_list_free_full (backends, GObject.Object.unref).

Return type:

[EBackend.Backend]

Returns a list of used backends.

New in version 3.16.

get_registry()
Returns:

the EDataServer.SourceRegistry

Return type:

EDataServer.SourceRegistry

Returns the EDataServer.SourceRegistry owned by self.

New in version 3.16.

open_backend(connection, uid, backend_factory_type_name, module_filename, proxy, cancellable)
Parameters:
Raises:

GLib.Error

Returns:

a newly allocated string that represents the EBackend.Backend data D-Bus object path.

Return type:

str

Returns the EBackend.Backend data D-Bus object path

New in version 3.16.

ref_initable_backend(uid, backend_factory_type_name, module_filename, cancellable)
Parameters:
Raises:

GLib.Error

Returns:

an EBackend.Backend for source, or None

Return type:

EBackend.Backend or None

Returns either a newly-created or existing EBackend.Backend for EDataServer.Source. The returned EBackend.Backend is referenced for thread-safety and must be unreferenced with GObject.Object.unref() when finished with it.

If the newly-created backend implements the Gio.Initable interface, then Gio.Initable.init() is also called on it using cancellable and error.

The self retains a strong reference to backend.

If no suitable EBackend.BackendFactory exists, or if the EBackend.Backend fails to initialize, the function sets error and returns None.

New in version 3.16.

set_backend_callbacks(backend, proxy)
Parameters:

Installs a toggle reference on the backend, that can receive a signal to shutdown once all client connections are closed.

New in version 3.16.

do_backend_closed(backend) virtual
Parameters:

backend (EBackend.Backend) –

do_backend_created(backend) virtual
Parameters:

backend (EBackend.Backend) –

do_open_data(backend, connection, data, cancellable) virtual
Parameters:
Return type:

str

Property Details

EBackend.SubprocessFactory.props.registry
Name:

registry

Type:

EDataServer.SourceRegistry

Default Value:

None

Flags:

READABLE

Data source registry