QSqlQuery 深度讲解与实战示例

        QSqlQuery 是 Qt 中用于执行和操作 SQL 语句的核心类，它提供了执行任意 SQL 语句并遍历结果集的能力。相比 QSqlQueryModel，它更底层、更灵活，适合需要精细控制数据库操作的场景。

一、核心特点

1. 全能型：可执行 DML（SELECT/INSERT/UPDATE/DELETE）和 DDL（CREATE TABLE 等）

2. 灵活高效：支持预编译语句，提高性能并防止 SQL 注入

3. 结果集遍历：提供类似游标的功能遍历查询结果

4. 事务支持：可与 QSqlDatabase 配合实现事务操作

二、基本用法示例

#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>

int main() {
    // 建立数据库连接
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName(":memory:");
    if (!db.open()) {
        qDebug() << "无法打开数据库";
        return 1;
    }
    
    // 创建表
    QSqlQuery query;
    if (!query.exec("CREATE TABLE books (id INTEGER PRIMARY KEY, title TEXT, author TEXT, price REAL)")) {
        qDebug() << "创建表失败:" << query.lastError();
    }
    
    // 插入数据
    query.exec("INSERT INTO books (title, author, price) VALUES ('Qt入门', '张老师', 59.9)");
    query.exec("INSERT INTO books (title, author, price) VALUES ('C++高级编程', '李教授', 89.9)");
    
    // 查询数据
    query.exec("SELECT * FROM books");
    while (query.next()) {
        QString title = query.value("title").toString();
        QString author = query.value(2).toString(); // 第3列
        double price = query.value(3).toDouble();
        qDebug() << title << " by " << author << " 价格: " << price;
    }
    
    return 0;
}

三、核心方法详解

1. 执行 SQL 语句

// 直接执行SQL
bool success = query.exec("DELETE FROM books WHERE price > 80");

// 检查执行结果
if (!success) {
    qDebug() << "执行失败:" << query.lastError().text();
}

// 获取受影响的行数
int numDeleted = query.numRowsAffected();

2. 预编译语句（防止SQL注入）

// 准备查询
query.prepare("INSERT INTO books (title, author, price) VALUES (?, ?, ?)");

// 绑定值（索引从0开始）
query.addBindValue("Python编程");
query.addBindValue("王教授");
query.addBindValue(75.5);

// 执行
if (!query.exec()) {
    qDebug() << "插入失败:" << query.lastError();
}

// 命名占位符方式
query.prepare("UPDATE books SET price = :price WHERE id = :id");
query.bindValue(":price", 99.9);
query.bindValue(":id", 2);
query.exec();

3. 遍历结果集

query.exec("SELECT id, title, price FROM books WHERE price > 50");

// 获取字段信息
QSqlRecord record = query.record();
int idCol = record.indexOf("id"); // 获取字段索引

while (query.next()) {
    // 多种获取数据的方式
    int id = query.value(0).toInt();          // 按索引
    QString title = query.value("title").toString(); // 按字段名
    double price = query.value(priceCol).toDouble();
    
    qDebug() << "ID:" << id << "Title:" << title << "Price:" << price;
}

四、高级用法

1. 批量操作

// 批量插入（使用事务提高性能）
db.transaction();

query.prepare("INSERT INTO books (title, author) VALUES (?, ?)");

QVariantList titles, authors;
titles << "Book1" << "Book2" << "Book3";
authors << "Author1" << "Author2" << "Author3";

query.addBindValue(titles);
query.addBindValue(authors);

if (!query.execBatch()) { // 批量执行
    db.rollback();
    qDebug() << "批量插入失败";
} else {
    db.commit();
}

2. 存储过程调用

// 调用MySQL存储过程
query.prepare("CALL get_books_by_author(?)");
query.bindValue(0, "李教授");

if (query.exec()) {
    while (query.next()) {
        // 处理结果...
    }
    
    // 处理多结果集（MySQL）
    while (query.nextResult()) {
        // 处理下一个结果集...
    }
}

3. 二进制数据操作

// 插入图片
QFile file("cover.jpg");
if (file.open(QIODevice::ReadOnly)) {
    QByteArray imageData = file.readAll();
    query.prepare("UPDATE books SET cover = ? WHERE id = 1");
    query.addBindValue(imageData);
    query.exec();
}

