QSqlDatabase类详细介绍

转帖地址：http://hi.baidu.com/devfan/blog/item/9dddfc1f0a54aa02304e1512.html

 

 QSqlDatabase类表示一个数据库连接。

    QSqlDatabase类提供一个通过数据库连接访问数据库的接口。一个QSqlDatabase的实例代表了一个数据库连接。数据库连接通过数据库驱动提供对数据库的访问，数据库驱动继承自QSqlDriver。或者，你可以从QSqlDriver类构建你自己的数据库驱动。更多信息请参考怎样编写你自己的数据库驱动(How to Write Your Own Database Driver)。

    用静态方法 addDatabase() 创建一个数据库连接(也就是QSqlDatabase的实例)，指定驱动或者驱动种类(也就是你要访问什么类型数据库)以及连接名称。一个连接通过它的连接名称识别，注意，不是它连接的数据库名称。你可以有多个连接连到同一个数据库。QSqlDatabase还支持默认连接概念，没有连接名称的连接就是默认连接。要创建默认连接，在调用addDatabase()方法时不传递连接名称参数(connectionName)即可。以后，当你调用任何带连接名称参数的静态成员函数时，如果你不传递连接名称参数，就会使用默认连接。下面的代码片段展示了如何创建并打开一个连到MySQL数据库的默认连接：

QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
db.setHostName("acidalia");
db.setDatabaseName("customdb");
db.setUserName("mojito");
db.setPassword("J0a1m8");
bool ok = db.open();

 

    一旦创建QSqlDatabase对象，就可以通过setDatabaseName(), setUserName(),setPassword(), setHostName(), setPort(), 还有setConnectOptions() 来设置连接参数。然后调用 open() 方法打开数据库物理连接。在打开连接之前，连接不可用。

    在上面定义的连接将成为默认连接，因为我们没有传递连接名称参数(connectionName)给 addDatabase() 。以后，你可以不用提供连接名称参数(connectionName)直接调用 database() 方法来获得这个默认连接：

QSqlDatabase db = QSqlDatabase::database();

    QSqlDatabase是一个value class(?:Value Classes，更多参考: Google)，通过一个QSqlDatabase实例对数据库连接做的所有修改会影响到其他QSqlDatabase实例中的相同连接。用 cloneDatabase() 可以创建一个与现有连接参数相同但是独立的数据库连接。

    如果创建多重数据库连接，调用  addDatabase() 时，要为每个连接指定独一无二的名字。调用  database() 方法并传递连接名称来获取该连接。通过调用带有连接名称参数的  removeDatabase() 方法来移除一个连接。当你试图移除一个已经被其他 QSqlDatabase 对象引用的连接时  QSqlDatabase 将会输出警告。调用contains() 方法来查看给出的连接名称是否在连接列表中。

    当一个连接被确定以后，你可以调用 tables() 方法来获取数据库的数据表列表，调用 primaryIndex() 方法来获取表的主索引，调用 record() 来获取某个表的字段的元信息(比如: 字段名)。

注意: 不提倡使用旧的 QSqlDatabase::exec() ，推荐用新的 QSqlQuery::exec() 来代替。

    如果驱动支持事务，用 transation() 开始一个事务，用 commit() 或 rollback() 完成这个事务。用 hasFeature() 询问驱动是否支持事务。注意:当使用事务时，必须在创建查询之前开始事务。

    如果发生错误，lastError() 方法将返回关于该错误的信息。

    通过 drivers() 获取可用的SQL驱动名字列表。用 isDriverAvailable() 来检查某个特定的驱动是否可用。如果你创建了自定义驱动，必须调用registerSqlDriver() 注册它。