@TOC

前言

本篇文章将带大家来学习在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 查询和命令。构造函数的常见用法是：

QSqlQuery query;

2. 执行 SQL 查询和命令

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

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

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

3. 检索查询结果

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

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

4. 绑定参数

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

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

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

5. 错误处理

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

总结

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

三、数据库的使用示例

#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <QSqlQuery>

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

    // 建立与SQLite数据库的连接
    m_db = QSqlDatabase::addDatabase("QSQLITE");
    m_db.setDatabaseName("example.db"); // 你可以更改为任何你想要的名称
    if (!m_db.open())
    {
        qDebug() << "错误：无法连接到数据库";
    }
    else
    {
        qDebug() << "数据库：连接成功";
    }

    // 执行SQL查询来创建表
    QSqlQuery query;
    bool success = query.exec("CREATE TABLE IF NOT EXISTS students ("
                              "id INTEGER PRIMARY KEY AUTOINCREMENT,"
                              "name TEXT,"
                              "age INTEGER)");

    if (!success)
    {
        qDebug() << "错误：无法创建表";
    }
    else
    {
        qDebug() << "表 'students' 创建成功";
    }

    // 执行SQL查询将数据插入表中
    QSqlQuery query1;
    query1.prepare("INSERT INTO students (name, age) VALUES (:name, :age)");
    query1.bindValue(":name", "Li hua");
    query1.bindValue(":age", 20);

    if (!query1.exec())
    {
        qDebug() << "错误：无法插入数据";
    }
    else
    {
        qDebug() << "数据插入成功";
    }

    QSqlQuery query2("SELECT * FROM students");
    while (query2.next())
    {
        qDebug() << "ID:" << query2.value(0).toInt() << ", 名字:" << query2.value(1).toString() << ", 年龄:" << query2.value(2).toInt();
    }

    // 更新数据
    QSqlQuery query3;
    query3.prepare("UPDATE students SET age = :age WHERE name = :name");
    query3.bindValue(":name", "Li hua");
    query3.bindValue(":age", 21); // 修改年龄为21岁
    if (!query3.exec())
    {
        qDebug() << "错误：无法更新数据";
    }
    else
    {
        qDebug() << "数据更新成功";
    }

    // 删除数据
    QSqlQuery query4;
    query4.prepare("DELETE FROM students WHERE name = :name");
    query4.bindValue(":name", "Li hua");
    if (!query4.exec())
    {
        qDebug() << "错误：无法删除数据";
    }
    else
    {
        qDebug() << "数据删除成功";
    }


    // 关闭数据库连接
    if (m_db.isOpen())
    {
        m_db.close();
    }
}

Widget::~Widget()
{
    delete ui;
}

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() 函数关闭数据库连接。

总结

本篇文章就讲解到这里。