C++ Qt开发:运用QThread多线程组件

Qt 是一个跨平台C++图形界面开发库,利用Qt可以快速开发跨平台窗体应用程序,在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置,实现图形化开发极大的方便了开发效率,本章将重点介绍如何运用QThread组件实现多线程功能。

多线程技术在程序开发中尤为常用,Qt框架中提供了QThread库来实现多线程功能。当你需要使用QThread时,需包含QThread模块,以下是QThread类的一些主要成员函数和槽函数。

成员函数/槽函数 描述
QThread(QObject *parent = nullptr) 构造函数,创建一个QThread对象。
~QThread() 析构函数,释放QThread对象。
void start(QThread::Priority priority = InheritPriority) 启动线程。
void run() 默认的线程执行函数,需要在继承QThread的子类中重新实现以定义线程的操作。
void exit(int returnCode = 0) 请求线程退出,线程将在适当的时候退出。
void quit() 请求线程退出,与exit()类似。
void terminate() 立即终止线程的执行。这是一个危险的操作,可能导致资源泄漏和未完成的操作。
void wait() 等待线程完成。主线程将被阻塞,直到该线程退出。
bool isRunning() const 检查线程是否正在运行。
void setPriority(Priority priority) 设置线程的优先级。
Priority priority() const 获取线程的优先级。
QThread::Priority priority() 获取线程的优先级。
void setStackSize(uint stackSize) 设置线程的堆栈大小(以字节为单位)。
uint stackSize() const 获取线程的堆栈大小。
void msleep(unsigned long msecs) 使线程休眠指定的毫秒数。
void sleep(unsigned long secs) 使线程休眠指定的秒数。
static QThread *currentThread() 获取当前正在执行的线程的QThread对象。
void setObjectName(const QString &name) 为线程设置一个对象名。

当我们需要创建线程时,通常第一步则是要继承QThread类,并重写类内的run()方法,在run()方法中,你可以编写需要在新线程中执行的代码。当你创建一个QThread的实例并调用它的start()方法时,会自动调用run()来执行线程逻辑,如下这样一段代码展示了如何运用线程类。

#include <QCoreApplication>
#include <QThread>
#include <QDebug>

class MyThread : public QThread
{
public:
void run() override
{
for (int i = 0; i < 5; ++i)
{
qDebug() << "Thread is running" << i;
sleep(1);
}
}
};

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

MyThread thread;
thread.start();
thread.wait();

qDebug() << "Main thread is done.";
return a.exec();
}

上述代码运行后则会每隔1秒输出一段话,在主函数内通过调用thread.start方法启动这个线程,并通过thread.wait等待线程结束,如下图所示;

1.1 线程组与多线程

线程组是一种组织和管理多个线程的机制,允许将相关联的线程集中在一起,便于集中管理、协调和监控。通过线程组,可以对一组线程进行统一的生命周期管理,包括启动、停止、调度和资源分配等操作。

上述方法并未真正实现多线程功能,我们继续完善MyThread自定义类,在该类内增加两个标志,is_run()用于判断线程是否正在运行,is_finish()则用来判断线程是否已经完成,并在run()中增加打印当前线程对象名称的功能。

class MyThread: public QThread
{
protected:
volatile bool m_to_stop;

protected:
void run()
{
for(int x=0; !m_to_stop && (x <10); x++)
{
msleep(1000);
std::cout << objectName().toStdString() << std::endl;
}
}

public:
MyThread()
{
m_to_stop = false;
}

void stop()
{
m_to_stop = true;
}

void is_run()
{
std::cout << "Thread Running = " << isRunning() << std::endl;
}

void is_finish()
{
std::cout << "Thread Finished = " << isFinished() << std::endl;
}

};

接着在主函数内调整,增加一个MyThread thread[10]用于存储线程组,线程组是一种用于组织和管理多个线程的概念。在不同的编程框架和操作系统中,线程组可能具有不同的实现和功能,但通常用于提供一种集中管理和协调一组相关线程的机制。

我们通过循环的方式依次对线程组进行赋值,通过调用setObjectName对每一个线程赋予一个不同的名称,当需要使用这些线程时则可以通过循环调用run()方法来实现,而结束调用同样如此,如下是调用的具体实现;

