/usr/include/soprano/dbusclient.h is in libsoprano-dev 2.9.4+dfsg-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | /*
* This file is part of Soprano Project.
*
* Copyright (C) 2007 Sebastian Trueg <trueg@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef _SOPRANO_SERVER_DBUS_CLIENT_H_
#define _SOPRANO_SERVER_DBUS_CLIENT_H_
#include <QtCore/QObject>
#include "backend.h"
#include "error.h"
#include "soprano_export.h"
namespace Soprano {
class Model;
namespace Client {
class DBusModel;
/**
* \class DBusClient dbusclient.h Soprano/Client/DBusClient
*
* \brief 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>
*
* \sa \ref soprano_server_dbus
*/
class SOPRANO_CLIENT_EXPORT DBusClient : public QObject, public Error::ErrorCache
{
Q_OBJECT
public:
/**
* Create a new DBus client.
*
* \param service The DBus service name. If empty the client will use the
* default Soprano service name.
* \param parent The parent object.
*/
DBusClient( const QString& service = QString(), QObject* parent = 0 );
/**
* Destructor
*/
~DBusClient();
/**
* Check if the service is valid and available.
*
* \return \p true if the Soprano server service could be found and used.
* Otherwise returns \p false.
*/
bool isValid() const;
/**
* Retrive a list of all models that are available.
*
* \return A list of model names to be used with createModel()
*/
QStringList allModels() const;
/**
* Creates a new Model instance that wraps a dbus server model.
*
* \param name The name of the model to access.
* \param settings Settings for future extension. Not used yet.
*
* \return A new Model instance wrapping the requested server
* model or 0 on error (check lastError() for details.)
*/
DBusModel* createModel( const QString& name, const BackendSettings& settings = BackendSettings() );
/**
* Deletes a model including all its data.
*
* \param name The name of the model to remove.
*
* \warning Calling this method will remove all data physically. It can not
* be reverted. Use with care.
*/
void removeModel( const QString& name );
private:
class Private;
Private* const d;
};
}
}
#endif
|