OpenHarmony语言基础类库【@ohos.taskpool（启动任务池）】

最新推荐文章于 2024-06-28 14:31:53 发布
最新推荐文章于 2024-06-28 14:31:53 发布
阅读量1.2k 收藏 28
点赞数 12
分类专栏： 鸿蒙 文章标签： harmonyos OpenHarmony 移动开发 鸿蒙开发 鸿蒙 程序员 编程开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/138165196
版权

 任务池（taskpool）作用是为应用程序提供一个多线程的运行环境，降低整体资源的消耗、提高系统的整体性能，且您无需关心线程实例的生命周期。您可以使用任务池API创建后台任务（Task），并对所创建的任务进行如任务执行、任务取消的操作。理论上您可以使用任务池API创建数量不受限制的任务，但是出于内存因素不建议您这样做。此外，不建议您在任务中执行阻塞操作，特别是无限期阻塞操作，长时间的阻塞操作占据工作线程，可能会阻塞其他任务调度，影响您的应用性能。

您所创建的同一优先级任务的执行顺序可以由您决定，任务真实执行的顺序与您调用任务池API提供的任务执行接口顺序一致。任务默认优先级是MEDIUM。（任务优先级机制暂未支持）

当同一时间待执行的任务数量大于任务池工作线程数量，任务池会根据负载均衡机制进行扩容，增加工作线程数量，减少整体等待时长。同样，当执行的任务数量减少，工作线程数量大于执行任务数量，部分工作线程处于空闲状态，任务池会根据负载均衡机制进行缩容，减少工作线程数量。（负载均衡机制暂未支持）

任务池API以数字形式返回错误码。有关各个错误码的更多信息，请参阅文档 鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。。

说明：
本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

搜狗高速浏览器截图20240326151450.png

HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

import taskpool from '@ohos.taskpool';

taskpool.execute

execute(func: Function, ...args: unknown[]): Promise<unknown>

将待执行的函数放入taskpool内部任务队列等待，等待分发到工作线程执行。当前执行模式不可取消任务。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
funcFunction是执行的逻辑需要传入函数，支持的函数返回值类型请查序列化支持类型。
argsunknown[]否执行逻辑的函数所需要的参数，支持的参数类型请查序列化支持类型。默认值为undefined。

返回值：

类型说明
Promise<unknown>execute是异步方法，返回Promise对象。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200003Worker initialization failure.
10200006Serializing an uncaught exception failed.
10200014The function is not mark as concurrent.

示例：

@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

async function taskpoolExecute() {
  let value = await taskpool.execute(printArgs, 100);
  console.log("taskpool result: " + value);
}

taskpoolExecute();

)taskpool.execute

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

将创建好的任务放入taskpool内部任务队列等待，等待分发到工作线程执行。当前执行模式可尝试调用cancel进行任务取消。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
taskTask是需要在任务池中执行的任务。
priorityPriority否等待执行的任务的优先级（暂未支持）。

返回值：

类型说明
Promise<unknown>execute是异步方法，返回Promise对象。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200003Worker initialization failure.
10200006Serializing an uncaught exception failed.
10200014The function is not mark as concurrent.

示例：

@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

async function taskpoolExecute() {
  let task = new taskpool.Task(printArgs, 100);
  let value = await taskpool.execute(task);
  console.log("taskpool result: " + value);
}

taskpoolExecute();

taskpool.cancel

cancel(task: Task): void

取消任务池中的任务。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
taskTask是需要取消执行的任务。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200015If the task is not exist.
10200016If the task is running.

任务取消成功示例：

@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

async function taskpoolCancel() {
  let task = new taskpool.Task(printArgs, 100);
  taskpool.execute(task);
  try {
    taskpool.cancel(task);
  } catch (e) {
    console.log("taskpool.cancel occur error:" + e);
  }
}

taskpoolCancel();

已执行的任务取消失败示例：

@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

async function taskpoolCancel() {
  let task = new taskpool.Task(printArgs, 100);
  let value = taskpool.execute(task);
  let start = new Date().getTime();
  while (new Date().getTime() - start < 1000) { // 延时1s，确保任务已执行
    continue;
  }

  try {
    taskpool.cancel(task); //任务已执行,取消失败
  } catch (e) {
    console.log("taskpool.cancel occur error:" + e);
  }
}

taskpoolCancel();

正在执行的任务取消失败示例：

@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