#include <QCoreApplication>
#include <iostream>
#include <QThread>

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

// 定义线程数组
MyThread thread[10];

// 设置线程对象名字
for(int x=0;x<10;x++)
{
thread[x].setObjectName(QString("thread => %1").arg(x));
}

// 批量调用run执行
for(int x=0;x<10;x++)
{
thread[x].start();
thread[x].is_run();
thread[x].isFinished();
}

// 批量调用stop关闭
for(int x=0;x<10;x++)
{
thread[x].wait();
thread[x].stop();

thread[x].is_run();
thread[x].is_finish();
}

return a.exec();
}

如下图则是运行后实现的多线程效果;

1.2 向线程中传递参数

向线程中传递参数是多线程编程中常见的需求,不同的编程语言和框架提供了多种方式来实现这个目标,在Qt中,由于使用的自定义线程类,所以可通过增加一个set_value()方法来向线程内传递参数,由于线程函数内的变量使用了protected属性,所以也就实现了线程间变量的隔离,当线程被执行结束后则可以通过result()方法获取到线程执行结果,这个线程函数如下所示;

class MyThread: public QThread
{
protected:
int m_begin;
int m_end;
int m_result;

void run()
{
m_result = m_begin + m_end;
}

public:
MyThread()
{
m_begin = 0;
m_end = 0;
m_result = 0;
}

// 设置参数给当前线程
void set_value(int x,int y)
{
m_begin = x;
m_end = y;
}

// 获取当前线程名
void get_object_name()
{
std::cout << "this thread name => " << objectName().toStdString() << std::endl;
}

// 获取线程返回结果
int result()
{
return m_result;
}
};

在主函数中,我们通过MyThread thread[3];来定义3个线程组,并通过循环三次分别thread[x].set_value()设置三组不同的参数,当设置完成后则可以调用thread[x].start()方法运行这些线程,线程运行结束后则返回值将会被依次保存在thread[x].result()中,此时直接将其相加即可得到最终线程执行结果;

#include <QCoreApplication>
#include <iostream>
#include <QThread>

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

MyThread thread[3];

// 分别将不同的参数传入到线程函数内
for(int x=0; x<3; x++)
{
thread[x].set_value(1,2);
thread[x].setObjectName(QString("thread -> %1").arg(x));
thread[x].start();
}

// 等待所有线程执行结束
for(int x=0; x<3; x++)
{
thread[x].get_object_name();
thread[x].wait();
}

// 获取线程返回值并相加
int result = thread[0].result() + thread[1].result() + thread[2].result();
std::cout << "sum => " << result << std::endl;

return a.exec();
}

程序运行后,则可以输出三个线程相加的和;

1.3 互斥同步线程锁

QMutex 是Qt框架中提供的用于线程同步的类,用于实现互斥访问共享资源。Mutex是“互斥锁(Mutual Exclusion)”的缩写,它能够确保在任意时刻,只有一个线程可以访问被保护的资源,从而避免了多线程环境下的数据竞争和不一致性。

在Qt中,QMutex提供了简单而有效的线程同步机制,其基本用法包括:

  • 锁定(Lock): 线程在访问共享资源之前,首先需要获取QMutex的锁,这通过调用lock()方法来实现。
  • 解锁(Unlock): 当线程使用完共享资源后,需要释放QMutex的锁,以允许其他线程访问,这通过调用unlock()方法来实现。

该锁lock()锁定与unlock()解锁必须配对使用,线程锁保证线程间的互斥,利用线程锁能够保证临界资源的安全性。

  • 线程锁解决的问题: 多个线程同时操作同一个全局变量,为了防止资源的无序覆盖现象,从而需要增加锁,来实现多线程抢占资源时可以有序执行。
  • 临界资源(Critical Resource): 每次只允许一个线程进行访问 (读/写)的资源。
  • 线程间的互斥(竞争): 多个线程在同一时刻都需要访问临界资源。
  • 一般性原则: 每一个临界资源都需要一个线程锁进行保护。

我们以生产者消费者模型为例来演示锁的使用方法,生产者消费者模型是一种并发编程中常见的同步机制,用于解决多线程环境下的协作问题。该模型基于两类角色:生产者(Producer)和消费者(Consumer),它们通过共享的缓冲区进行协作。