// 读取图片
query.exec("SELECT cover FROM books WHERE id = 1");
if (query.next()) {
    QByteArray imageData = query.value(0).toByteArray();
    QPixmap cover;
    cover.loadFromData(imageData);
}

五、实际应用场景

1. 分页查询

// 分页获取数据
int page = 2, pageSize = 10;
query.prepare("SELECT * FROM books LIMIT ? OFFSET ?");
query.addBindValue(pageSize);
query.addBindValue((page - 1) * pageSize);
query.exec();

// 获取总行数
query.exec("SELECT COUNT(*) FROM books");
query.next();
int totalRows = query.value(0).toInt();
int totalPages = (totalRows + pageSize - 1) / pageSize;

2. 数据导出

// 导出到CSV
QFile csv("books.csv");
if (csv.open(QIODevice::WriteOnly)) {
    QTextStream out(&csv);
    
    query.exec("SELECT * FROM books");
    QSqlRecord rec = query.record();
    
    // 写表头
    for (int i = 0; i < rec.count(); ++i) {
        if (i > 0) out << ",";
        out << rec.fieldName(i);
    }
    out << "\n";
    
    // 写数据
    while (query.next()) {
        for (int i = 0; i < rec.count(); ++i) {
            if (i > 0) out << ",";
            out << query.value(i).toString();
        }
        out << "\n";
    }
}

3. 动态查询构建

// 根据条件动态构建查询
QStringList conditions;
QVariantList values;

if (!authorFilter.isEmpty()) {
    conditions << "author LIKE ?";
    values << "%" + authorFilter + "%";
}

if (minPrice > 0) {
    conditions << "price >= ?";
    values << minPrice;
}

QString sql = "SELECT * FROM books";
if (!conditions.isEmpty()) {
    sql += " WHERE " + conditions.join(" AND ");
}

query.prepare(sql);
foreach (const QVariant &value, values) {
    query.addBindValue(value);
}

query.exec();

六、性能优化技巧

1.使用预编译语句：特别是循环中重复执行的语句

query.prepare("INSERT INTO logs (message) VALUES (?)");
for (const QString &msg : messages) {
    query.bindValue(0, msg);
    query.exec();
}

2.合理使用事务：批量操作时

db.transaction();
// 批量操作...
if (allSuccess) db.commit();
else db.rollback();

3.只查询需要的列：避免 SELECT *

query.exec("SELECT id, name FROM users"); // 好
query.exec("SELECT * FROM users"); // 差

4.及时清理结果集：大数据量查询时

query.exec("SELECT * FROM large_table");
query.finish(); // 显式释放资源

七、错误处理最佳实践

bool executeQuery(QSqlQuery &query, const QString &sql)
{
    if (!query.exec(sql)) {
        QSqlError error = query.lastError();
        qCritical() << "SQL错误:" << error.text()
                   << "\nSQL:" << sql
                   << "\n数据库驱动错误:" << error.driverText();
        return false;
    }
    return true;
}

// 使用
QSqlQuery query;
if (!executeQuery(query, "SELECT * FROM non_existent_table")) {
    // 错误处理
}

八、常见问题解决方案

问题1：如何获取自增ID？

query.prepare("INSERT INTO books (title) VALUES (?)");
query.bindValue(0, "新书");
query.exec();

// 获取最后插入的ID
int newId = query.lastInsertId().toInt();

问题2：如何处理NULL值？

query.prepare("INSERT INTO books (title, subtitle) VALUES (?, ?)");
query.bindValue(0, "主标题");
query.bindValue(1, QVariant(QVariant::String)); // 绑定NULL

if (query.value("subtitle").isNull()) {
    // 处理NULL情况
}

问题3：如何执行多条语句？

// 需要驱动支持，SQLite不支持
QString sql = "UPDATE books SET price=80 WHERE id=1;"
               "UPDATE books SET price=90 WHERE id=2;";
if (!query.exec(sql)) {
    // 处理错误
}

九、总结

QSqlQuery 是 Qt SQL 模块中最核心的类之一，它：

1. 提供了执行任意 SQL 语句的能力

2. 支持预编译语句，安全高效

3. 可以精细控制查询过程和结果处理

4. 适用于从简单查询到复杂数据库操作的各种场景

        掌握 QSqlQuery 的使用是进行 Qt 数据库开发的基础，结合事务、批量操作等高级用法，可以构建出高效可靠的数据库应用。