async function taskpoolCancel() {
  let task1 = new taskpool.Task(printArgs, 100);
  let task2 = new taskpool.Task(printArgs, 200);
  let task3 = new taskpool.Task(printArgs, 300);
  let task4 = new taskpool.Task(printArgs, 400);
  let task5 = new taskpool.Task(printArgs, 500);
  let task6 = new taskpool.Task(printArgs, 600);

  let res1 = taskpool.execute(task1);
  let res2 = taskpool.execute(task2);
  let res3 = taskpool.execute(task3);
  let res4 = taskpool.execute(task4);
  let res5 = taskpool.execute(task5);
  let res6 = taskpool.execute(task6);
  try {
    taskpool.cancel(task1); // task1任务正在执行，取消失败
  } catch (e) {
    console.log("taskpool.cancel occur error:" + e);
  }
}

taskpoolCancel();

Priority

表示所创建任务（Task）的优先级。（暂未支持）

系统能力：  SystemCapability.Utils.Lang

名称值说明
HIGH0任务为高优先级。
MEDIUM1任务为中优先级。
LOW2任务为低优先级。

Task

表示任务。使用以下方法前，需要先构造Task。

constructor

constructor(func: Function, ...args: unknown[])

Task的构造函数。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
funcFunction是任务执行需要传入函数，支持的函数返回值类型请查序列化支持类型。
argsunknown[]否任务执行传入函数的参数，支持的参数类型请查序列化支持类型。默认值为undefined。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200014The function is not mark as concurrent.

示例：

@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

let task = new taskpool.Task(printArgs, "this is my first Task");

属性

系统能力：  SystemCapability.Utils.Lang

名称类型可读可写说明
functionFunction是是创建任务时需要传入的函数，支持的函数返回值类型请查序列化支持类型。
argumentsunknown[]是是创建任务传入函数所需的参数，支持的参数类型请查序列化支持类型。

其他说明

序列化支持类型

序列化支持类型包括：All Primitive Type(不包括symbol)、Date、String、RegExp、Array、Map、Set、Object、ArrayBuffer、TypedArray。

注意事项

  • 仅支持在Stage模型且module的compileMode为esmodule的project中使用taskpool api。确认module的compileMode方法：查看当前module的build-profile.json5，在buildOption中补充"compileMode": "esmodule"。
  • taskpool任务只支持引用入参传递或者import的变量，不支持使用闭包变量，使用装饰器@Concurrent进行拦截。
  • taskpool任务只支持普通函数或者async函数，不支持类成员函数或者匿名函数，使用装饰器@Concurrent进行拦截。
  • 装饰器@Concurrent仅支持在ets文件使用。

简单使用

示例一

// 支持普通函数、引用入参传递
@Concurrent
function printArgs(args) {
    console.log("printArgs: " + args);
    return args;
}

async function taskpoolExecute() {
  // taskpool.execute(task)
  let task = new taskpool.Task(printArgs, "create task, then execute");
  let val1 = await taskpool.execute(task);
  console.log("taskpool.execute(task) result: " + val1);

  // taskpool.execute(function)
  let val2 = await taskpool.execute(func, "execute task by func");
  console.log("taskpool.execute(function) result: " + val2);
}

taskpoolExecute();

示例二

// b.ets
export let c = 2000;
// 引用import变量
// a.ets(与b.ets位于同一目录中)
import { c } from "./b";

@Concurrent
function printArgs(a) {
    console.log(a);
    console.log(c);
    return a;
}

async function taskpoolExecute() {
  // taskpool.execute(task)
  let task = new taskpool.Task(printArgs, "create task, then execute");
  let val1 = await taskpool.execute(task);
  console.log("taskpool.execute(task) result: " + val1);

  // taskpool.execute(function)
  let val2 = await taskpool.execute(printArgs, "execute task by func");
  console.log("taskpool.execute(function) result: " + val2);
}

taskpoolExecute();

示例三

// 支持async函数
@Concurrent
async function delayExcute() {
  let ret = await Promise.all([
    new Promise(resolve => setTimeout(resolve, 1000, "resolved"))
  ]);
  return ret;
}

async function taskpoolExecute() {
  taskpool.execute(delayExcute).then((result) => {
    console.log("TaskPoolTest task result: " + result);
  });
}

taskpoolExecute();

示例四

// c.ets
@Concurrent
function strSort(inPutArr) {
  let newArr = inPutArr.sort();
  return newArr;
}
export async function func1() {
    console.log("taskpoolTest start");
    let strArray = ['c test string', 'b test string', 'a test string'];
    let task = new taskpool.Task(strSort, strArray);
    let result = await taskpool.execute(task);
    console.log("func1 result:" + result);
}

export async function func2() {
    console.log("taskpoolTest2 start");
    let strArray = ['c test string', 'b test string', 'a test string'];
    taskpool.execute(strSort, strArray).then((result) => {
        console.log("func2 result: " + result);
    });
}


// a.ets(与c.ets在同一目录中)
import { taskpoolTest1, taskpoolTest2 } from "./c";

