Qt：QSqlDatabase
0、说明
QSqlDatabase类处理与数据库连接相关的操作。一个QSqlDatabase实例就代表了一个连接，连接时要提供访问数据库的driver，driver继承自QSqlDriver。
通过静态方法addDatabase()构造一个QSqlDatabase来构造一个连接，调用这个方法时可以指定driver或driver type和连接名。
不同连接通过连接的name进行区分，而不是它要连接的数据库的name。我们可以通过多种连接连接到一个数据库。QSqlDatabase也支持默认连接——无名连接。为了构造这个默认连接，当我们调用addDatabase()时，不传入连接name。之后，当我们调用任何static成员函数时，如果不指定连接名，都会采用该默认连接。
下面的代码段展示了如何构造一个默认连接来连接一个PostgreSQL database：
QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL"); db.setHostName("Administrator"); db.setDatabaseName("Mydb"); db.setUserName("User"); db.setPassword("123456"); bool ok = db.open();
构造完成QSqlDatabase对象之后，要分别调用setHostName()、setDatabaseName()、setUserName()、setPassword()、setPort()、setConnectOptions()来设置连接配置项。之后，调用open()方法激活和数据库的连接。在open()之前，连接是不可用的。
上文我们构造了一个默认连接，因为我们在调用addDatabase()时并没有给这个连接命名。接下来，我们可以通过调用database()来得到这个默认连接对应的QSqlDatabase对象：
QSqlDatabase db = QSqlDatabase::database();
QSqlDatabase是一个值相关类，也就是说，在这个连接上进行的操作会影响到其它代表同一个连接的QSqlDatabase对象的内容。调用cloneDatabase()可以用已存在的连接构造一个独立的数据库连接。
注意
强烈推荐不要为QSqlDatabase构造副本，不然可能会在关闭时导致清理异常。如果我们需要访问一个存在的QSqlDatabase，应该通过database()来进行。如果我们获取并记录了一个QSqlDatabase类型的成员字段，那么它在QCoreApplication实例关闭前需要将其delete。
如果我们构造了多个连接，那么需要在调用addDatabase()时为每个连接指定一个独特的名字。通过调用database()时传入连接名来获取对应的连接。
调用removeDatabase()并传入相应的连接名来实现取消连接。如果我们想关闭一个正在被其他QSqlDatabase使用的连接，那么会输出一个警告信息。可以调用contains()可以检查某个连接名是否包含在连接List中。
QSqlDatabase::exec()已经过时了，现在应该用QSqlQuery::exec()。
使用事务时，必须在创建查询前启动事务。
1、模块和加载项
| Header: | #include <QSqlDatabase> |
| qmake: | QT += sql |
2、构造
| QSqlDatabase(QSqlDatabase other) | 复制一个QSqlDatabase |
| QSqlDatabase() |
构造一个空的、非法的QSqlDatabase。 需要使用addDatabase()、removeDatabase()、database()来获取合法的QSqlDatabase |
通常不用构造方法构造一个QSqlDatabase，而用静态方法addDatabase()。
5、静态方法
返回值类型 |
方法 |
说明 |
| QSqlDatabase |
addDatabase(QString type, QString connectionName = QLatin1String(defaultConnection)) addDatabase(QSqlDriver *driver, QString connectionName = QLatin1String(defaultConnection)) |
用driver type和连接名构造一个连接，如果和之前的连接重名，那么会删除之前的连接，而返回新构造的连接。 如果type不可用，isValid()会返回false。 如果连接名未指定，那么新构建的连接将成为默认连接，可以通过调用无参database()来访问这个默认连接。如果提连接名，将会返回连接名对应的连接。 如果多次调用该方法且不指定连接名，那么后建立的默认连接会覆盖之前的默认连接。 在使用连接前，需要先初始化，也就是调用 setDatabaseName(), setUserName(), setPassword(), setHostName(), setPort(), and setConnectOptions()这些方法或其中的一些方法。最后，open() |
|
该方法用一个driver来实例化数据库连接，这个driver可以是我们自写的。 这个方法我们用到的比较少，有需要的可以去官网查看addDatabase。 |
||
| QSqlDatabase |
cloneDatabase(QSqlDatabase other, QString connectionName) cloneDatabase(QString other, QString connectionName) |
复制一个连接，返回它的副本，并为该副本命名。 所有原连接的内容如databaseName()、hostName()都会原封不动的保存下来。 这个新的连接并不是open的，在使用它之前，要先用open()打开。 |
| QStringList | connectionNames() | 返回包含所有连接名的QStringList |
| bool | contains(QString connectionName = QLatin1String(defaultConnection)) | 如果连接名List中包含指定连接名，返回true |
| QSqlDatabase | database(QString connectionName = QLatin1String(defaultConnection), bool open = true) |
返回指定连接名的连接。 如果参数open = true（默认），那么如果返回的连接原本没有open，那么现在它会open。 如果不指定连接名，会返回默认连接；如果连接名不存在，会返回一个非法连接。 该方法是线程安全的。 |
| QStringList | drivers() | 返回所有可用的drivers组成的QStringList |
| bool | isDriverAvailable(QString name) | 如果名字为name的driver可用，就返回true |
| void | registerSqlDriver(QString name, QSqlDriverCreatorBase *creator) |
注册一个新的名为name的driver。 如果我们有一个定制SQL driver并且并不想将它编译成一个接口时，可以调用该方法。 |
| void | removeDatabase(QString connectionName) |
在连接List中删除某个连接。 需要注意的是，在该连接上不能有某个启动的Query，否则可能导致资源泄漏。 也就是说，Query语句必须与removeDatabase不在一个代码块中 错误示范： // WRONG QSqlDatabase db = QSqlDatabase::database("sales"); QSqlQuery query("SELECT NAME, DOB FROM EMPLOYEES", db); QSqlDatabase::removeDatabase("sales"); // will output a warning // "db" is now a dangling invalid database connection, // "query" contains an invalid result set 正确示范： { QSqlDatabase db = QSqlDatabase::database("sales"); QSqlQuery query("SELECT NAME, DOB FROM EMPLOYEES", db); } // 当db和query离开代码块之后，它们就会被销毁，此时再销毁是安全的 QSqlDatabase::removeDatabase("sales"); // correct 为了移除默认连接，可以通过database().connectionName()来获取默认连接name。 该方法是线程安全的。 |
QString的Drive type
| Driver Type | Description |
|---|---|
| QDB2 | IBM DB2 |
| QIBASE | Borland InterBase Driver |
| QMYSQL | MySQL Driver |
| QOCI | Oracle Call Interface Driver |
| QODBC | ODBC Driver (includes Microsoft SQL Server) |
| QPSQL | PostgreSQL Driver |
| QSQLITE | SQLite version 3 or above |
| QSQLITE2 | SQLite version 2 |
| QTDS | Sybase Adaptive Server |
6、实例方法
返回值类型 |
方法 |
说明 |
| QSqlDatabase & | operator=(QSqlDatabase other) | 赋值 |
| void | close() | 关闭连接，释放所有资源，取消建立在该连接上的所有查询相关的QSqlQuery对象 |
| bool | commit() |
如果driver支持事务，那么就向数据库提交事务，此时transaction()会启动。如果操作成功，返回true。 对于某些数据库，当在数据库上有活动查询正在执行，那么事务提交会失败并返回false。在事务提交之前应使查询失效。 调用lastError()可以得知错误信息。 |
| QString | connectOptions() | 返回该连接所用到的一些连接配置 |
| QString | connectionName() | 返回连接名 |
| QString | databaseName() | 返回数据库名 |
| QSqlDriver * | driver() | 返回该连接用的QSqlDriver |
| QString | driverName() | 返回driver名 |
| QSqlQuery | exec(QString query = QString()) | 执行一段SQL语句，返回QSqlQuery对象。 |
| QString | hostName() | 返回连接的Host名 |
| bool | isOpen() | 连接是否open |
| isOpenError() |
是否存在打开错误。 错误信息通过lastError()查询 |
|
| isValid() |
如果该QSqlDatabase有一个合法driver返回true。 QSqlDatabase db; qDebug() << db.isValid(); // Returns false db = QSqlDatabase::database("sales"); qDebug() << db.isValid(); // 如果连接"sales"存在，返回true QSqlDatabase::removeDatabase("sales"); qDebug() << db.isValid(); // Returns false |
|
| QSqlError | lastError() |
返回最近的错误信息。 查询相关的错误会被QSqlQuery::lastError()抛出 |
| QSql::NumericalPrecisionPolicy | numericalPrecisionPolicy() | 返回当前数据库连接的默认精度策略。 |
| bool |
open() open(QString user, QString password) |
启动一个数据库连接 |
| QString | password() | 返回连接密码 |
| int | port() | 返回连接端口 |
| QSqlIndex | primaryIndex(QString tablename) | 返回表tablename上的索引。 |
| QSqlRecord | record(QString tablename) | 返回表tablename（或视图）上所有字段组成的QSqlRecord |
| bool | rollback() | 如果事务transaction()已经启动，回滚数据库上的事务。 |
|
void 这些方法必须在连接open()前调用，否则是无效的。 不然就只能先close()，再调用该方法，再open()。 |
setConnectOptions(QString options = QString()) |
设置连接配置项。
参数options字符串是以分号';'分隔的option=value对。不同的数据库的配置是不同的，具体可查看官方文档setConnectOptions |
| setDatabaseName(QString name) |
设置数据库名。 如果数据库服务器上有多个数据库，就要用该项指明用哪个数据库。 |
|
| setHostName(QString host) | 设置Host名（服务器IP/域名）。 | |
| setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy) | 设置数字精度策略。 | |
| setPassword(QString password) | 设置密码。 | |
| setPort(int port) | 设置端口。 | |
| setUserName(QString name) | 设置用户名。 | |
| QStringList | tables(QSql::TableType type = QSql::Tables) | 返回数据库中所有的table、system table、view构成的QStringList，具体返回哪种，由参数type指定。 |
| bool | transaction() | 启动一项事务，成功则返回true |
| QString | userName() | 返回用户名 |
事务
在以上方法中，我们提到了事务（transaction）一词，它的意思是我们对数据库进行的各项操作，需要注意的是，对数据库修改的事务，必须commit()提交事务，才能真正实现对数据库修改，否则只是对它的映像进行修改。
7、用法
1）构造数据库连接
int main(int argc, char *argv[]) { QSqlDatabase db =QSqlDatabase::addDatabase("QMYSQL"); db.setHostName("Mysql"); db.setPort(1234); db.setUserName("User"); db.setPassword("pwd1"); db.setDatabaseName("Table1"); if( !db.open() ){ //数据库打开失败 qDebug()<<db.lastError().text(); } }
