QT知识整合--数据库操作

2024-09-10 06:27 由小程GK 发表于 #后端开发

不管是在哪使用数据库，终归是需要学习sql语言的，所以还没学的小伙伴建议打道回府先去把数据库学了再来看。

我自己将QT中一些常用的数据库分为内部数据库和外部数据库。这所谓的内部数据库就是像“SQLite”这种大部分使用场景是嵌入式的，它将整个数据库存储在一个单一的文件中，没有独立的数据库服务器进程。应用程序直接使用它来管理数据，数据库引擎作为应用程序的一部分运行，它适用于小型项目，这样的好处就是不需要单独的数据库服务器，。而外部服务器也就是我们常说的“Mysql”“oracle”“PostgreSQL”等，说白了就是在开发过程中接入QT外部的数据库。

总结一下来说内部数据库就是在开发过程中将数据库整合到应用程序中，非常适合小项目以及嵌入式项目开发。而外部数据库是一个单独的个体，需要应用程序连接外部数据库使用的，适合于大项目，什么是大项目应该不用我说吧。再从另一方面来说像SQLite这种我们定义为轻量级数据库，它保留一些像oracle一些大型数据库的部分功能变为体积更小的“数据库青春版”。之所以不直接讲像Mysql这种大体积的数据库是因为QT中本身就嵌入了SQlite，我们在开发小项目的时候是不需要安装并配置动态库的。

本章要讲的内容我也会分为内部数据库和外部数据库来讲：

一、内部数据库（SQLite）

（一）sql模块

和网络编程一样，我们新创建的默认项目后，需要手动在.pro手动添加sql，这样我们才能代码中引用与数据库相关的库类。

（二）数据库在QT中使用的整个流程

对于数据库而言不管是在什么项目里面还是用什么技术开发与数据库相关的技术时使用数据库的步骤大致是差不多的。如下：

1、创建数据库对象（数据库实例化）

2、连接数据库

3、使用数据库（平常说的增、删、改、查）

4、关闭数据库

（三）QT带给我们的一些操作数据库的api

1、数据库操作

QSqlDatabase
该类提供对数据库操作行为的各种函数，其中包括创建、删除、复制和关闭数据库。

2、表数据操作

说句老实话，QT中数据库操作有这两个类就可以完成大部分数据库的操作。无非就是连接数据库和操作数据库表数据这两种而已。像后面需要罗列的行数据记录和列数据记录这都是为了简化开发步骤的函数，需要记得太多了。作为初学者搞懂这两个类的使用就可以了，剩下的在开发工作中慢慢积累。

QSqlQuery
该类提供一些组合用来执行sql语句。

（四）类使用和实操代码

1、模块添加

QT += sql

2、api添加

讲解部分我都给写进代码注释里面了，直接下载看或者github上面在线看。

操作数据库有这三个就大致够了。第一个进行数据库本身的操作，也就是创建或者删除数据库操作，建表删表等。

第二个进行数据的操作，也就是表中存储的数据。但前两者本质还是使用的sql语言。

第三个看名字就知道一种报错机制。如果我们在开发工程中遇到数据库的使用问题就可以使用这个类来输出报错内容，我个人觉得这是非常重要的一个类。天下苦bug久已！！！

#include <QSqlDatabase>
#include <QSqlQuery>
//#include <QDebug>
#include <QSqlError>

3、检查QT框架中有哪些数据库

drivers是QT中的一个静态函数，用于返回系统上可用的数据库驱动列表。使用这个函数我们就可以在控制台里面输出QT可用的数据库驱动。

QSqlDatabase::drivers

qDebug()<<QSqlDatabase::drivers()<<endl;//使用方法

00:30:27: Starting /home/xiaochenggk/QT/build-QSql-Desktop_Qt_5_12_12_GCC_64bit-Debug/QSql ...
Warning: Ignoring XDG_SESSION_TYPE=wayland on Gnome. Use QT_QPA_PLATFORM=wayland to run on Wayland anyway.
("QSQLITE", "QMARIADB", "QMYSQL", "QMYSQL3") //控制台输出内容

输出内容中括号里就是可用数据库的列表，可以看到除开sqlite以外还有mysql可以使用。这里提一句，QT中从QT5开始就不再内嵌除开sqlite的驱动了，所以如果我们需要使用外部数据库的时候需要自己去添加其他数据库驱动。这里输出列表中的mysql就是我自己手动添加的数据库驱动，正常是不会出现mysql的。

