00001 /* 00002 * This file is part of Soprano Project. 00003 * 00004 * Copyright (C) 2007-2008 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 00166 virtual bool deleteModelData( const BackendSettings& settings ) const = 0; 00167 00175 virtual BackendFeatures supportedFeatures() const = 0; 00176 00186 virtual QStringList supportedUserFeatures() const; 00187 00194 bool supportsFeatures( BackendFeatures feature, const QStringList& userFeatures = QStringList() ) const; 00195 00196 private: 00197 class Private; 00198 Private* const d; 00199 }; 00200 } 00201 00202 Q_DECLARE_INTERFACE(Soprano::Backend, "org.soprano.plugins.Backend/2.1") 00203 00204 #endif