qsqldatabase.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:5k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtSql module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QSQLDATABASE_H
  38. #define QSQLDATABASE_H
  39. #include <QtCore/qstring.h>
  40. #include <QtSql/qsql.h>
  41. #ifdef QT3_SUPPORT
  42. #include <QtSql/qsqlrecord.h>
  43. #endif
  44. QT_BEGIN_HEADER
  45. QT_BEGIN_NAMESPACE
  46. QT_MODULE(Sql)
  47. class QSqlError;
  48. class QSqlDriver;
  49. class QSqlIndex;
  50. class QSqlRecord;
  51. class QSqlQuery;
  52. class QSqlDatabasePrivate;
  53. class Q_SQL_EXPORT QSqlDriverCreatorBase
  54. {
  55. public:
  56.     virtual ~QSqlDriverCreatorBase() {}
  57.     virtual QSqlDriver *createObject() const = 0;
  58. };
  59. template <class T>
  60. class QSqlDriverCreator : public QSqlDriverCreatorBase
  61. {
  62. public:
  63.     QSqlDriver *createObject() const { return new T; }
  64. };
  65. class Q_SQL_EXPORT QSqlDatabase
  66. {
  67. public:
  68.     QSqlDatabase();
  69.     QSqlDatabase(const QSqlDatabase &other);
  70.     ~QSqlDatabase();
  71.     QSqlDatabase &operator=(const QSqlDatabase &other);
  72.     bool open();
  73.     bool open(const QString& user, const QString& password);
  74.     void close();
  75.     bool isOpen() const;
  76.     bool isOpenError() const;
  77.     QStringList tables(QSql::TableType type = QSql::Tables) const;
  78.     QSqlIndex primaryIndex(const QString& tablename) const;
  79.     QSqlRecord record(const QString& tablename) const;
  80. #ifdef QT3_SUPPORT
  81.     QT3_SUPPORT QSqlRecord record(const QSqlQuery& query) const;
  82.     inline QT3_SUPPORT QSqlRecord recordInfo(const QString& tablename) const
  83.     { return record(tablename); }
  84.     QT3_SUPPORT QSqlRecord recordInfo(const QSqlQuery& query) const;
  85. #endif
  86.     QSqlQuery exec(const QString& query = QString()) const;
  87.     QSqlError lastError() const;
  88.     bool isValid() const;
  89.     bool transaction();
  90.     bool commit();
  91.     bool rollback();
  92.     void setDatabaseName(const QString& name);
  93.     void setUserName(const QString& name);
  94.     void setPassword(const QString& password);
  95.     void setHostName(const QString& host);
  96.     void setPort(int p);
  97.     void setConnectOptions(const QString& options = QString());
  98.     QString databaseName() const;
  99.     QString userName() const;
  100.     QString password() const;
  101.     QString hostName() const;
  102.     QString driverName() const;
  103.     int port() const;
  104.     QString connectOptions() const;
  105.     QString connectionName() const;
  106.     QSqlDriver* driver() const;
  107.     QT_STATIC_CONST char *defaultConnection;
  108.     static QSqlDatabase addDatabase(const QString& type,
  109.                                  const QString& connectionName = QLatin1String(defaultConnection));
  110.     static QSqlDatabase addDatabase(QSqlDriver* driver,
  111.                                  const QString& connectionName = QLatin1String(defaultConnection));
  112.     static QSqlDatabase cloneDatabase(const QSqlDatabase &other, const QString& connectionName);
  113.     static QSqlDatabase database(const QString& connectionName = QLatin1String(defaultConnection),
  114.                                  bool open = true);
  115.     static void removeDatabase(const QString& connectionName);
  116.     static bool contains(const QString& connectionName = QLatin1String(defaultConnection));
  117.     static QStringList drivers();
  118.     static QStringList connectionNames();
  119.     static void registerSqlDriver(const QString &name, QSqlDriverCreatorBase *creator);
  120.     static bool isDriverAvailable(const QString &name);
  121. protected:
  122.     explicit QSqlDatabase(const QString& type);
  123.     explicit QSqlDatabase(QSqlDriver* driver);
  124. private:
  125.     friend class QSqlDatabasePrivate;
  126.     QSqlDatabasePrivate *d;
  127. };
  128. #ifndef QT_NO_DEBUG_STREAM
  129. Q_SQL_EXPORT QDebug operator<<(QDebug, const QSqlDatabase &);
  130. #endif
  131. QT_END_NAMESPACE
  132. QT_END_HEADER
  133. #endif // QSQLDATABASE_H