func1();
func2();

鸿蒙Next核心技术分享

1、鸿蒙基础知识←《鸿蒙NEXT星河版开发学习文档》

2、鸿蒙ArkUI←《鸿蒙NEXT星河版开发学习文档》

3、鸿蒙进阶技术←《鸿蒙NEXT星河版开发学习文档》

 4、鸿蒙就业高级技能←《鸿蒙NEXT星河版开发学习文档》 

 5、鸿蒙多媒体技术←《鸿蒙NEXT星河版开发学习文档》 

6、鸿蒙南向驱动开发←《鸿蒙NEXT星河版开发学习文档》  

7、鸿蒙南向内核设备开发←《鸿蒙NEXT星河版开发学习文档》  

 8、鸿蒙系统裁剪与移植←《鸿蒙NEXT星河版开发学习文档》  

爱桥代码的程序媛
关注
专栏目录
HarmonyOS 应用开发之TaskPool和Worker的对比 (TaskPool和Worker)
1
04-01 1366
TaskPool（任务池）和Worker的作用是为应用程序提供一个多线程的运行环境，用于处理耗时的计算任务或其他密集型任务。可以有效地避免这些任务阻塞主线程，从而最大化系统的利用率，降低整体资源消耗，并提高系统的整体性能。本文将从 实现特点 和 适用场景 两个方面来进行TaskPool与Worker的比较。
OpenHarmony实战开发-TaskPool和Worker的对比 (TaskPool和Worker)
m0_70749039的博客
04-14 1218
适用场景对比 TaskPool和Worker均支持多线程并发能力。由于TaskPool的工作线程会绑定系统的调度优先级，并且支持负载均衡（自动扩缩容），而Worker需要开发者自行创建，存在创建耗时以及不支持设置调度优先级，故在性能方面使用TaskPool会优于Worker，因此大多数场景推荐使用TaskPool。 TaskPool偏向独立任务维度，该任务在线程中执行，无需关注线程的生命周期，超长任务（大于3分钟）会被系统自动回收；而Worker偏向线程的维度，支持长时间占据线程执行，需要主动管理线程生
鸿蒙ArkTS实战开发：TaskPool
shudaoshanQAQ的博客
03-30 1821
任务池（TaskPool）作用是为应用程序提供一个多线程的运行环境
一个轻量级的任务执行组件
我是黄大仙
12-09 217
之前做启动优化的时候,把各种任务单独拎出来,做成一个组建,然后根据任务的优先级以及依赖顺序去执行. 源码见:https://github.com/huangbei1990/HDemo 整个模块主要分成以下四个部分. 1.task task设置了四个优先级,具体如下所示,不同优先级的task会有不同的执行逻辑. public enum Priority { Immediately,//放入缓存线程池执行 Normal,//放入线程池执行 Idle,//cpu空闲时执行 Main
OpenHarmony实战开发-如何启动worker线程和taskpool线程。
2401_82546228的博客
04-14 822
本示例通过@ohos.taskpool 和@ohos.worker 接口，展示了如何启动worker线程和taskpool线程。
鸿蒙原生应用开发-ArkTS语言基础类库概述.docx
04-24
### 鸿蒙原生应用开发-ArkTS语言基础类库概述 #### 一、引言 随着HarmonyOS（鸿蒙操作系统）的发展与普及，越来越多的开发者开始关注这一新兴平台上的应用开发技术。ArkTS作为HarmonyOS上的一种新型编程语言框架，...
鸿蒙原生应用开发-ArkTS语言基础类库单次IO.docx
04-24
### 鸿蒙原生应用开发-ArkTS语言基础类库单次IO #### ArkTS语言基础类库介绍 在华为鸿蒙系统中，ArkTS（Ark TypeScript）是一种基于TypeScript的语言扩展，专为HarmonyOS开发而设计，旨在简化跨设备应用的编写过程...
java基础类库文件rt.jar
04-11
Java基础类库，也就是Java doc里面看到的所有的类的class文件。
HarmonyOS实战开发：@ohos.taskpool（启动任务池）
初一十五的博客
04-23 1214
任务池（taskpool）作用是为应用程序提供一个多线程的运行环境，降低整体资源的消耗、提高系统的整体性能，且您无需关心线程实例的生命周期。
Java编程风格及基础类库使用培训.pptx
09-27
Java编程风格及基础类库使用培训.pptx
鸿蒙OpenHarmony多线程能力场景化示例实践
2401_83048197的博客
03-22 1364
在OpenHarmony应用中，每个 进程 都会有一个主线程，主线程主要承担执行UI绘制操作、管理ArkTS引擎实例的创建和销毁、分发和处理事件、管理Ability生命周期等职责，具体可参见 线程模型概述。因此，开发应用时应当尽量避免将耗时的操作放在主线程中执行。ArkTS提供了Worker和TaskPool两种多线程并发能力，多线程并发允许在同一时间段内同时执行多段代码，这两个并发的基本能力可参见 TaskPool和Worker的对比。在介绍Worker和TaskPool。
移动应用高级语言开发——并发探索
OpenHarmony_dev的博客
08-28 271
目前，通过基于共享内存的乐观锁、自旋锁、偏向锁、精准内存屏障等手段可以实现性能优秀的多线程程序，但也存在一定的问题：线程和锁方案的优化依赖软件工程有良好的并发实践规范和资深并发程序开发者，且容易引发死锁，测试及维护的成本也很高。在过去的几十年间，摩尔定律为算力乃至生产力的发展作出了巨大的贡献，但至2022年，随着Denard微缩效应遇到了元件物理的瓶颈，业界逐渐对这一观点产生了强烈的分歧，一部分人士认为摩尔定律正在逐步放缓甚至有失效的倾向，另一部分人士认为摩尔定律仍然有效，仅是成本增加了。
【鸿蒙实战开发】基于Taskpool的多线程操作
最新发布
HarmonyOSMN的博客
06-28 914
周期性任务处理，业务通过taskpool周期性处理业务。：延迟业务处理，业务一段时间后，通过taskpool处理业务。：串行业务处理，业务开展过程中，需要处理一系列的事务，事务处理过程中，存在先后次序。：业务的处理存在紧急优先次序，支持设置taskpool优先级处理。：ArkTS与Native协作开展业务，在ArkTS层触发业务，通过NAPI接口，传递到Native C++层，作业务管理等处理。方案：1)定时器判断周期性事务执行。2)Taskpool来处理任务执行。
HarmonyOS 鸿蒙应用开发( 八、线程模型及线程间通信 Emitter、Worker和TaskPool介绍）
独行猫a 的沉淀、积累、总结。天天学习，好好向上...c/c++,嵌入式 linux,Android,HarmonyOS)
01-27 4962
在HarmonyOS应用中每个进程都会有一个主线程(UI线程)，用于处理UI更新、事件分发等操作。对于耗时任务，开发者需要创建工作线程进行处理，以避免阻塞主线程影响UI流畅性。主线程有如下职责：1.执行UI绘制，主线程负责处理与用户界面相关的所有操作，包括布局计算、渲染以及屏幕刷新等。在鸿蒙系统中，ArkTS引擎用于管理主线程上的UI渲染。2.管理主线程的ArkTS引擎实例，使多个UIAbility组件能够运行在其之上。
鸿蒙ArkTS实战开发：多线程并发 (TaskPool和Worker)
shudaoshanQAQ的博客
03-30 2858
并发模型是用来实现不同应用场景中并发任务的编程模型
OpenHarmony语言基础类库【@ohos.convertxml】
2301_76813281的博客
04-23 1154
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
C#类库查询手册.chm
05-12
个人制作的C#类库查询手册chm版，基于pdf版制作，使用更方便，并进行了简单的排版，更美观。
鸿蒙ArkTS实战开发：I O密集型任务(TaskPool)(2)
2401_84160310的博客
04-12 420
有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了。
HarmonyOS 应用开发之CPU密集型任务开发指导 (TaskPool和Worker)
1
04-01 990
CPU密集型任务是指需要占用系统资源处理大量计算能力的任务，需要长时间运行，这段时间会阻塞线程其它事件的处理，不适宜放在主线程进行。例如图像处理、视频编码、数据分析等。基于多线程并发机制处理CPU密集型任务可以提高CPU利用率，提升应用程序响应速度。当任务不需要长时间（3分钟）占据后台线程，而是一个个独立的任务时，推荐使用TaskPool，反之推荐使用Worker。接下来将以图像直方图处理以及后台长时间的模型预测任务分别进行举例。
【鸿蒙开发】第十五章 ArkTS基础类库-并发
Yvan
03-03 1981
为了提升应用的响应速度与帧率，以及防止耗时任务对主线程的干扰，系统提供了异步并发和多线程并发两种处理策略，ArkTS支持异步并发和多线程并发。并发能力在多种场景中都有应用，其中包括单次I/O任务CPU密集型任务I/O密集型任务和同步任务等。：是指异步代码在执行到一定程度后会被暂停，以便在未来某个时间点继续执行，这种情况下，同一时间只有一段代码在执行。Promise和提供异步并发能力，适用于单次I/O任务的开发场景。详细请参见异步并发概述。：允许在同一时间段内同时执行多段代码。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值