Qt学习：Qt 进程和线程之四，线程实际应用

为了让程序尽快响应用户操作，在开发应用程序时经常会使用到线程。对于耗时操作如果不使用线程，UI 界面将会长时间处于停滞状态，这种情况是用户非常不愿意看到的，我们可以用线程来解决这个问题。

大多数情况下，多线程耗时操作会与 UI 进行交互，比如：显示进度、加载等待。。。让用户明确知道目前的状态，并对结果有一个直观的预期，甚至有趣巧妙的设计，能让用户爱上等待，把等待看成一件很美好的事。

一、多线程操作 UI 界面的示例

下面，是一个使用多线程操作 UI 界面的示例 - 更新进度条，采用子类化 QThread 的方式。与此同时，分享在此过程中有可能遇到的问题及解决方法。

首先创建 QtGui 应用，工程名称为 “myThreadBar”，类名选择 “QMainWindow”，其他选项保持默认即可。再添加一个名称为 WorkerThread 的头文件，定义一个 WorkerThread 类，让其继承自 QThread，并重写 run () 函数，修改 workerthread.h 文件如下：

#ifndef WORKERTHREAD_H
#define WORKERTHREAD_H

#include <QThread>
#include <QDebug>

class WorkerThread : public QThread
{
    Q_OBJECT

public:
    explicit WorkerThread(QObject *parent = 0)
        : QThread(parent)
    {
        qDebug() << "Worker Thread : " << QThread::currentThreadId();
    }

protected:
    virtual void run() Q_DECL_OVERRIDE
    {
        qDebug() << "Worker Run Thread : " << QThread::currentThreadId();
        int nValue = 0;
        while (nValue < 100)
        {
            // 休眠50毫秒
            msleep(50);
            ++nValue;

            // 准备更新
            emit resultReady(nValue);
        }
    }

signals:
    void resultReady(int value);
};

#endif // WORKERTHREAD_H

通过在 run () 函数中调用 msleep (50)，线程会每隔 50 毫秒让当前的进度值加 1，然后发射一个 resultReady () 信号，其余时间什么都不做。在这段空闲时间，线程不占用任何的系统资源。当休眠时间结束，线程就会获得 CPU 时钟，将继续执行它的指令。在 mainwindow.ui 上添加一个按钮和进度条部件，然后 mainwindow.h 修改如下：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include "workerthread.h"

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

private slots:
    // 更新进度
    void handleResults(int value);

    // 开启线程
    void startThread();

private:
    Ui::MainWindow *ui;

    WorkerThread m_workerThread;
};

#endif // MAINWINDOW_H

然后 mainwindow.cpp 修改如下：

#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
        
  qDebug() << "Main Thread : " << QThread::currentThreadId();        

    // 连接信号槽
    this->connect(ui->pushButton, SIGNAL(clicked(bool)), this, SLOT(startThread()));
}

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

void MainWindow::handleResults(int value)
{
    qDebug() << "Handle Thread : " << QThread::currentThreadId();
    ui->progressBar->setValue(value);
}

void MainWindow::startThread()
{
    WorkerThread *workerThread = new WorkerThread(this);
    this->connect(workerThread, SIGNAL(resultReady(int)), this, SLOT(handleResults(int)));
    // 线程结束后，自动销毁
    this->connect(workerThread, SIGNAL(finished()), workerThread, SLOT(deleteLater()));
    workerThread->start();
}

由于信号与槽连接类型默认为 “Qt::AutoConnection”，在这里相当于 “Qt::QueuedConnection”。也就是说，槽函数在接收者的线程（主线程）中执行。

执行程序，“应用程序输出” 窗口输出如下：

Main Thread :  0x3140
Worker Thread :  0x3140
Worker Run Thread :  0x2588
Handle Thread :  0x3140

显然，UI 界面、Worker 构造函数、槽函数处于同一线程（主线程），而 run () 函数处于另一线程（次线程）。

回到顶部

二、避免多次 connect

当多次点击 “开始” 按钮的时候，就会多次 connect ()，从而启动多个线程，同时更新进度条。为了避免这个问题，我们先在 mainwindow.h 上添加私有成员变量 "WorkerThread m_workerThread;"，然后修改 mainwindow.cpp 如下：

#include "mainwindow.h"
#include "ui_mainwindow.h"

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

    // 连接信号槽
    this->connect(ui->pushButton, SIGNAL(clicked(bool)), this, SLOT(startThread()));

    this->connect(&m_workerThread, SIGNAL(resultReady(int)), this, SLOT(handleResults(int)));
}

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

void MainWindow::handleResults(int value)
{
    qDebug() << "Handle Thread : " << QThread::currentThreadId();
    ui->progressBar->setValue(value);
}

void MainWindow::startThread()
{
    if (!m_workerThread.isRunning())
        m_workerThread.start();
}

