Qt数据库操作

苏丙榅2022-02-092023-04-06

1. 概述

Qt框架中对数据库操作提供了很好的支持，我们可以通过Qt提供的类非常方便地和本地或者远程数据库进行连接。众所周知，数据库是 C-S（client-server）结构的，我们要连接的数据库属于服务器端，通过Qt编写的应用程序属于客户端。

如果想用通过Qt访问数据库，首先我们需要在项目中添加数据库模块，模块名为sql 。找到项目文件xxx.pro，把模块名加进去：

1	QT += core gui sql

这个sql模块其实对应的就是一个动态库，动态库中有数据库相关类的二进制源码，在使用动态库中的数据库类的时候，动态库被加载到内存，根据程序猿的需求来提供相应的服务。

首先来介绍一下Qt为我们提供的常用的数据库类：

QSqlDatabase ：通过这个类添加/删除/复制/关闭数据库实例
QSqlQuery ：数据库查询类
QSqlRecord ：数据库记录（通常是数据库中表或视图中的一行）的功能和特征。
QSqlField ：数据库表或视图中单个列的特征，例如数据类型和列名。
QSqlQueryModel ：执行SQL语句和遍历结果集的高级接口。它构建在底层QSqlQuery之上，可以用来为视图类(如QTableView)提供数据。
QSqlError ：数据操作失败可以通过这个类获取相关的错误信息。

在Qt中操作数据库是非常简单的，但是有一个前提条件就是需要使用者能够自己通过SQL语句实现数据库表数据的添、删、查、改。在Qt中不论我们连接的何种类型的关系型数据库，在我们使用的时候其操作流程是一致的：

创建数据库实例并初始化
连接数据库
对数据库进行一系列的添、删、查、改操作（编写并执行SQL语句）
关闭数据库

2. 类的使用

2.1 QSqlDatabase

QSqlDatabase类提供了一个连接访问数据库的接口。一个QSqlDatabase的实例就表示一个连接。该连接通过受支持的数据库驱动程序之一提供对数据库的访问，这些驱动程序派生自QSqlDriver。

下面介绍一下这个中常用的一些 API 函数：

静态函数

得到可以使用的数据库驱动名字的集合
1
[static] QStringList QSqlDatabase::drivers();
直接调用该函数就可以在输出窗口看到支持的数据库驱动的名字了
1
("QSQLITE", "QMYSQL", "QMYSQL3", "QOCI", "QOCI8", "QODBC", "QODBC3", "QPSQL", "QPSQL7")
在高版本的Qt中，有些数据库的驱动/插件（本质是动态库）需要自己编译，比如：MySQL、Oracle。如果没有对应的驱动/插件是无法进行数据库连接的。
- QMYSQL 是MySQL数据库对应的驱动名
- QOCI 是Oracle数据库对应的驱动名
添加一个数据库实例
1
2
3
[static] QSqlDatabase QSqlDatabase::addDatabase(
const QString &type,
const QString &connectionName = QLatin1String( defaultConnection ));
该函数的有两个参数分别是：
- type：指定要连接什么样的数据库，就是数据库驱动对应的驱动名
- connectionName：数据库连接名，默认叫: defaultConnection，我们可以在应用程序中添加多个数据库连接（也就是多个实例），每个连接都对应一个唯一的名字。
函数的返回值就是得到的数据库实例对象。
通过数据库连接名得到数据库实例对象
1
2
3
[static] QSqlDatabase QSqlDatabase::database(
const QString &connectionName = QLatin1String( defaultConnection ),
bool open = true);
该函数的有两个参数分别是：
- connectionName: 通过addDatabase()函数的第二个参数指定的连接名
- open: 实例的状态
  - true: 得到的实例设置为打开状态
  - false: 得到的实例设置为关闭状态
判断连接名对应的连接是否已经存在了，给函数参数指定数据库连接名函数就可以返回连接对应的状态了：true（打开）或者 false（关闭）。
1
2
[static] bool QSqlDatabase::contains(
const QString &connectionName = QLatin1String( defaultConnection ));

公共成员函数

给数据库实例设置连接服务器相关的数据信息
- 设置数据库名
  1
  void QSqlDatabase::setDatabaseName(const QString &name);
- 设置数据库服务器主机名（一般指定服务器IP地址即可）
  1
  void QSqlDatabase::setHostName(const QString &host);
- 设置数据库服务器绑定的端口
  1
  void QSqlDatabase::setPort(int port);
  如果数据库服务器绑定的是默认端口，可以省略设置端口的操作。
- 设置连接的数据库中某个用户的用户名
  1
  void QSqlDatabase::setUserName(const QString &name);
- 设置连接的数据库中某个用户对应的密码
  1
  void QSqlDatabase::setPassword(const QString &password);