而且不管是内部数据库还是外部数据库他们在QT中的配置代码和sql语言都是差不多的（唯一不同就是需要多一些配置，类似于账号密码的操作登录数据库再连接）。后面讲外部数据库的时候我只会教一下如何编译数据库驱动和安装数据库。

4、创建数据库连接

使用addDatabase指定数据库驱动，也就是说指定使用什么数据库。再由setDatabaseName来指定数据库文件存放的本地文件地址，如果指定的位置没有已存在的文件QT会自动给你创建一个。再使用open连接数据库，这一个完整的步骤就算完成了。

来看看代码部分：

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");//指定数据库驱动
db.setDatabaseName("数据库文件地址，例如/home/xiaochenggk/QT_Sqlite_project");
//指定数据库文件的存放地址

if (!db.open()) {//这里你可以单独把db.open()拿出来执行，我这样写的好处
                 //可以通过一套输出语句来判断数据库是否连接成功
    qDebug() << "无法打开数据库：" << db.lastError().text();
    return;
}

5、数据操作

（1）创建表

前面都是使用QSqlDatabase操作的数据库的内容，这里对数据的操作就需要使用QSqlQuery里面的内容了。

我们来试试创建表，在数据库结构中，表才是真正意义上用来存放数据的结构，创建的数据库也是用来存放表。创建数据我们需要建立一个QSqlQuery对象，之后创建一个变量用来存储sql语句将这个变量传给QSqlQuery的exec函数执行就可以了，这样一个创建表的工作就算是完成。核心函数为exec。

QSqlQuery query;//QSqlQuery对象
QString createTable = "CREATE TABLE IF NOT EXISTS students ("
                      "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                      "name TEXT, "
                      "age INTEGER)";//使用变量来存储一段sql语句，以供给
                                     //后续工作使用
if (!query.exec(createTable)) {//这里就是将createTable的值传给exec
    qDebug() << "创建表失败：" << query.lastError().text();
}

（2）增

建好表以后就要往表里面插入数据了。后面我也按照增删改查的顺序一个一个的都写个例子照着写就行，主要还是需要自己学习sql语言。

第一行使用QSqlQuery中的prepare函数运行一个带有占位符的sql语句，然后二三句addBindValue用于向占位符绑定实际的值，确保sql语句中的占位符可以插入正确的值。之所以这么写，考虑到ui界面输入数据可以直接插入数据库中，然后addBindValue中的值可以跟一个lineEdit控件绑定，将lineEdit输入的值传给占位符。

query.prepare("INSERT INTO students (name, age) VALUES (?, ?)");
query.addBindValue("Alice");
query.addBindValue(22);
if (!query.exec()) {
    qDebug() << "插入数据失败：" << query.lastError().text();
}

到这里不难看出创建表的时候和插入数据的时候对exec使用有些不一样。创建表时exec是有一个值传入的，而插入数据的时候并还没有，这是因为exec函数的使用有两种方式。一种就如创建表的时候一样直接传值使用，或者直接exec函数中给一个sql语句。而第二种就是结合prepare和addBindValue一起使用，由这两个函数写好的sql语句，代码中是不需要直接给exec传值的。

（3）删

query.prepare("DELETE FROM students WHERE name = ?");
query.addBindValue("Alice");
if (!query.exec()) {
    qDebug() << "删除数据失败：" << query.lastError().text();
}

（4）改

query.prepare("UPDATE students SET age = ? WHERE name = ?");
query.addBindValue(23);  // 更新后的年龄
query.addBindValue("Alice");  // 要更新的学生名字
if (!query.exec()) {
    qDebug() << "更新数据失败：" << query.lastError().text();
}

（5）查

query.exec("SELECT * FROM students");
while (query.next()) {
    QString name = query.value("name").toString();
    int age = query.value("age").toInt();
    qDebug() << "学生：" << name << ", 年龄：" << age;
}

（6）关闭数据库

db.close();

二、外部数据库（Mysql）

外部数据库大部分内容和sqlite是类似的，或者说是数据库的操作是一样的。但是与sqlite不同的是mysql或者说所有外部数据库是需要类似于账户密码的验证过程的。

db.setHostName("localhost");       // 数据库主机名
db.setDatabaseName("my_database"); // 数据库名称
db.setUserName("root");            // 数据库用户名
db.setPassword("password");        // 数据库密码