不再在 startThread () 函数内创建 WorkerThread 对象指针，而是定义私有成员变量，再将 connect 添加在构造函数中，保证了信号槽的正常连接。在线程 start () 之前，可以使用 isFinished () 和 isRunning () 来查询线程的状态，判断线程是否正在运行，以确保线程的正常启动。

三、优雅地结束线程的两种方法

如果一个线程运行完成，就会结束。可很多情况并非这么简单，由于某种特殊原因，当线程还未执行完时，我们就想中止它。

不恰当的中止往往会引起一些未知错误。比如：当关闭主界面的时候，很有可能次线程正在运行，这时，就会出现如下提示：

QThread: Destroyed while thread is still running

这是因为次线程还在运行，就结束了 UI 主线程，导致事件循环结束。这个问题在使用线程的过程中经常遇到，尤其是耗时操作。大多数情况下，当程序退出时，次线程也许会正常退出。这时，虽然抱着侥幸心理，但隐患依然存在，也许在极少数情况下，就会出现 Crash。

所以，我们应该采取合理的措施来优雅地结束线程，一般思路：

1. 发起线程退出操作，调用 quit () 或 exit ()。

2. 等待线程完全停止，删除创建在堆上的对象。

3. 适当的使用 wait ()（用于等待线程的退出）和合理的算法。

方法一

这种方式是 Qt4.x 中比较常用的，主要是利用 “QMutex 互斥锁 + bool 成员变量” 的方式来保证共享数据的安全性。在 workerthread.h 上继续添加互斥锁、析构函数和 stop () 函数，修改如下：

#ifndef WORKERTHREAD_H
#define WORKERTHREAD_H

#include <QThread>
#include <QMutexLocker>
#include <QDebug>

class WorkerThread : public QThread
{
    Q_OBJECT

public:
    explicit WorkerThread(QObject *parent = 0)
        : QThread(parent),
          m_bStopped(false)
    {
        qDebug() << "Worker Thread : " << QThread::currentThreadId();
    }

    ~WorkerThread()
    {
        stop();
        quit();
        wait();
    }

    void stop()
    {
        qDebug() << "Worker Stop Thread : " << QThread::currentThreadId();
        QMutexLocker locker(&m_mutex);
        m_bStopped = true;
    }

protected:
    virtual void run() Q_DECL_OVERRIDE 
    {
        qDebug() << "Worker Run Thread : " << QThread::currentThreadId();
        int nValue = 0;
        while (nValue < 100)
        {
            // 休眠50毫秒
            msleep(50);
            ++nValue;

            // 准备更新
            emit resultReady(nValue);

            // 检测是否停止
            {
                QMutexLocker locker(&m_mutex);
                if (m_bStopped)
                    break;
            }
            // locker超出范围并释放互斥锁
        }
    }
    
signals:
    void resultReady(int value);

private:
    bool m_bStopped;
    QMutex m_mutex;
};

#endif // WORKERTHREAD_H

当主窗口被关闭，其 “子对象” WorkerThread 也会析构调用 stop () 函数，使 m_bStopped 变为 true，则 break 跳出循环结束 run () 函数，结束进程。当主线程调用 stop () 更新 m_bStopped 的时候，run () 函数也极有可能正在访问它（这时，他们处于不同的线程），所以存在资源竞争，因此需要加锁，保证共享数据的安全性。

为什么要加锁？

很简单，是为了共享数据段操作的互斥。避免形成资源竞争的情况（多个线程有可能访问同一共享资源的情况）。

方法二

Qt5 以后，可以使用 requestInterruption ()、isInterruptionRequested () 这两个函数，使用很方便，修改 workerthread.h 文件如下：

#ifndef WORKERTHREAD_H
#define WORKERTHREAD_H

#include <QThread>
#include <QMutexLocker>
#include <QDebug>

class WorkerThread : public QThread
{
    Q_OBJECT

public:
    explicit WorkerThread(QObject *parent = nullptr)
        : QThread(parent)
    {
        qDebug() << "Worker Thread : " << QThread::currentThreadId();
    }

    ~WorkerThread()
    {
        // 请求终止
        requestInterruption();
        quit();
        wait();
    }

protected:
    virtual void run() Q_DECL_OVERRIDE
    {
        qDebug() << "Worker Run Thread : " << QThread::currentThreadId();
        int nValue = 0;

        // 是否请求终止
        while (!isInterruptionRequested())
        {
            while (nValue < 100)
            {
                // 休眠50毫秒
                msleep(50);
                ++nValue;

                // 准备更新
                emit resultReady(nValue);
            }
        }

    }
signals:
    void resultReady(int value);
};

#endif // WORKERTHREAD_H

在耗时操作中使用 isInterruptionRequested () 来判断是否请求终止线程，如果没有，则一直运行；当希望终止线程的时候，调用 requestInterruption () 即可。这两个函数内部也使用了互斥锁 QMutex。