连接数据库（必须要先设置连接信息，然后再连接数据库）
1
bool QSqlDatabase::open();
数据库连接成功返回true，连接失败返回false。
判断数据库是否打开了，返回值和open()函数相同。
1
bool QSqlDatabase::isOpen() const;
关闭数据库连接
1
void QSqlDatabase::close();
返回有关数据库上发生的最后一个错误的信息。
1
2
QSqlError QSqlDatabase::lastError() const;
QString QSqlError::text() const;
该函数返回的是一个QSqlError对象，调用QSqlError类提供的text()方法就可以得到最后一个错误对应的信息描述了。

事务操作

创建一个事务
1
bool QSqlDatabase::transaction();
提交事务
1
bool QSqlDatabase::commit();
事务回滚
1
bool QSqlDatabase::rollback();

2.2 QSqlQuery

QSqlQuery封装了从QSqlDatabase上执行的SQL查询中创建、导航和检索数据所涉及的功能。既可以执行SELECT、INSERT、UPDATE、DELETE等DML(数据操作语言)语句，也可以执行CREATE TABLE等DDL(数据定义语言)语句。

常用成员函数

构造函数
1
2
3
QSqlQuery::QSqlQuery(
const QString &query = QString(),
QSqlDatabase db = QSqlDatabase());
参数说明（这两个参数都有默认值，因此可以根据实际需求进行指定）:
- query：要执行的SQL语句
- db：数据库实例对象，如果没有指定db，或者是无效的，则使用应用程序的默认数据库。
执行一个SQL语句
1
2
bool QSqlQuery::exec(); // ①
bool QSqlQuery::exec(const QString &query); // ②
- ①：没有参数，执行的SQL语句是在构造函数中指定的。
- ②：有参数，参数对应的字符串就是要执行的SQL语句。
检索查询得到的结果集中的下一条记录(如果可用)，并将查询定位到检索到的记录上。
1
bool QSqlQuery::next();
该函数检索结果集中的每一条记录的规则如下:
- 如果当前位于结果集第一个记录之前，例如，在执行查询之后，将尝试检索第一个记录。
- 如果当前位于结果集最后一条记录之后，结果集已经检索完毕并返回false。
- 如果结果位于结果集中间的某个位置，则尝试检索下一个记录。
函数调用之后，如果检索到有效记录返回true，否则返回false。
获取当前记录中字段的值
1
2
3
QVariant QSqlQuery::value(int index) const; // ①
// 通过字段名直接取出字段值
QVariant QSqlQuery::value(const QString &name) const; // ②
- ①：通过字段的索引得到当前字段的值，编号从0开始。
- ②：通过字段的名字得到当前字段的值。
由于数据库表中的字段可以有多种数据类型，因此将这多种类型通过QVariant类进行了包装从而实现了整齐划一。我们可以通过调用QVariant类的API函数得到其内部实际类型的数据。

掌握了QSqlQuery类中介绍的以上4个函数之后，程序中对数据库进行添、删、查、改都是没有问题的。关于这个类中的其他函数可以自己查询帮助文档仔细阅读一下。

3. 示例代码

如果想要通过一段程序测试是否能够连接到数据库服务器并对其进行操作，前提条件是本地或远程有一个可用的数据库服务器，下面这段程序连接的是远程的oracle服务器：

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 1. 添加一个数据库实例
    QStringList ls = QSqlDatabase::drivers();
    qDebug() << ls;

    QSqlDatabase db = QSqlDatabase::addDatabase("QOCI");
    // 2. 得到实例对象之后需要初始化连接信息
    //    -- 服务器的IP, 端口, 数据库名, 用户名, 密码
    db.setHostName("110.22.80.130");
    db.setPort(1521);   // 如果使用的是默认端口, 可以不调用该函数
    db.setDatabaseName("orcl");
    db.setUserName("scott");
    db.setPassword("scott");

    // 3. 连接数据库
    bool bl = db.open();
    if(!bl)
    {
        qDebug() << db.lastError().text();
        return;
    }
    else
    {
        qDebug() << "数据库连接成功了...";
    }

    QSqlQuery query;
    // 4. 插入数据
    QString sql = "insert into dept values(23, '火影忍者', '东京')";
    // 开启事务
    db.transaction();
    bool flag = query.exec(sql);
    if(flag)
    {
        db.commit();
    }
    else
    {
        db.rollback();
    }

    // 5. 查询数据表 - dept
    query.exec("select dname, loc from dept");
    // 遍历结果集
    while(query.next())
    {
        // 从当前记录中取出各个字段的值
        qDebug() << query.value(0).toString()
                 << query.value(1).toString()
                 << query.value("dname").toString()
                 << query.value("loc").toString();
    }
    db.close();
}