/**************************************************************************** ** ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the QtSql module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** No Commercial Usage ** This file contains pre-release code and may not be distributed. ** You may use this file in accordance with the terms and conditions ** contained in the Technology Preview License Agreement accompanying ** this package. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain ** additional rights. These rights are described in the Nokia Qt LGPL ** Exception version 1.1, included in the file LGPL_EXCEPTION.txt in this ** package. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** ** ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QSQLDATABASE_H #define QSQLDATABASE_H #include #include #ifdef QT3_SUPPORT #include #endif QT_BEGIN_HEADER QT_BEGIN_NAMESPACE QT_MODULE(Sql) class QSqlError; class QSqlDriver; class QSqlIndex; class QSqlRecord; class QSqlQuery; class QSqlDatabasePrivate; class Q_SQL_EXPORT QSqlDriverCreatorBase { public: virtual ~QSqlDriverCreatorBase() {} virtual QSqlDriver *createObject() const = 0; }; template class QSqlDriverCreator : public QSqlDriverCreatorBase { public: QSqlDriver *createObject() const { return new T; } }; class Q_SQL_EXPORT QSqlDatabase { public: QSqlDatabase(); QSqlDatabase(const QSqlDatabase &other); ~QSqlDatabase(); QSqlDatabase &operator=(const QSqlDatabase &other); bool open(); bool open(const QString& user, const QString& password); void close(); bool isOpen() const; bool isOpenError() const; QStringList tables(QSql::TableType type = QSql::Tables) const; QSqlIndex primaryIndex(const QString& tablename) const; QSqlRecord record(const QString& tablename) const; #ifdef QT3_SUPPORT QT3_SUPPORT QSqlRecord record(const QSqlQuery& query) const; inline QT3_SUPPORT QSqlRecord recordInfo(const QString& tablename) const { return record(tablename); } QT3_SUPPORT QSqlRecord recordInfo(const QSqlQuery& query) const; #endif QSqlQuery exec(const QString& query = QString()) const; QSqlError lastError() const; bool isValid() const; bool transaction(); bool commit(); bool rollback(); void setDatabaseName(const QString& name); void setUserName(const QString& name); void setPassword(const QString& password); void setHostName(const QString& host); void setPort(int p); void setConnectOptions(const QString& options = QString()); QString databaseName() const; QString userName() const; QString password() const; QString hostName() const; QString driverName() const; int port() const; QString connectOptions() const; QString connectionName() const; void setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy); QSql::NumericalPrecisionPolicy numericalPrecisionPolicy() const; QSqlDriver* driver() const; QT_STATIC_CONST char *defaultConnection; static QSqlDatabase addDatabase(const QString& type, const QString& connectionName = QLatin1String(defaultConnection)); static QSqlDatabase addDatabase(QSqlDriver* driver, const QString& connectionName = QLatin1String(defaultConnection)); static QSqlDatabase cloneDatabase(const QSqlDatabase &other, const QString& connectionName); static QSqlDatabase database(const QString& connectionName = QLatin1String(defaultConnection), bool open = true); static void removeDatabase(const QString& connectionName); static bool contains(const QString& connectionName = QLatin1String(defaultConnection)); static QStringList drivers(); static QStringList connectionNames(); static void registerSqlDriver(const QString &name, QSqlDriverCreatorBase *creator); static bool isDriverAvailable(const QString &name); protected: explicit QSqlDatabase(const QString& type); explicit QSqlDatabase(QSqlDriver* driver); private: friend class QSqlDatabasePrivate; QSqlDatabasePrivate *d; }; #ifndef QT_NO_DEBUG_STREAM Q_SQL_EXPORT QDebug operator<<(QDebug, const QSqlDatabase &); #endif QT_END_NAMESPACE QT_END_HEADER #endif // QSQLDATABASE_H