QSqlDatabase类详细介绍

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() 注册它。
    本文来自互联网!

你可能感兴趣的:(QSqlDatabase类详细介绍)