主要特点和工作原理如下:

  1. 生产者:
    • 生产者负责产生一些资源或数据,并将其放入共享的缓冲区中。生产者在生产资源后,需要通知消费者,以便它们可以取走资源。
  2. 消费者:
    • 消费者从共享的缓冲区中取走资源,并进行相应的处理。如果缓冲区为空,消费者需要等待,直到有新的资源可用。
  3. 共享缓冲区:
    • 作为生产者和消费者之间的交换介质,共享缓冲区存储被生产者产生的资源。它需要提供对资源的安全访问,以防止竞态条件和数据不一致性。
  4. 同步机制:
    • 生产者和消费者之间需要一些同步机制,以确保在正确的时机进行资源的生产和消费。典型的同步机制包括信号量、互斥锁、条件变量等。

生产者消费者模型的典型应用场景包括异步任务处理、事件驱动系统、数据缓存等。这种模型的实现可以通过多线程编程或使用消息队列等方式来完成。

首先在全局中引入#include <QMutex>库,并在全局定义static QMutex线程锁变量,接着我们分别定义两个自定义线程函数,其中Producer代表生产者,而Customer则是消费者,生产者中负责每次产出一个随机数并将其追加到g_store全局变量内保存,消费者则通过g_store.remove每次取出一个元素。

static QMutex g_mutex;      // 线程锁
static QString g_store; // 定义全局变量

class Producer : public QThread
{
protected:
void run()
{
int count = 0;

while(true)
{
// 加锁
g_mutex.lock();

g_store.append(QString::number((count++) % 10));
std::cout << "Producer -> "<< g_store.toStdString() << std::endl;

// 释放锁
g_mutex.unlock();
msleep(900);
}
}
};

class Customer : public QThread
{
protected:
void run()
{
while( true )
{
g_mutex.lock();
if( g_store != "" )
{
g_store.remove(0, 1);
std::cout << "Curstomer -> "<< g_store.toStdString() << std::endl;
}

g_mutex.unlock();
msleep(1000);
}
}
};

在主函数中分别定义两个线程类,并依次运行它们;

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

Producer p;
Customer c;

p.setObjectName("producer");
c.setObjectName("curstomer");

p.start();
c.start();

return a.exec();
}

至此,生产者产生数据,消费者消费数据;如下图所示;

QMutexLocker 是Qt框架中提供的一个辅助类,它是在QMutex基础上简化版的线程锁,QMutexLocker会保护加锁区域,并自动实现互斥量的锁定和解锁操作,可以将其理解为是智能版的QMutex锁,通过 QMutexLocker可以确保在作用域内始终持有锁,从而避免因为忘记释放锁而导致的问题。该锁只需要在上方代码中稍加修改即可。

使用 QMutexLocker 的一般流程如下:

  1. 创建一个 QMutex 对象。
  2. 创建一个 QMutexLocker 对象,传入需要锁定的 QMutex
  3. QMutexLocker 对象的作用域内进行需要互斥访问的操作。
  4. QMutexLocker 对象超出作用域范围时,会自动释放锁。
static QMutex g_mutex;      // 线程锁
static QString g_store; // 定义全局变量

class Producer : public QThread
{
protected:
void run()
{
int count = 0;

while(true)
{
// 增加智能线程锁
QMutexLocker Locker(&g_mutex);

g_store.append(QString::number((count++) % 10));
std::cout << "Producer -> "<< g_store.toStdString() << std::endl;

msleep(900);
}
}
};

1.4 读写同步线程锁

QReadWriteLock 是Qt框架中提供的用于实现读写锁的类。读写锁允许多个线程同时读取共享数据,但在写入数据时会互斥,确保数据的一致性和完整性。这对于大多数情况下读取频繁而写入较少的共享数据非常有用,可以提高程序的性能。

其提供了两种锁定操作:

  • 读取锁(Read Lock): 允许多个线程同时获取读取锁,用于并行读取共享数据。在没有写入锁的情况下,多个线程可以同时持有读取锁。
  • 写入锁(Write Lock): 写入锁是互斥的,当一个线程获取写入锁时,其他线程无法获取读取锁或写入锁。这确保了在写入数据时,不会有其他线程同时读取或写入。

