1# 强化线程能力 2 3## 概述 4 5### 简介 6 7线程类提供例如启动线程、同步通知、异步通知等功能的接口 8 9`#include <thread_ex.h>` 10 11## 涉及功能 12 13### 接口说明 14 15### OHOS::Thread 16 17 18|返回值类型 | 名称 | 19| ------------ | ------------------------------------------------------------ | 20| | **Thread**()<br/>构造函数, 构造一个Thread对象，但并不会启动线程。 | 21| | virtual **~Thread**()<br/>析构函数 | 22| ThreadStatus | **Start**(const std::string& name, int32_t priority = THREAD_PROI_NORMAL, size_t stack = 0);<br/>创建并启动一个子线程，循环执行Run()，当Run()返回false或通知退出时停止。 | 23| ThreadStatus | **NotifyExitSync**()<br/>同步通知线程退出,即阻塞式停止子线程。<br/>当前线程被阻塞，等待子线程结束。 | 24| void | virtual **NotifyExitAsync**()<br/>异步通知线程退出，即子线程退出与否不阻塞当前线程。<br/>通知子线程停止，当前线程继续运行。 | 25| bool | virtual **ReadyToWork**()<br/>判断线程是否已经准备就绪，始终返回true。 | 26| bool | **IsExitPending**() const<br/>获取线程退出待定标志位。 | 27| bool | **IsRunning**() const<br/>判断线程是否在运行 | 28| pthread_t | **GetThread**() const<br/>获取线程ID | 29 30 31## 使用示例 32 331. 测试用例编译运行方法 34 35- 测试用例代码参见base/test/unittest/common/utils_thread_test.cpp 36 37- 使用开发者自测试框架，使用方法参见：[开发自测试执行框架-测试用例执行](https://gitee.com/openharmony/testfwk_developer_test#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B%E6%89%A7%E8%A1%8C) 38 39- 使用以下具体命令以运行`thread_ex.h`对应测试用例 40```bash 41run -t UT -tp utils -ts UtilsThreadTest 42``` 43 44## 常见问题 45 46- 主线程对象生命周期终止前，一定要调用NotifyExitSync或NotifyExitAsync终止子线程运行，否则子线程在主线程对象消亡后继续工作，而由于Run函数由主线程对象真正实现，此时主线程对象消亡，Run函数会调用虚基类的纯虚函数而报错。 47 48```cpp 49class RealThread : public Thread { // 使用方继承虚基类并实现Run函数 50 bool Run() override; 51}; 52 53{ 54 std::unique_ptr<RealThread> test = std::make_unique<RealThread>(); 55 ThreadStatus status = test->Start("test_thread_01", THREAD_PROI_LOW, 1024); // 创建并启动子线程对象 56 test->NotifyExitSync(); // 在test对象生命周期结束前，一定要终止子线程的继续运行 57} 58 59``` 60