标签：const Qt 数据库 API QString SQL QSqlDatabase 连接

作者: 苏丙榅
链接: https://subingwen.cn/qt/qt-db/?highlight=sql
来源: 爱编程的大丙
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

另外，推荐野火关于 sqlite 的文档：https://doc.embedfire.com/linux/qt/embed/zh/latest/ebf_qt/senior/qt_sqlite.html

大致了解

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

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

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 函数：

静态函数

得到可以使用的数据库驱动名字的集合

[static] QStringList QSqlDatabase::drivers();

调用该函数就可以在输出窗口看到支持的数据库驱动的名字了

SHELL

("QSQLITE", "QMYSQL", "QMYSQL3", "QOCI", "QOCI8", "QODBC", "QODBC3", "QPSQL", "QPSQL7")

在高版本的Qt中，有些数据库的驱动/插件（本质是动态库）需要自己编译，比如：MySQL、Oracle。如果没有对应的驱动/插件是无法进行数据库连接的。

QMYSQL 是MySQL数据库对应的驱动名
QOCI 是Oracle数据库对应的驱动名

添加一个数据库实例

C++

[static] QSqlDatabase QSqlDatabase::addDatabase(
    const QString &type, 
    const QString &connectionName = QLatin1String( defaultConnection ));

该函数的有两个参数分别是：

type：指定要连接什么样的数据库，就是数据库驱动对应的驱动名
connectionName：数据库连接名，默认叫: defaultConnection，我们可以在应用程序中添加多个数据库连接（也就是多个实例），每个连接都对应一个唯一的名字。
函数的返回值就是得到的数据库实例对象。

通过数据库连接名得到数据库实例对象

[static] QSqlDatabase QSqlDatabase::database(
    const QString &connectionName = QLatin1String( defaultConnection ), 
    bool open = true);

该函数的有两个参数分别是：

connectionName: 通过addDatabase()函数的第二个参数指定的连接名
open: 实例的状态
true: 得到的实例设置为打开状态
false: 得到的实例设置为关闭状态

判断连接名对应的连接是否已经存在了，给函数参数指定数据库连接名函数就可以返回连接对应的状态了：true（打开）或者 false（关闭）。

C++
[static] bool QSqlDatabase::contains(
    const QString &connectionName = QLatin1String( defaultConnection ));

公共成员函数

给数据库实例设置连接服务器相关的数据信息

void QSqlDatabase::setDatabaseName(const QString &name);//设置数据库名
void QSqlDatabase::setHostName(const QString &host);//设置数据库服务器主机名（一般指定服务器IP地址即可）
void QSqlDatabase::setPort(int port);//设置数据库服务器绑定的端口,如果数据库服务器绑定的是默认端口，可以省略设置端口的操作。
void QSqlDatabase::setUserName(const QString &name);//设置连接的数据库中某个用户的用户名
void QSqlDatabase::setPassword(const QString &password);//设置连接的数据库中某个用户对应的密码

连接数据库（必须要先设置连接信息，然后再连接数据库）

bool QSqlDatabase::open();
void QSqlDatabase::close();//关闭数据库连接

数据库连接成功返回true，连接失败返回false。

判断数据库是否打开了，返回值和open()函数相同。

bool QSqlDatabase::isOpen() const;

返回有关数据库上发生的最后一个错误的信息。

QSqlError QSqlDatabase::lastError() const;
QString QSqlError::text() const;

该函数返回的是一个QSqlError对象，调用QSqlError类提供的text()方法就可以得到最后一个错误对应的信息描述了。

事务操作

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

2.2 QSqlQuery——常用于执行用户SQL语句

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

常用成员函数

构造函数

QSqlQuery::QSqlQuery(
    const QString &query = QString(), 
    QSqlDatabase db = QSqlDatabase());

参数说明（这两个参数都有默认值，因此可以根据实际需求进行指定）:

query：要执行的SQL语句
db：数据库实例对象，如果没有指定db，或者是无效的，则使用应用程序的默认数据库

执行一个SQL语句

bool QSqlQuery::exec();    // ①
bool QSqlQuery::exec(const QString &query);   // ②

①：没有参数，执行的SQL语句是在构造函数中指定的。
②：有参数，参数对应的字符串就是要执行的SQL语句。

搜索下一条记录

检索查询得到的结果集中的下一条记录(如果可用)，并将查询定位到检索到的记录上。

