【QT开发】并发编程管理QFuture类详解及实战应用

通过 QFuture 和 QFutureWatcher，Qt 提供了一套强大且易于使用的接口，用于管理和操作并发任务。合理应用 QFuture 提供的方法，可以高效地完成多线程并发任务，同时结合信号槽机制和线程池管理技术，能够进一步优化程序性能和响应性。

---

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

🌟 概述

在并发编程中，QFuture 类是 QtConcurrent 框架中非常重要的一个部分，用于表示正在进行的异步操作，以及进行任务的状态管理和结果获取。通过 QFuture，开发者可以高效地管理和监控异步任务，并轻松地获取任务的结果和进度信息。

本文将详细介绍 QFuture 类及其应用，包括基本异步操作、任务监控、信号槽机制及解决常见问题和优化技巧。通过本文，您将学会如何在应用程序中使用 QFuture 进行高效的并发编程。

📖 QFuture 类介绍

QFuture 提供了一种多线程异步运算的管理方式，允许获取异步任务的结果，查询任务的状态以及取消任务等操作。

常用方法

• result()：返回异步任务的结果。如果任务未完成，则会阻塞等待任务完成。
• results()：返回一个包含所有任务结果的列表。
• isFinished()：检查任务是否已经完成。
• isCanceled()：检查任务是否已经被取消。
• isRunning()：检查任务是否正在运行。
• cancel()：取消任务。
• waitForFinished()：阻塞当前线程，等待任务完成。
• progressValue()：获取任务的当前进度。
• progressMaximum()：获取任务的最大进度值。
• progressMinimum()：获取任务的最小进度值。

信号和槽机制

• QFutureWatcher::finished()：当任务完成时发射此信号。
• QFutureWatcher::progressValueChanged(int)：当任务进度发生变化时发射此信号。
• QFutureWatcher::resultReadyAt(int)：当任务的某个结果准备好时发射此信号。

常用枚举类型

• 任务状态：
  • QFuture::State：表示任务的当前状态，如 QFuture::Running、QFuture::Finished。
• 进度状态：
  • QFuture::progressType：表示任务的进度类型，如 QFuture::Percentage、QFuture::Value。

💻 示例代码

示例：基本异步操作

通过一个简单的示例，演示如何使用 QFuture 和 QFutureWatcher 进行异步操作。

头文件：mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QtConcurrent/QtConcurrent>
#include <QFutureWatcher>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    void on_startButton_clicked();
    void taskFinished();
    void updateProgress(int value);

private:
    Ui::MainWindow *ui;
    QFutureWatcher<void> watcher;
};

#endif // MAINWINDOW_H

源文件：mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QDebug>
#include <QThreadPool>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    connect(&watcher, &QFutureWatcher<void>::finished, this, &MainWindow::taskFinished);
    connect(&watcher, &QFutureWatcher<void>::progressValueChanged, this, &MainWindow::updateProgress);
}

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

void MainWindow::on_startButton_clicked()
{
    auto task = []() {
        for (int i = 0; i <= 100; ++i) {
            QThread::sleep(1);  // 模拟任务操作
            QFutureInterface<void> interface; 
            interface.setProgressValue(i);
        }
    };

    // 启动异步任务
    QFuture<void> future = QtConcurrent::run(task);
    watcher.setFuture(future);
}

void MainWindow::taskFinished()
{
    qDebug() << "Task finished";
    ui->statusLabel->setText("Task Completed");
}

void MainWindow::updateProgress(int value)
{
    ui->progressBar->setValue(value);
    qDebug() << "Progress:" << value << "%";
}

代码解释

• 启动异步任务：在 on_startButton_clicked() 槽函数中，利用 QtConcurrent::run 启动一个后台任务，并与 QFutureWatcher 关联以监控任务状态。
• 任务完成处理：当任务完成时，QFutureWatcher::finished() 信号会触发 taskFinished() 槽函数，更新 UI 状态。
• 更新进度：通过 QFutureWatcher::progressValueChanged() 信号和 updateProgress() 槽函数来更新进度条。

方法分析

通过 QFuture 和 QFutureWatcher，可以轻松地管理并发任务，并实时获取任务的执行状态和进度信息，为用户提供更好的互动体验。

高级应用技巧

1. 获取异步任务结果

QFuture 提供了方法可以轻松获取异步任务的结果，包括 result() 和 results()。

示例代码

void MainWindow::on_startButton_clicked()
{
    QFuture<int> future = QtConcurrent::run([]() {
        QThread::sleep(3);
        return 42;  // 模拟任务结果
    });
    watcher.setFuture(future);

    // 获取任务结果
    future.waitForFinished();
    int result = future.result();
    ui->resultLabel->setText(QString::number(result));
}

2. 取消异步任务

通过 QFuture::cancel() 方法，可以取消正在进行的异步任务。

示例代码

void MainWindow::on_cancelButton_clicked()
{
    if (watcher.future().isRunning()) {
        watcher.future().cancel();
        ui->statusLabel->setText("Task Canceled");
    }
}

3. 使用进度信号更新界面

结合 QFutureWatcher 的进度信号，可以实时更新用户界面元素，如进度条。

示例代码

connect(&watcher, &QFutureWatcher<void>::progressValueChanged, this, &MainWindow::updateProgress);

void MainWindow::updateProgress(int value)
{
    ui->progressBar->setValue(value);
}

4. 结合线程池管理并发任务

通过自定义线程池，可以更好地管理并发任务的执行，提高资源利用率。

示例代码

QThreadPool pool;
pool.setMaxThreadCount(4);

QFuture<void> future = QtConcurrent::run(&pool, []() {
    // 执行并发任务
});
watcher.setFuture(future);

🚩 常见问题及解决方法

1. 任务未能正常启动

• 问题：任务未能正常启动，可能由于线程池已满或输入参数不正确。
• 解决方法：检查线程池配置，确保有足够的线程数；检查任务函数的定义和参数传递。

示例代码

if (pool.activeThreadCount() >= pool.maxThreadCount()) {
    qDebug() << "线程池已满，无法启动新任务";
} else {
    QFuture<void> future = QtConcurrent::run(&pool, []() {
        // 执行任务
    });
    watcher.setFuture(future);
}

2. 任务结果获取失败

• 问题：任务结果获取失败，可能是任务未正确完成或被取消。
• 解决方法：确保任务正常完成，并在获取结果前检查任务状态。

示例代码

if (future.isFinished() && !future.isCanceled()) {
    int result = future.result();
} else {
    qDebug() << "任务未完成或已取消，无法获取结果";
}

3. 任务进度无法正确显示

• 问题：任务进度无法正确显示，可能是未正确连接 progressValueChanged 信号。
• 解决方法：确保正确连接进度信号，并在任务中正确设置进度值。

示例代码

connect(&watcher, &QFutureWatcher<void>::progressValueChanged, this, &MainWindow::updateProgress);

void MainWindow::updateProgress(int value)
{
    ui->progressBar->setValue(value);
}

📌 总结

通过 QFuture 和 QFutureWatcher，Qt 提供了一套强大且易于使用的接口，用于管理和操作并发任务。合理应用 QFuture 提供的方法，可以高效地完成多线程并发任务，同时结合信号槽机制和线程池管理技术，能够进一步优化程序性能和响应性。