1. TaskPool简介

任务池(TaskPool)作用是为应用程序提供一个多线程的运行环境,降低整体资源的消耗、提高系统的整体性能,且您无需关心线程实例的生命周期。

TaskPool支持开发者在主线程封装任务抛给任务队列,系统选择合适的工作线程,进行任务的分发及执行,再将结果返回给主线程。

系统默认会启动一个任务工作线程,当任务较多时会扩容,工作线程数量上限跟当前设备的物理核数相关,具体数量内部管理,保证最优的调度及执行效率,长时间没有任务分发时会缩容,减少工作线程数量。

2.TaskPool注意事项

  • 实现任务的函数需要使用装饰器@Concurrent标注,且仅支持在.ets文件中使用。

  • 任务函数在TaskPool工作线程的执行耗时不能超过3分钟(不包含Promise和async/await异步调用的耗时,例如网络下载、文件读写等I/O任务的耗时),否则会被强制退出。

  • 实现任务的函数入参需满足序列化支持的类型,详情请参见TaskPool和Worker支持的序列化类型。

  • ArrayBuffer参数在TaskPool中默认转移,需要设置转移列表的话可通过接口setTransferList()设置。

  • 由于不同线程中上下文对象是不同的,因此TaskPool工作线程只能使用线程安全的库,例如UI相关的非线程安全库不能使用。

  • 序列化传输的数据量大小限制为16MB。

3.使用场景

由于TaskPool的工作线程会绑定系统的调度优先级,并且支持负载均衡(自动扩缩容),而Worker需要开发者自行创建,存在创建耗时以及不支持设置调度优先级,故在性能方面使用TaskPool会优于Worker,因此大多数场景推荐使用TaskPool

  • 需要设置优先级的任务。例如数据在后台计算,计算完成后的数据,在前台界面需要尽快显示,影响用户体验,需要高优先级处理,需要使用TaskPool。

  • 需要频繁取消的任务。例如大图浏览场景,为提升体验,图片缓存策略,需要使用TaskPool。

  • 大量或者调度分散的任务。例如大型应用的多个模块包含多个耗时任务,推荐采用TaskPool

4.使用限制

TaskPool偏向独立任务维度,该任务在线程中执行,无需关注线程的生命周期,超长任务(大于3分钟)会被系统自动回收。

5.示例

MyTask.ets文件,通过taskpool执行异步任务,读取文件中的内容。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import taskpool from '@ohos.taskpool';


@Concurrent
function readFile(num: number): string {
	return 'hello taskpool '
}


export class MyTask {
	static async handleReadFile(): Promise<string> {
		// 创建Task对象时,传递一个函数引用

		let task = new taskpool.Task(readFile, 2)
		try {
			// 等待 taskpool.execute(task) 解析并获取结果
			let res = await taskpool.execute(task) as string
			console.info(`MyTask handleReadFile ${res}`)
			return res
		} catch (error) {
			// 处理可能出现的错误
			console.error('MyTask execution failed:', error);
			throw error; // 重新抛出错误,或根据需要处理
		}
	}
}

在执行任务时,可以指定任务优先级

1
   function execute(task: Task, priority?: Priority): Promise<unknown>

优先级分为三种

1
2
3
4
5
enum Priority {
    HIGH,
    MEDIUM,
    LOW
}

优先级默认为MEDIUM,如上述代码需要提升任务优先级

1
	let res = await taskpool.execute(task, taskpool.Priority.HIGH) as string

在页面中的调用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

Text('当任务不需要长时间(3分钟)占据后台线程,而是一个个独立的任务时,推荐使用TaskPool,反之推荐使用Worker。')
    .width('80%')

Text(`MyTask.handleReadFile:${this.taskRes}`)
    .width('80%')
    .fontColor(Color.Green)

Button('TaskPool-CPU密集型任务')
    .width('80%')
    .onClick(async () => {
        let res = await MyTask.handleReadFile()
        if (typeof res === 'string') {
            this.taskRes = res
        } else {
            this.taskRes = 'error'
        }
    })

6.效果

image