互斥锁存在一个问题,每次只能有一个线程获得互斥量的权限,如果在程序中有多个线程来同时读取某个变量,那么使用互斥量必须排队,效率上会大打折扣,基于QReadWriteLock读写模式进行代码段锁定,即可解决互斥锁存在的问题。

#include <QCoreApplication>
#include <iostream>
#include <QThread>
#include <QMutex>
#include <QReadWriteLock>

static QReadWriteLock g_mutex; // 线程锁
static QString g_store; // 定义全局变量

class Producer : public QThread
{
protected:
void run()
{
int count = 0;

while(true)
{
// 以写入方式锁定资源
g_mutex.lockForWrite();

g_store.append(QString::number((count++) % 10));

// 写入后解锁资源
g_mutex.unlock();

msleep(900);
}
}
};

class Customer : public QThread
{
protected:
void run()
{
while( true )
{
// 以读取方式写入资源
g_mutex.lockForRead();
if( g_store != "" )
{
std::cout << "Curstomer -> "<< g_store.toStdString() << std::endl;
}

// 读取到后解锁资源
g_mutex.unlock();
msleep(1000);
}
}
};

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

Producer p1,p2;
Customer c1,c2;

p1.setObjectName("producer 1");
p2.setObjectName("producer 2");

c1.setObjectName("curstomer 1");
c2.setObjectName("curstomer 2");

p1.start();
p2.start();

c1.start();
c2.start();

return a.exec();
}

该锁允许用户以同步读lockForRead()或同步写lockForWrite()两种方式实现保护资源,但只要有一个线程在以写的方式操作资源,其他线程也会等待写入操作结束后才可继续读资源。

1.5 基于信号线程锁

QSemaphore 是Qt框架中提供的用于实现信号量的类。信号量是一种用于在线程之间进行同步和通信的机制,它允许多个线程在某个共享资源上进行协调,控制对该资源的访问。QSemaphore 的主要作用是维护一个计数器,线程可以通过获取和释放信号量来改变计数器的值。

其主要方法包括:

  • QSemaphore(int n = 0):构造函数,创建一个初始计数值为 n 的信号量。
  • void acquire(int n = 1):获取信号量,将计数器减去 n。如果计数器不足,线程将阻塞等待。
  • bool tryAcquire(int n = 1):尝试获取信号量,如果计数器足够,立即获取并返回 true;否则返回 false
  • void release(int n = 1):释放信号量,将计数器加上 n。如果有等待的线程,其中一个将被唤醒。

信号量是特殊的线程锁,信号量允许N个线程同时访问临界资源,通过acquire()获取到指定资源,release()释放指定资源。

#include <QCoreApplication>
#include <iostream>
#include <QThread>
#include <QSemaphore>

const int SIZE = 5;
unsigned char g_buff[SIZE] = {0};

QSemaphore g_sem_free(SIZE); // 5个可生产资源
QSemaphore g_sem_used(0); // 0个可消费资源

// 生产者生产产品
class Producer : public QThread
{
protected:
void run()
{
while( true )
{
int value = qrand() % 256;

// 若无法获得可生产资源,阻塞在这里
g_sem_free.acquire();

for(int i=0; i<SIZE; i++)
{
if( !g_buff[i] )
{
g_buff[i] = value;
std::cout << objectName().toStdString() << " --> " << value << std::endl;
break;
}
}

// 可消费资源数+1
g_sem_used.release();

sleep(2);
}
}
};

// 消费者消费产品
class Customer : public QThread
{
protected:
void run()
{
while( true )
{
// 若无法获得可消费资源,阻塞在这里
g_sem_used.acquire();

for(int i=0; i<SIZE; i++)
{
if( g_buff[i] )
{
int value = g_buff[i];

g_buff[i] = 0;
std::cout << objectName().toStdString() << " --> " << value << std::endl;
break;
}
}

// 可生产资源数+1
g_sem_free.release();

sleep(1);
}
}
};

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

Producer p1;
Customer c1;

p1.setObjectName("producer");
c1.setObjectName("curstomer");

p1.start();
c1.start();

return a.exec();
}