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

系统编程

开发平台:

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 QSQLDRIVER_H
  38. #define QSQLDRIVER_H
  39. #include <QtCore/qobject.h>
  40. #include <QtCore/qstring.h>
  41. #include <QtCore/qstringlist.h>
  42. #include <QtSql/qsql.h>
  43. #ifdef QT3_SUPPORT
  44. #include <QtSql/qsqlquery.h>
  45. #endif
  46. QT_BEGIN_HEADER
  47. QT_BEGIN_NAMESPACE
  48. QT_MODULE(Sql)
  49. class QSqlDatabase;
  50. class QSqlDriverPrivate;
  51. class QSqlError;
  52. class QSqlField;
  53. class QSqlIndex;
  54. class QSqlRecord;
  55. class QSqlResult;
  56. class QVariant;
  57. class Q_SQL_EXPORT QSqlDriver : public QObject
  58. {
  59.     friend class QSqlDatabase;
  60.     Q_OBJECT
  61.     Q_DECLARE_PRIVATE(QSqlDriver)
  62. public:
  63.     enum DriverFeature { Transactions, QuerySize, BLOB, Unicode, PreparedQueries,
  64.                          NamedPlaceholders, PositionalPlaceholders, LastInsertId,
  65.                          BatchOperations, SimpleLocking, LowPrecisionNumbers,
  66.                          EventNotifications, FinishQuery, MultipleResultSets };
  67.     enum StatementType { WhereStatement, SelectStatement, UpdateStatement,
  68.                          InsertStatement, DeleteStatement };
  69.     enum IdentifierType { FieldName, TableName };
  70.     explicit QSqlDriver(QObject *parent=0);
  71.     ~QSqlDriver();
  72.     virtual bool isOpen() const;
  73.     bool isOpenError() const;
  74.     virtual bool beginTransaction();
  75.     virtual bool commitTransaction();
  76.     virtual bool rollbackTransaction();
  77.     virtual QStringList tables(QSql::TableType tableType) const;
  78.     virtual QSqlIndex primaryIndex(const QString &tableName) const;
  79.     virtual QSqlRecord record(const QString &tableName) const;
  80. #ifdef QT3_SUPPORT
  81.     inline QT3_SUPPORT QSqlRecord record(const QSqlQuery& query) const
  82.     { return query.record(); }
  83.     inline QT3_SUPPORT QSqlRecord recordInfo(const QString& tablename) const
  84.     { return record(tablename); }
  85.     inline QT3_SUPPORT QSqlRecord recordInfo(const QSqlQuery& query) const
  86.     { return query.record(); }
  87.     inline QT3_SUPPORT QString nullText() const { return QLatin1String("NULL"); }
  88.     inline QT3_SUPPORT QString formatValue(const QSqlField *field, bool trimStrings = false) const
  89.     { return field ? formatValue(*field, trimStrings) : QString(); }
  90. #endif
  91.     virtual QString formatValue(const QSqlField& field, bool trimStrings = false) const;
  92.     virtual QString escapeIdentifier(const QString &identifier, IdentifierType type) const;
  93.     virtual QString sqlStatement(StatementType type, const QString &tableName,
  94.                                  const QSqlRecord &rec, bool preparedStatement) const;
  95.     QSqlError lastError() const;
  96.     virtual QVariant handle() const;
  97.     virtual bool hasFeature(DriverFeature f) const = 0;
  98.     virtual void close() = 0;
  99.     virtual QSqlResult *createResult() const = 0;
  100.     virtual bool open(const QString& db,
  101.                       const QString& user = QString(),
  102.                       const QString& password = QString(),
  103.                       const QString& host = QString(),
  104.                       int port = -1,
  105.                       const QString& connOpts = QString()) = 0;
  106.     bool subscribeToNotification(const QString &name);     // ### Qt 5: make virtual
  107.     bool unsubscribeFromNotification(const QString &name);  // ### Qt 5: make virtual
  108.     QStringList subscribedToNotifications() const;          // ### Qt 5: make virtual
  109. Q_SIGNALS:
  110.     void notification(const QString &name);
  111. protected:
  112.     virtual void setOpen(bool o);
  113.     virtual void setOpenError(bool e);
  114.     virtual void setLastError(const QSqlError& e);
  115. protected Q_SLOTS:
  116.     bool subscribeToNotificationImplementation(const QString &name);        // ### Qt 5: eliminate, see subscribeToNotification()
  117.     bool unsubscribeFromNotificationImplementation(const QString &name);    // ### Qt 5: eliminate, see unsubscribeFromNotification()
  118.     QStringList subscribedToNotificationsImplementation() const;            // ### Qt 5: eliminate, see subscribedNotifications()
  119. private:
  120.     Q_DISABLE_COPY(QSqlDriver)
  121. };
  122. QT_END_NAMESPACE
  123. QT_END_HEADER
  124. #endif // QSQLDRIVER_H