QT中使用数据库

---

前言

本篇文章将带大家来学习在QT中如何使用数据库。

一、QSqlDatabase类

QSqlDatabase 类是 Qt 数据库模块中用于管理数据库连接的关键类之一。它提供了连接到各种数据库系统的能力，比如 SQLite、MySQL、PostgreSQL 等。主要功能包括创建连接、打开和关闭连接、设置连接参数以及管理连接池。下面让我逐步解释 QSqlDatabase 类的一些重要功能：

1. 添加数据库连接

你可以使用 addDatabase 函数来添加一个数据库连接。该函数有两种常见的用法：

• addDatabase(const QString &type, const QString &connectionName = QLatin1String(defaultConnection)): 添加一个数据库连接，其中 type 参数指定数据库类型（例如 “QSQLITE”、“QMYSQL” 等），connectionName 参数指定连接的名称，默认为 “defaultConnection”。

• addDatabase(QSqlDriver *driver, const QString &connectionName = QLatin1String(defaultConnection)): 添加一个数据库连接，使用给定的驱动程序 driver 对象。这种用法通常用于自定义的数据库驱动程序。

2. 设置连接参数

一旦添加了数据库连接，你可以使用一系列函数来设置连接的参数，包括：

• setDatabaseName(const QString &name): 设置数据库的名称（对于 SQLite 数据库是文件路径，对于其他数据库是数据库名）。

• setHostName(const QString &host): 设置数据库服务器的主机名。

• setUserName(const QString &name): 设置数据库用户名。

• setPassword(const QString &password): 设置数据库密码。

3. 打开和关闭连接

一旦设置了连接参数，你可以使用 open 函数打开数据库连接，并使用 close 函数关闭数据库连接。此外，你可以使用 isOpen 函数检查连接是否已打开。

4. 连接状态和有效性

你可以使用 isValid 函数检查数据库连接是否有效。一个有效的连接是指已经成功添加到连接池中的连接，并且未被移除。

5. 连接池管理

Qt 的数据库模块还提供了连接池的功能，可以通过 removeDatabase 函数从连接池中移除指定的数据库连接。这在需要释放不再需要的连接时非常有用，避免资源浪费。

总结

QSqlDatabase 类是连接到数据库并管理数据库连接的核心类之一。通过它，你可以轻松地连接到各种数据库系统，设置连接参数，并管理连接的状态和有效性。这使得在 Qt 应用程序中进行数据库操作变得更加简单和灵活。

二、QSqlQuery类

QSqlQuery 类是 Qt 数据库模块中用于执行 SQL 查询和命令的主要类之一。它允许你向数据库发送 SQL 查询语句，并处理返回的结果。下面是关于 QSqlQuery 类的一些重要功能和用法：

1. 创建 QSqlQuery 对象

你可以使用 QSqlQuery 的构造函数创建一个查询对象，然后使用该对象执行 SQL 查询和命令。构造函数的常见用法是：

1. QSqlQuery query;

复制代码

2. 执行 SQL 查询和命令

一旦创建了 QSqlQuery 对象，你可以使用 exec 函数执行 SQL 查询和命令。例如：

1. bool success = query.exec("SELECT * FROM students");

复制代码

这将执行一个 SELECT 查询，并将查询结果存储在 QSqlQuery 对象中。

3. 检索查询结果

你可以使用 next 函数遍历查询结果的每一行，并使用 value 函数获取每一列的值。例如：

1. while (query.next()) {
2. QString name = query.value(0).toString(); // 获取第一列的值并转换为字符串
3. int age = query.value(1).toInt(); // 获取第二列的值并转换为整数
4. // 处理结果...
5. }

复制代码

4. 绑定参数

你可以使用 bindValue 函数将值绑定到 SQL 查询中的占位符。这是防止 SQL 注入攻击的一种重要方法。例如：

1. query.prepare("SELECT * FROM students WHERE name = :name");
2. query.bindValue(":name", "John");
3. query.exec();

复制代码

这里 :name 是一个占位符，bindValue 函数将值 “John” 绑定到该占位符上。

5. 错误处理

你可以使用 lastError 函数来获取最后一个执行错误的详细信息。这对于调试数据库操作非常有用。

总结

QSqlQuery 类是执行 SQL 查询和命令的核心类之一。通过它，你可以执行各种 SQL 查询和命令，并处理返回的结果。此外，它还提供了绑定参数和错误处理等功能，使得数据库操作更加安全和可靠。

三、数据库的使用示例

