qsparqlconnection.h

/***************************************************************************/
#ifndef QSPARQLCONNECTION_H
#define QSPARQLCONNECTION_H
 
#include <qsparql.h>
#include <qsparqlconnectionoptions.h>
#include <qsparqlbinding.h>
 
#include <QtCore/qstring.h>
#include <QDebug>
QT_BEGIN_HEADER
 
QT_BEGIN_NAMESPACE
 
QT_MODULE(Sparql)
 
class QSparqlError;
class QSparqlQuery;
class QSparqlResult;
class QSparqlConnectionPrivate;
class QSparqlQueryOptions;
class SparqlConnection;
 
class Q_SPARQL_EXPORT QSparqlConnection : public QObject
{
    Q_OBJECT
public:
    enum Feature {  QuerySize, DefaultGraph,
                    AskQueries, ConstructQueries, UpdateQueries,
                    SyncExec, AsyncExec };
    // TODO: QuerySize should be removed (API break).
 
    explicit QSparqlConnection(QObject* parent = 0);
    QSparqlConnection(const QString& type,
                      const QSparqlConnectionOptions& options = QSparqlConnectionOptions(),
                      QObject* parent = 0);
    ~QSparqlConnection();
 
    QSparqlResult* exec(const QSparqlQuery& query);
    QSparqlResult* exec(const  QSparqlQuery& query, const QSparqlQueryOptions& options);
    QSparqlResult* syncExec(const QSparqlQuery& query);
 
    bool isValid() const;
    QString driverName() const;
    bool hasFeature(Feature feature) const;
    bool hasError() const;
    QSparqlError lastError() const;
 
    void addPrefix(const QString& prefix, const QUrl& uri);
    void clearPrefixes();
 
    QUrl createUrn() const;
    QSparqlBinding createUrn(const QString& name) const;
 
    static QStringList drivers();
 
private:
    friend class QSparqlConnectionPrivate;
    friend class SparqlConnection;
 
    void qmlConstructor(const QString& type, const QSparqlConnectionOptions& options = QSparqlConnectionOptions());
 
    QSparqlConnectionPrivate *d; // replace with Q_DECLARE_PRIVATE when Qt publishes it
};
// TODO: make "validness" of a connection a QObject property
 
#ifndef QT_NO_DEBUG_STREAM
Q_SPARQL_EXPORT QDebug operator<<(QDebug, const QSparqlConnection &);
#endif
 
QT_END_NAMESPACE
 
QT_END_HEADER
 
#endif // QSPARQLCONNECTION_H