Tracker.EndpointDBus¶

This object is a [class`Endpoint`] subclass that exports a [class`SparqlConnection`] so its RDF data is accessible to other processes through the given [class`Gio`.DBusConnection].

```c // This process already has org.example.Endpoint bus name endpoint = Tracker.EndpointDBus.new (sparql_connection, dbus_connection, None, None, &error);

// From another process connection = Tracker.SparqlConnection.bus_new (“org.example.Endpoint”, None, dbus_connection, &error); ```

The TrackerEndpointDBus will manage a DBus object at the given path with the org.freedesktop.Tracker3.Endpoint interface, if no path is given the object will be at the default /org/freedesktop/Tracker3/Endpoint location.

Access to D-Bus endpoints may be managed via the [signal`EndpointDBus`:py:func:::block-call<Tracker.EndpointDBus.signals.block_call>] signal, the boolean return value expressing whether the request is blocked or not. Inspection of the requester address is left up to the user. The default value allows all requests independently of their provenance.

However, moderating access to D-Bus interfaces is typically not necessary in user code, as access to public D-Bus endpoints will be transparently managed through the Tracker portal service for applications sandboxed via XDG portals. These already have access to D-Bus SPARQL endpoints and their data naturally filtered as defined in the application manifest.

A TrackerEndpointDBus may be created on a different thread/main context from the one that created [class`SparqlConnection`].

classmethod new(sparql_connection, dbus_connection, object_path, cancellable)¶

Parameters:

sparql_connection (Tracker.SparqlConnection) – The [class`SparqlConnection`] being made public
dbus_connection (Gio.DBusConnection) – Gio.DBusConnection to expose the DBus object over
object_path (str or None) – The object path to use, or None to use the default
cancellable (Gio.Cancellable or None) – Optional [type`Gio`.Cancellable]

Raises:

GLib.Error

Returns:

a TrackerEndpointDBus object.

Return type:

Tracker.EndpointDBus

Registers a Tracker endpoint object at object_path on dbus_connection. The default object path is /org/freedesktop/Tracker3/Endpoint.

Signal Details¶

Tracker.EndpointDBus.signals.block_call(endpoint_d_bus, object)¶

Signal Name:

block-call

Flags:

Parameters:

endpoint_d_bus (Tracker.EndpointDBus) – The object which received the signal
object (str) –

Return type:

bool

Property Details¶

Tracker.EndpointDBus.props.dbus_connection¶

Name:: dbus-connection
Type:: Gio.DBusConnection
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The [class`Gio`.DBusConnection] where the connection is proxied through.

Tracker.EndpointDBus.props.object_path¶

Name:: object-path
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The DBus object path that this endpoint manages.