1. #include "widget.h"
2. #include "ui_widget.h"
3. #include <QDebug>
4. #include <QSqlQuery>
6. Widget::Widget(QWidget *parent)
7. : QWidget(parent)
8. , ui(new Ui::Widget)
9. {
10. ui->setupUi(this);
12. // 建立与SQLite数据库的连接
13. m_db = QSqlDatabase::addDatabase("QSQLITE");
14. m_db.setDatabaseName("example.db"); // 你可以更改为任何你想要的名称
15. if (!m_db.open())
16. {
17. qDebug() << "错误：无法连接到数据库";
18. }
19. else
20. {
21. qDebug() << "数据库：连接成功";
22. }
24. // 执行SQL查询来创建表
25. QSqlQuery query;
26. bool success = query.exec("CREATE TABLE IF NOT EXISTS students ("
27. "id INTEGER PRIMARY KEY AUTOINCREMENT,"
28. "name TEXT,"
29. "age INTEGER)");
31. if (!success)
32. {
33. qDebug() << "错误：无法创建表";
34. }
35. else
36. {
37. qDebug() << "表 'students' 创建成功";
38. }
40. // 执行SQL查询将数据插入表中
41. QSqlQuery query1;
42. query1.prepare("INSERT INTO students (name, age) VALUES (:name, :age)");
43. query1.bindValue(":name", "Li hua");
44. query1.bindValue(":age", 20);
46. if (!query1.exec())
47. {
48. qDebug() << "错误：无法插入数据";
49. }
50. else
51. {
52. qDebug() << "数据插入成功";
53. }
55. QSqlQuery query2("SELECT * FROM students");
56. while (query2.next())
57. {
58. qDebug() << "ID:" << query2.value(0).toInt() << ", 名字:" << query2.value(1).toString() << ", 年龄:" << query2.value(2).toInt();
59. }
61. // 更新数据
62. QSqlQuery query3;
63. query3.prepare("UPDATE students SET age = :age WHERE name = :name");
64. query3.bindValue(":name", "Li hua");
65. query3.bindValue(":age", 21); // 修改年龄为21岁
66. if (!query3.exec())
67. {
68. qDebug() << "错误：无法更新数据";
69. }
70. else
71. {
72. qDebug() << "数据更新成功";
73. }
75. // 删除数据
76. QSqlQuery query4;
77. query4.prepare("DELETE FROM students WHERE name = :name");
78. query4.bindValue(":name", "Li hua");
79. if (!query4.exec())
80. {
81. qDebug() << "错误：无法删除数据";
82. }
83. else
84. {
85. qDebug() << "数据删除成功";
86. }
89. // 关闭数据库连接
90. if (m_db.isOpen())
91. {
92. m_db.close();
93. }
94. }
96. Widget::~Widget()
97. {
98. delete ui;
99. }

复制代码

1. 建立与SQLite数据库的连接：

   • 使用 QSqlDatabase::addDatabase("QSQLITE") 添加一个 SQLite 数据库连接。
   • 使用 setDatabaseName("example.db") 设置数据库文件的名称为 “example.db”。你可以将其更改为你想要的任何名称。
   • 使用 open() 打开数据库连接。如果连接失败，则输出错误信息。

2. 执行SQL查询来创建表：

   • 使用 QSqlQuery 对象执行 SQL 查询，创建一个名为 “students” 的表，该表包括 id、name 和 age 列。
   • 使用 exec() 函数执行 SQL 查询。如果执行失败，则输出错误信息。

3. 执行SQL查询将数据插入表中：

   • 使用 prepare() 函数准备一个 SQL 预处理语句，用于向 “students” 表中插入数据。
   • 使用 bindValue() 函数将值绑定到占位符 “:name” 和 “:age” 上。
   • 使用 exec() 函数执行 SQL 查询来插入数据。如果插入失败，则输出错误信息。

4. 查询数据：

   • 使用 QSqlQuery 对象执行 SQL 查询，选择 “students” 表中的所有数据。
   • 使用 while 循环遍历查询结果，并使用 value() 函数获取每一列的值，并输出到控制台。

5. 更新数据：

   • 使用 prepare() 函数准备一个 SQL 预处理语句，用于更新 “students” 表中的数据。
   • 使用 bindValue() 函数将新的年龄值绑定到占位符 “:age” 上。
   • 使用 exec() 函数执行 SQL 查询来更新数据。如果更新失败，则输出错误信息。

6. 删除数据：

   • 使用 prepare() 函数准备一个 SQL 预处理语句，用于从 “students” 表中删除数据。
   • 使用 bindValue() 函数将要删除的姓名绑定到占位符 “:name” 上。
   • 使用 exec() 函数执行 SQL 查询来删除数据。如果删除失败，则输出错误信息。

7. 关闭数据库连接：

   • 使用 close() 函数关闭数据库连接。

总结

本篇文章就讲解到这里。