soprano/backend.h

Go to the documentation of this file.
00001 /*
00002  * This file is part of Soprano Project.
00003  *
00004  * Copyright (C) 2007 Sebastian Trueg <trueg@kde.org>
00005  *
00006  * This library is free software; you can redistribute it and/or
00007  * modify it under the terms of the GNU Library General Public
00008  * License as published by the Free Software Foundation; either
00009  * version 2 of the License, or (at your option) any later version.
00010  *
00011  * This library is distributed in the hope that it will be useful,
00012  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00013  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014  * Library General Public License for more details.
00015  *
00016  * You should have received a copy of the GNU Library General Public License
00017  * along with this library; see the file COPYING.LIB.  If not, write to
00018  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00019  * Boston, MA 02110-1301, USA.
00020  */
00021 
00022 #ifndef _SOPRANO_BACKEND_H_
00023 #define _SOPRANO_BACKEND_H_
00024 
00025 #include "plugin.h"
00026 #include "error.h"
00027 #include "soprano_export.h"
00028 #include "sopranotypes.h"
00029 
00030 #include <QtCore/QStringList>
00031 #include <QtCore/QVariant>
00032 #include <QtCore/QSharedDataPointer>
00033 
00034 
00035 namespace Soprano
00036 {
00037     class StorageModel;
00038 
00052     class SOPRANO_EXPORT BackendSetting
00053     {
00054     public:
00059         BackendSetting();
00060 
00064         BackendSetting( BackendOption option );
00065 
00069         BackendSetting( BackendOption s, const QVariant& value_ );
00070 
00074         BackendSetting( const QString& userOption, const QVariant& value_ );
00075 
00079         BackendSetting( const BackendSetting& other );
00080 
00084         ~BackendSetting();
00085 
00089         BackendSetting& operator=( const BackendSetting& other );
00090 
00095         BackendOption option() const;
00096 
00100         QString userOptionName() const;
00101 
00105         QVariant value() const;
00106 
00110         void setValue( const QVariant& value );
00111 
00112     private:
00113         class Private;
00114         QSharedDataPointer<Private> d;
00115     };
00116 
00117     typedef QList<BackendSetting> BackendSettings;
00118 
00132     class SOPRANO_EXPORT Backend : public Plugin, public Error::ErrorCache
00133     {
00134     public:
00135         Backend( const QString& name );
00136         virtual ~Backend();
00137 
00149         virtual StorageModel* createModel( const BackendSettings& settings = BackendSettings() ) const = 0;
00150 
00158         virtual BackendFeatures supportedFeatures() const = 0;
00159 
00169         virtual QStringList supportedUserFeatures() const;
00170 
00177         bool supportsFeatures( BackendFeatures feature, const QStringList& userFeatures = QStringList() ) const;
00178 
00179     private:
00180         class Private;
00181         Private* const d;
00182     };
00183 }
00184 
00185 Q_DECLARE_INTERFACE(Soprano::Backend, "org.soprano.plugins.Backend/2.0")
00186 
00187 #endif

Generated on Fri Mar 7 18:57:44 2008 for Soprano by  doxygen 1.5.4