bool QSqlQuery::next();

该函数检索结果集中的每一条记录的规则如下:

如果当前位于结果集第一个记录之前，例如，在执行查询之后，将尝试检索第一个记录。
如果当前位于结果集最后一条记录之后，结果集已经检索完毕并返回false。
如果结果位于结果集中间的某个位置，则尝试检索下一个记录。
函数调用之后，如果检索到有效记录返回true，否则返回false。

获取当前记录中字段的值

QVariant QSqlQuery::value(int index) const;  // ①
QVariant QSqlQuery::value(const QString &name) const; // ②

①：通过字段的索引得到当前字段的值，编号从0开始。
②：通过字段的名字得到当前字段的值。

由于数据库表中的字段可以有多种数据类型，因此将这多种类型通过QVariant类进行了包装从而实现了整齐划一。我们可以通过调用QVariant类的API函数得到其内部实际类型的数据。

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

3. 示例代码

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

 1 MainWindow::MainWindow(QWidget *parent) :
 2     QMainWindow(parent),
 3     ui(new Ui::MainWindow)
 4 {
 5     ui->setupUi(this);
 6 
 7     // 1. 添加一个数据库实例
 8     QStringList ls = QSqlDatabase::drivers();
 9     qDebug() << ls;
10 
11     QSqlDatabase db = QSqlDatabase::addDatabase("QOCI");
12     // 2. 得到实例对象之后需要初始化连接信息
13     //    -- 服务器的IP, 端口, 数据库名, 用户名, 密码
14     db.setHostName("110.22.80.130");
15     db.setPort(1521);   // 如果使用的是默认端口, 可以不调用该函数
16     db.setDatabaseName("orcl");
17     db.setUserName("scott");
18     db.setPassword("scott");
19 
20     // 3. 连接数据库
21     bool bl = db.open();
22     if(!bl)
23     {
24         qDebug() << db.lastError().text();
25         return;
26     }
27     else
28     {
29         qDebug() << "数据库连接成功了...";
30     }
31 
32     QSqlQuery query;
33     // 4. 插入数据
34     QString sql = "insert into dept values(23, '火影忍者', '东京')";
35     // 开启事务
36     db.transaction();
37     bool flag = query.exec(sql);
38     if(flag)
39     {
40         db.commit();
41     }
42     else
43     {
44         db.rollback();
45     }
46 
47     // 5. 查询数据表 - dept
48     query.exec("select dname, loc from dept");
49     // 遍历结果集
50     while(query.next())
51     {
52         // 从当前记录中取出各个字段的值
53         qDebug() << query.value(0).toString()
54                  << query.value(1).toString()
55                  << query.value("dname").toString()
56                  << query.value("loc").toString();
57     }
58     db.close();
59 }

第8、9行：获取并打印本地支持的数据库驱动列表（如果本地是第一次连接数据库建议做一次检测，以后就不需要了）。

第11行：添加一个数据库实例

第14行：设置连接数据库服务器的IP地址

第15行：设置数据库服务器绑定的端口

- MySQL 绑定的默认端口是3306
- Oracle 绑定的默认端口是1521

第24行：如果数据库连接失败，打印失败信息。

第36行：为了保证数据的正确性，每一个写数据的业务流程都应该为其创建一个事务（业务流程可能对应的是一系列的写数据库的操作，上面的测试程序中只有一个）

第40行：业务流程中每一个写操作完毕之后都要判断其是否成功了，如果所有的写操作都成功了，提交事务，数据库数据被更新。

第44行：业务流程中只要有一个写操作失败了，数据回滚到创建事务时候的状态，保证数据的安全性和完整性。

第50行：通过一个while循环遍历第48行查询到的结果集，每调用一次next()从结果集中取出一条记录。

第53 ~ 56行：通过value()方法将遍历到的当前记录中的每个字段的值取出并打印出来。

第58行：关闭数据库（断开和数据库服务器的连接）。

上面这段代码可以看做是在Qt中连接、操作数据库的模板，我们在项目开发过程中照葫芦画瓢就可以了，区别可能就是项目的业务流程更复杂因此需要编写的SQL语句也会随之变得复杂，仅此而已。

标签：const,Qt,数据库,API,QString,SQL,QSqlDatabase,连接
From： https://www.cnblogs.com/FBsharl/p/17771801.html

Qt SQL API相关操作