QT QSqlDatabase

系统管理员 2022-10-19 08:49 99阅读 0赞

QSqlDatabase类表示到数据库的连接。

QSqlDatabase类提供了通过连接访问数据库的接口。QSqlDatabase的一个实例表示连接。该连接通过支持的数据库驱动程序之一提供对数据库的访问，该驱动程序源自QSqlDriver。或者，您可以从QSqlDriver派生出自己的数据库驱动程序。有关更多信息，请参见如何编写自己的数据库驱动程序。

通过调用一个静态addDatabase()函数来创建一个连接(例如，QSqlDatabase的一个实例)，其中你指定了要使用的驱动程序或驱动程序的类型(例如，你要访问什么样的数据库?)和一个连接名。连接是根据它自己的名称而不是它所连接的数据库名称来确定的。可以有多个到一个数据库的连接。QSqlDatabase还支持默认连接的概念，即未命名连接。要创建默认连接，在调用addDatabase()时不要传递连接名参数。随后，当调用任何接受连接名参数的静态成员函数时，如果不传递连接名参数，则假定为默认连接。下面的代码片段展示了如何创建和打开到PostgreSQL数据库的默认连接:

QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
    db.setHostName(“acidalia”);
    db.setDatabaseName(“customdb”);
    db.setUserName(“莫吉托”);
    db.setPassword(“J0a1m8”);
    Bool ok = db.open();

创建QSqlDatabase对象后，使用setDatabaseName()、setUserName()、setPassword()、setHostName()、setPort()和setConnectOptions()设置连接参数。然后调用open()来激活到数据库的物理连接。在打开该连接之前，该连接不可用。

上面定义的连接将是默认连接，因为我们没有给addDatabase()指定连接名称。随后，你可以通过调用database()而不使用connection name参数来获得默认连接:

QSqlDatabase db = QSqlDatabase::数据库();  
QSqlDatabase是一个值类。通过一个QSqlDatabase实例对数据库连接所做的更改将影响代表相同连接的其他QSqlDatabase实例。使用cloneDatabase()创建一个基于现有数据库连接的独立数据库连接。

如果创建多个数据库连接，则在调用addDatabase()时为每个数据库连接指定唯一的连接名称。使用带有连接名称的database()来获得该连接。使用带有连接名称的removeDatabase()来删除连接。如果试图删除被其他QSqlDatabase对象引用的连接，QSqlDatabase将输出一个警告。使用contains()查看给定的连接名是否在连接列表中。

一旦建立了连接，就可以调用tables()来获取数据库中的表列表，调用primaryIndex()来获取表的主索引，调用record()来获取关于表字段(例如字段名)的元信息。

注意:QSqlDatabase::exec()已弃用。使用QSqlQuery:: exec()。

如果驱动程序支持事务，则使用transaction()来启动事务，并使用commit()或rollback()来完成事务。使用hasFeature()询问驱动程序是否支持事务。

注意:当使用事务时，您必须在创建查询之前启动事务。

如果发生错误，lastError()将返回有关它的信息。

使用drivers()获取可用SQL驱动程序的名称。使用isDriverAvailable()检查特定驱动程序的存在。如果您已经创建了自己的自定义驱动程序，则必须向registerSqlDriver()注册它。

请参见QSqlDriver、QSqlQuery、Qt SQL和Threads和SQL模块。