# class DBusClient

###

Module | soprano
Namespace | Soprano::Client
Class | DBusClient
Inherits | QObject,Soprano::Error::ErrorCache

\class DBusClient dbusclient.h Soprano/Client/DBusClient

Core class to handle a connection to a Soprano server through the DBus interface.

DBusClient creates a connection to a running Soprano Server via its DBus interface. All DBus communication is handled internally.

See DBusModel for details about thread-safety.

Author Sebastian Trueg <trueg@kde.org>

See also soprano_server_dbus

### methods

- DBusClient (service, parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  service | QString | QString()
  parent | QObject | 0

  Create a new DBus client.

  service - The DBus service name. If empty the client will use the default Soprano service name.

  parent - The parent object.

- allModels ( )

  returns QStringList

  Retrive a list of all models that are available.

  Returns A list of model names to be used with createModel()

- createModel (name, settings)

  returns Soprano.Client.DBusModel

  Argument | Type | Default
  --- | --- | ---
  name | QString |
  settings | Soprano.BackendSettings | Soprano.Soprano.BackendSettings()

  Creates a new Model instance that wraps a dbus server model.

  name - The name of the model to access.

  settings - Settings for future extension. Not used yet.

  Returns A new Model instance wrapping the requested server model or 0 on error (check lastError() for details.)

- isValid ( )

  returns bool

  Check if the service is valid and available.

  Returns true if the Soprano server service could be found and used. Otherwise returns false.

- removeModel (name)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  name | QString |

  Deletes a model including all its data.

  name - The name of the model to remove.

  Calling this method will remove all data physically. It can not be reverted. Use with care.