} return arg + 1; }
function concurrntFunc() {
let task1: taskpool.Task = new taskpool.Task(inspectStatus, 100); // 100: test number
let task2: taskpool.Task = new taskpool.Task(inspectStatus, 200); // 200: test number
let task3: taskpool.Task = new taskpool.Task(inspectStatus, 300); // 300: test number
let task4: taskpool.Task = new taskpool.Task(inspectStatus, 400); // 400: test number
let task5: taskpool.Task = new taskpool.Task(inspectStatus, 500); // 500: test number
let task6: taskpool.Task = new taskpool.Task(inspectStatus, 600); // 600: test number
taskpool.execute(task1).then((res: Object)=>{
console.info("taskpool test result: " + res);
});
taskpool.execute(task2);
taskpool.execute(task3);
taskpool.execute(task4);
taskpool.execute(task5);
taskpool.execute(task6);
// 1s后取消task
setTimeout(()=>{
try {
taskpool.cancel(task1);
} catch (e) {
console.error(taskpool: cancel error code: ${e.code}, info: ${e.message});
}
}, 1000);
}
concurrntFunc();
taskpool.cancel10+
cancel(group: TaskGroup): void
取消任务池中的任务组。当一个任务组的任务未全部执行结束时取消任务组,返回undefined作为任务组结果。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| group | TaskGroup | 是 | 需要取消执行的任务组。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200018 | The task group does not exist when it is canceled. |
示例:
@Concurrent function printArgs(args: number): number { let t: number = Date.now(); while (Date.now() - t < 2000) { continue; } console.info("printArgs: " + args); return args; }
function concurrntFunc() {
let taskGroup1: taskpool.TaskGroup = new taskpool.TaskGroup();
taskGroup1.addTask(printArgs, 10); // 10: test number
let taskGroup2: taskpool.TaskGroup = new taskpool.TaskGroup();
taskGroup2.addTask(printArgs, 100); // 100: test number
taskpool.execute(taskGroup1).then((res: Array)=>{
console.info("taskGroup1 res is:" + res);
});
taskpool.execute(taskGroup2).then((res: Array)=>{
console.info("taskGroup2 res is:" + res);
});
setTimeout(()=>{
try {
taskpool.cancel(taskGroup2);
} catch (e) {
console.error(taskpool: cancel error code: ${e.code}, info: ${e.message});
}
}, 1000);
}
concurrntFunc();
taskpool.getTaskPoolInfo10+
getTaskPoolInfo(): TaskPoolInfo
获取任务池内部信息,包含线程信息和任务信息。
系统能力: SystemCapability.Utils.Lang
返回值:
| 类型 | 说明 |
|---|---|
| TaskPoolInfo | 任务池的内部信息。 |
示例:
let taskpoolInfo: taskpool.TaskPoolInfo = taskpool.getTaskPoolInfo();
Priority
表示所创建任务(Task)执行时的优先级。
系统能力: SystemCapability.Utils.Lang
| 名称 | 值 | 说明 |
|---|---|---|
| HIGH | 0 | 任务为高优先级。 |
| MEDIUM | 1 | 任务为中优先级。 |
| LOW | 2 | 任务为低优先级。 |
示例:
@Concurrent function printArgs(args: number): number { let t: number = Date.now(); while (Date.now() - t < 1000) { // 1000: delay 1s continue; } console.info("printArgs: " + args); return args; }
let allCount = 100; // 100: test number let taskArray: Array<taskpool.Task> = []; // 创建300个任务并添加至taskArray for (let i: number = 1; i < allCount; i++) { let task1: taskpool.Task = new taskpool.Task(printArgs, i); taskArray.push(task1); let task2: taskpool.Task = new taskpool.Task(printArgs, i * 10); // 10: test number taskArray.push(task2); let task3: taskpool.Task = new taskpool.Task(printArgs, i * 100); // 100: test number taskArray.push(task3); }
// 从taskArray中获取不同的任务并给定不同优先级执行 for (let i: number = 0; i < allCount; i+=3) { // 3: 每次执行3个任务,循环取任务时需后移3项,确保执行的是不同的任务 taskpool.execute(taskArray[i], taskpool.Priority.HIGH); taskpool.execute(taskArray[i + 1], taskpool.Priority.LOW); taskpool.execute(taskArray[i + 2], taskpool.Priority.MEDIUM); }
Task
表示任务。使用constructor方法构造Task。任务可以多次执行或放入任务组执行或放入串行队列执行或添加依赖关系执行。
constructor
constructor(func: Function, ...args: Object[])
Task的构造函数。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| func | Function | 是 | 执行的逻辑需要传入函数,必须使用@Concurrent装饰器装饰,支持的函数返回值类型请查序列化支持类型。 |
| args | Object[] | 否 | 任务执行传入函数的入参,支持的参数类型请查序列化支持类型。默认值为undefined。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200014 | The function is not mark as concurrent. |
示例:
@Concurrent function printArgs(args: number): number { console.info("printArgs: " + args); return args; }
let task: taskpool.Task = new taskpool.Task(printArgs, "this is my first Task");
constructor11+
constructor(name: string, func: Function, ...args: Object[])
Task的构造函数,可以指定任务名称。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 任务名称。 |
| func | Function | 是 | 执行的逻辑需要传入函数,必须使用@Concurrent装饰器装饰,支持的函数返回值类型请查序列化支持类型。 |
| args | Object[] | 否 | 任务执行传入函数的入参,支持的参数类型请查序列化支持类型。默认值为undefined。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200014 | The function is not mark as concurrent. |
示例:
@Concurrent function printArgs(args: string): string { console.info("printArgs: " + args); return args; }
let taskName: string = "taskName"; let task: taskpool.Task = new taskpool.Task(taskName, printArgs, "this is my first Task"); let name: string = task.name;
isCanceled10+
static isCanceled(): boolean
检查当前正在运行的任务是否已取消。使用该方法前需要先构造Task。
系统能力: SystemCapability.Utils.Lang
返回值:
| 类型 | 说明 |
|---|---|
| boolean | 如果当前正在运行的任务被取消返回true,未被取消返回false。 |
示例:
@Concurrent function inspectStatus(arg: number): number { // do something if (taskpool.Task.isCanceled()) { console.info("task has been canceled."); // do something return arg + 1; } // do something return arg; }
说明:
isCanceled方法需要和taskpool.cancel方法搭配使用,如果不调用cancel方法,isCanceled方法默认返回false。
示例:
@Concurrent function inspectStatus(arg: number): number { // 第一次检查任务是否已经取消并作出响应 if (taskpool.Task.isCanceled()) { console.info("task has been canceled before 2s sleep."); return arg + 2; } // 延时2s let t: number = Date.now(); while (Date.now() - t < 2000) { continue; } // 第二次检查任务是否已经取消并作出响应 if (taskpool.Task.isCanceled()) { console.info("task has been canceled after 2s sleep."); return arg + 3; } return arg + 1; }
let task: taskpool.Task = new taskpool.Task(inspectStatus, 100); // 100: test number taskpool.execute(task).then((res: Object)=>{ console.info("taskpool test result: " + res); }).catch((err: string) => { console.error("taskpool test occur error: " + err); }); // 不调用cancel,isCanceled()默认返回false,task执行的结果为101
setTransferList10+
setTransferList(transfer?: ArrayBuffer[]): void
设置任务的传输列表。使用该方法前需要先构造Task。不调用该接口,则传给任务的数据中的ArrayBuffer默认transfer转移。
说明:
此接口可以设置任务池中ArrayBuffer的transfer列表,transfer列表中的ArrayBuffer对象在传输时不会复制buffer内容到工作线程而是转移buffer控制权至工作线程,传输后当前的ArrayBuffer失效。若ArrayBuffer为空,则不会transfer转移。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| transfer | ArrayBuffer[] | 否 | 可传输对象是ArrayBuffer的实例对象,默认为空数组。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200029 | Can not set an arraybuffer to both transferList and cloneList. |
示例:
@Concurrent function testTransfer(arg1: ArrayBuffer, arg2: ArrayBuffer): number { console.info("testTransfer arg1 byteLength: " + arg1.byteLength); console.info("testTransfer arg2 byteLength: " + arg2.byteLength); return 100; }
let buffer: ArrayBuffer = new ArrayBuffer(8); let view: Uint8Array = new Uint8Array(buffer); let buffer1: ArrayBuffer = new ArrayBuffer(16); let view1: Uint8Array = new Uint8Array(buffer1);
console.info("testTransfer view byteLength: " + view.byteLength); console.info("testTransfer view1 byteLength: " + view1.byteLength); // 执行结果为: // testTransfer view byteLength: 8 // testTransfer view1 byteLength: 16
let task: taskpool.Task = new taskpool.Task(testTransfer, view, view1); task.setTransferList([view.buffer, view1.buffer]); taskpool.execute(task).then((res: Object)=>{ console.info("test result: " + res); }).catch((e: string)=>{ console.error("test catch: " + e); }) console.info("testTransfer view2 byteLength: " + view.byteLength); console.info("testTransfer view3 byteLength: " + view1.byteLength); // 经过transfer转移之后值为0,执行结果为: // testTransfer view2 byteLength: 0 // testTransfer view3 byteLength: 0
setCloneList11+
setCloneList(cloneList: Object[] | ArrayBuffer[]): void
设置任务的拷贝列表。使用该方法前需要先构造Task。
说明:
当前仅支持拷贝,@Sendable装饰器需搭配该接口使用,否则会抛异常。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 | |
|---|---|---|---|---|
| cloneList | Object[] | ArrayBuffer[] | 是 | - 传入数组的类型必须为SendableClass或ArrayBuffer。 - 所有传入cloneList的对象持有的SendableClass实例或ArrayBuffer类型对象,在线程间传输的行为都会变成拷贝,即修改传输后的对象不会对原有对象产生任何影响。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200029 | Can not set an arraybuffer to both transferList and cloneList. |
示例:
import taskpool from '@ohos.taskpool' import { BusinessError } from '@ohos.base'
@Sendable class BaseClass { private str: string = "sendable: BaseClass"; static num :number = 10; str1: string = "sendable: this is BaseClass's string"; num1: number = 5; isDone1: boolean = false;
private fibonacciRecursive(n: number): number { if (n <= 1) { return n; } else { return this.fibonacciRecursive(n - 1) + this.fibonacciRecursive(n - 2); } }
private privateFunc(num: number): number{ let res: number = this.fibonacciRecursive(num); console.info("sendable: BaseClass privateFunc res is: " + res); return res; }
publicFunc(num: number): number { return this.privateFunc(num); }
get GetNum(): number { return this.num1; } set SetNum(num: number) { this.num1 = num; }
constructor(){ console.info(this.str); this.isDone1 = true; } }
@Sendable class DeriveClass extends BaseClass { name: string = "sendable: this is DeriveClass"; printName() { console.info(this.name); } constructor() { super(); } }
@Concurrent function testFunc(arr: Array, num: number): number { let baseInstance1 = arr[0]; console.info("sendable: str1 is: " + baseInstance1.str1); baseInstance1.SetNum = 100; console.info("sendable: num1 is: " + baseInstance1.GetNum); console.info("sendable: isDone1 is: " + baseInstance1.isDone1); // 获取斐波那契数列第num项的结果 let res: number = baseInstance1.publicFunc(num); return res; }
@Concurrent function printLog(arr: Array): void { let deriveInstance = arr[0]; deriveInstance.printName(); }
@Entry @Component struct Index { @State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
Button() {
Text("TaskPool Test")
}.onClick(() => {
// task1访问调用BaseClass.str1/BaseClass.SetNum/BaseClass.GetNum/BaseClass.isDone1/BaseClass.publicFunc
let baseInstance1: BaseClass = new BaseClass();
let array1 = new Array();
array1.push(baseInstance1);
let task1 = new taskpool.Task(testFunc, array1, 10);
task1.setCloneList(array1);
taskpool.execute(task1).then((res: Object) => {
console.info("sendable: task1 res is: " + res);
}).catch((e:BusinessError) => {
console.error(sendable: task1 execute Code is ${e.code}, message is ${e.message});
})
// task2调用DeriveClass.printName
let deriveInstance: DeriveClass = new DeriveClass();
let array2 = new Array();
array2.push(deriveInstance);
let task2 = new taskpool.Task(printLog, array2);
task2.setCloneList(array2);
taskpool.execute(task2).then(() => {
console.info("sendable: task2 execute success");
}).catch((e:BusinessError) => {
console.error(sendable: task2 execute Code is ${e.code}, message is ${e.message});
})
})
.height('15%')
.width('30%')
}
.width('100%')
}
.height('100%')
}
}
sendData11+
static sendData(...args: Object[]): void
在任务执行过程中向宿主线程发送消息并触发回调。使用该方法前需要先构造Task。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| args | Object[] | 是 | 可传输对象默认转移,作为回调函数的参数,支持的参数类型请查序列化支持类型。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200006 | An exception occurred during serialization. |
| 10200022 | The function is not called in the taskpool thread. |
| 10200023 | The function is not called in the concurrent function. |
| 10200024 | The callback is not registered on the host side. |
示例:
@Concurrent function ConcurrentFunc(num: number): number { let res: number = num * 10; taskpool.Task.sendData(res); return num; }
onReceiveData11+
onReceiveData(callback?: Function): void
为任务注册回调函数,以接收和处理来自任务池工作线程的数据。使用该方法前需要先构造Task。
说明:
不支持给同一个任务定义多种回调函数,如果重复赋值只有最后一个会生效。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callback | Function | 否 | 处理数据的回调函数,发送到宿主线程的数据将会作为入参传入该回调函数。不传参可以取消注册的回调函数。 |
示例:
@Concurrent function ConcurrentFunc(num: number): number { let res: number = num * 10; taskpool.Task.sendData(res); return num; }
function pringLog(data: number): void { console.info("taskpool: data is: " + data); }
async function testFunc(): Promise {
try {
let task: taskpool.Task = new taskpool.Task(ConcurrentFunc, 1);
task.onReceiveData(pringLog);
await taskpool.execute(task);
} catch (e) {
console.error(taskpool: error code: ${e.code}, info: ${e.message});
}
}
testFunc();
addDependency11+
addDependency(...tasks: Task[]): void
为当前任务添加对其他任务的依赖。使用该方法前需要先构造Task。该任务和被依赖的任务不可以是任务组任务、串行队列任务和已执行的任务。存在依赖关系的任务(依赖其他任务的任务或被依赖的任务)执行后不可以再次执行。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tasks | Task[] | 是 | 被依赖的任务数组。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200026 | There is a circular dependency. |
示例:
@Concurrent function delay(args: number): number { let t: number = Date.now(); while ((Date.now() - t) < 1000) { continue; } return args; }
let task1:taskpool.Task = new taskpool.Task(delay, 100); let task2:taskpool.Task = new taskpool.Task(delay, 200); let task3:taskpool.Task = new taskpool.Task(delay, 200);
console.info("dependency: add dependency start"); task1.addDependency(task2); task2.addDependency(task3); console.info("dependency: add dependency end");
console.info("dependency: start execute second") taskpool.execute(task1).then(() => { console.info("dependency: second task1 success"); }) taskpool.execute(task2).then(() => { console.info("dependency: second task2 success"); }) taskpool.execute(task3).then(() => { console.info("dependency: second task3 success"); })
removeDependency11+
removeDependency(...tasks: Task[]): void
删除当前任务对其他任务的依赖。使用该方法前需要先构造Task。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tasks | Task[] | 是 | 被依赖的任务数组。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200027 | The dependency does not exist. |
示例:
@Concurrent function delay(args: number): number { let t: number = Date.now(); while ((Date.now() - t) < 1000) { continue; } return args; }
let task1:taskpool.Task = new taskpool.Task(delay, 100); let task2:taskpool.Task = new taskpool.Task(delay, 200); let task3:taskpool.Task = new taskpool.Task(delay, 200);
console.info("dependency: add dependency start"); task1.addDependency(task2); task2.addDependency(task3); console.info("dependency: add dependency end"); console.info("dependency: remove dependency start"); task1.removeDependency(task2); task2.removeDependency(task3); console.info("dependency: remove dependency end");
console.info("dependency: start execute") taskpool.execute(task1).then(() => { console.info("dependency: task1 success"); }) taskpool.execute(task2).then(() => { console.info("dependency: task2 success"); }) taskpool.execute(task3).then(() => { console.info("dependency: task3 success"); })
属性
系统能力: SystemCapability.Utils.Lang
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| function | Function | 是 | 是 | 创建任务时需要传入的函数,支持的函数返回值类型请查序列化支持类型。 |
| arguments | Object[] | 是 | 是 | 创建任务传入函数所需的参数,支持的参数类型请查序列化支持类型。 |
| name11+ | string | 是 | 否 | 创建任务时指定的任务名称。 |
| totalDuration11+ | number | 是 | 否 | 执行任务总耗时。 |
| ioDuration11+ | number | 是 | 否 | 执行任务异步IO耗时。 |
| cpuDuration11+ | number | 是 | 否 | 执行任务CPU耗时。 |
TaskGroup10+
表示任务组,一次执行一组任务,适用于执行一组有关联的任务。如果所有任务正常执行,异步执行完毕后返回所有任务结果的数组,数组中元素的顺序与addTask的顺序相同;如果任意任务失败,则会抛出对应异常。任务组可以多次执行,但执行后不能新增任务。使用constructor方法构造TaskGroup。
constructor10+
constructor()
TaskGroup的构造函数。
系统能力: SystemCapability.Utils.Lang
示例:
let taskGroup = new taskpool.TaskGroup();
constructor11+
constructor(name: string)
TaskGroup的构造函数,可以指定任务组名称。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 任务组名称。 |
示例:
let taskGroupName: string = "groupName"; let taskGroup: taskpool.TaskGroup = new taskpool.TaskGroup(taskGroupName); let name: string = taskGroup.name;
addTask10+
addTask(func: Function, ...args: Object[]): void
将待执行的函数添加到任务组中。使用该方法前需要先构造TaskGroup。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| func | Function | 是 | 执行的逻辑需要传入函数,必须使用@Concurrent装饰器装饰,支持的函数返回值类型请查序列化支持类型。 |
| args | Object[] | 否 | 任务执行函数所需要的入参,支持的参数类型请查序列化支持类型。默认值为undefined。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200014 | The function is not mark as concurrent. |
示例:
@Concurrent function printArgs(args: number): number { console.info("printArgs: " + args); return args; }
let taskGroup: taskpool.TaskGroup = new taskpool.TaskGroup(); taskGroup.addTask(printArgs, 100); // 100: test number
addTask10+
addTask(task: Task): void
将创建好的任务添加到任务组中。使用该方法前需要先构造TaskGroup。任务组不可以添加其他任务组任务、串行队列任务、有依赖关系的任务和已执行的任务。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | Task | 是 | 需要添加到任务组中的任务。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200014 | The function is not mark as concurrent. |
示例:
@Concurrent function printArgs(args: number): number { console.info("printArgs: " + args); return args; }
let taskGroup: taskpool.TaskGroup = new taskpool.TaskGroup(); let task: taskpool.Task = new taskpool.Task(printArgs, 200); // 200: test number taskGroup.addTask(task);
属性
系统能力: SystemCapability.Utils.Lang
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| name11+ | string | 是 | 是 | 创建任务组时指定的任务组名称。 |
SequenceRunner 11+
表示串行队列的任务,用于执行一组需要串行执行的任务。使用constructor方法构造SequenceRunner。
constructor11+
constructor(priority?: Priority)
SequenceRunner的构造函数。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| priority | Priority | 否 | 指定任务的优先级,该参数默认值为taskpool.Priority.MEDIUM。 |
示例:
let runner: taskpool.SequenceRunner = new taskpool.SequenceRunner();
execute11+
execute(task: Task): Promise
执行串行任务。使用该方法前需要先构造SequenceRunner。串行队列不可以执行任务组任务、其他串行队列任务、有依赖关系的任务和已执行的任务。
说明:
不支持加入存在依赖的任务。
前面的任务执行失败或取消不影响后续任务执行。
系统能力: SystemCapability.Utils.Lang
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | Task | 是 | 需要添加到串行任务队列中的任务。 |
返回值:
| 类型 | 说明 |
|---|---|
| Promise | Promise对象,返回任务执行的结果。 |
错误码:
以下错误码的详细介绍请参见语言基础类库错误码。
| 错误码ID | 错误信息 |
|---|---|
| 10200003 | Worker initialization failure. |
| 10200006 | An exception occurred during serialization. |
| 10200025 | Add dependent task to SequenceRunner. |
示例:
@Concurrent function additionDelay(delay:number): void { let start: number = new Date().getTime(); while (new Date().getTime() - start < delay) { continue; } } @Concurrent function waitForRunner(finalString: string): string { return finalString; } async function seqRunner() { let finalString:string = ""; let task1:taskpool.Task = new taskpool.Task(additionDelay, 3000); let task2:taskpool.Task = new taskpool.Task(additionDelay, 2000); let task3:taskpool.Task = new taskpool.Task(additionDelay, 1000); let task4:taskpool.Task = new taskpool.Task(waitForRunner, finalString);
let runner:taskpool.SequenceRunner = new taskpool.SequenceRunner(); runner.execute(task1).then(() => { finalString += 'a'; console.info("seqrunner: task1 done."); }); runner.execute(task2).then(() => { finalString += 'b'; console.info("seqrunner: task2 done"); }); runner.execute(task3).then(() => { finalString += 'c'; console.info("seqrunner: task3 done"); }); await runner.execute(task4); console.info("seqrunner: task4 done, finalString is " + finalString); }
State10+
表示任务(Task)状态的枚举。当任务创建成功后,调用execute,任务进入taskpool等待队列,状态设置为WAITING;任务从等待队列出来进入taskpool工作线程中,任务状态更新为RUNNING;当任务执行完成,返回结果后任务状态重置为WAITING;当主动cancel任务时,将任务状态更新为CANCELED。
系统能力: SystemCapability.Utils.Lang
| 名称 | 值 | 说明 |
|---|---|---|
| WAITING | 1 | 任务正在等待。 |
| RUNNING | 2 | 任务正在执行。 |
| CANCELED | 3 | 任务已被取消。 |
TaskInfo10+
任务的内部信息。
系统能力: SystemCapability.Utils.Lang
属性
系统能力: SystemCapability.Utils.Lang
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| name12+ | string | 是 | 否 | 任务的名字。 |
| taskId | number | 是 | 否 | 任务的ID。 |
| state | State | 是 | 否 | 任务的状态。 |
| duration | number | 是 | 否 | 任务执行至当前所用的时间,单位为ms。当返回为0时,表示任务未执行;返回为空时,表示没有任务执行。 |
ThreadInfo10+
工作线程的内部信息。
系统能力: SystemCapability.Utils.Lang
属性
系统能力: SystemCapability.Utils.Lang
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| tid | number | 是 | 否 | 工作线程的标识符。返回为空时,代表没有任务执行。 |
| taskIds | number[] | 是 | 否 | 在当前线程上运行的任务id列表。返回为空时,代表没有任务执行。 |
| priority | Priority | 是 | 否 | 当前线程的优先级。返回为空时,代表没有任务执行。 |
TaskPoolInfo10+
任务池的内部信息。
系统能力: SystemCapability.Utils.Lang
属性
系统能力: SystemCapability.Utils.Lang
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| threadInfos | ThreadInfo[] | 是 | 否 | 工作线程的内部信息。 |
| taskInfos | TaskInfo[] | 是 | 否 | 任务的内部信息。 |
其他说明
序列化支持类型
序列化支持类型包括:All Primitive Type(不包括symbol)、Date、String、RegExp、Array、Map、Set、Object、ArrayBuffer、TypedArray。详情可见TaskPool和Worker支持的序列化类型。
简单使用
示例一
// 支持普通函数、引用入参传递 @Concurrent function printArgs(args: number): number { console.info("func: " + args); return args; } async function taskpoolExecute(): Promise { // taskpool.execute(task) let task: taskpool.Task = new taskpool.Task(printArgs, "create task, then execute"); console.info("taskpool.execute(task) result: " + await taskpool.execute(task)); // taskpool.execute(function) console.info("taskpool.execute(function) result: " + await taskpool.execute(printArgs, "execute task by func")); } taskpoolExecute();
示例二
// b.ets export let c: string = "hello";
// 引用import变量 // a.ets(与b.ets位于同一目录中) import { c } from "./b";
@Concurrent function printArgs(a: string): string { console.info(a); console.info(c); return a; }
async function taskpoolExecute(): Promise { // taskpool.execute(task) let task: taskpool.Task = new taskpool.Task(printArgs, "create task, then execute"); console.info("taskpool.execute(task) result: " + await taskpool.execute(task));
// taskpool.execute(function) console.info("taskpool.execute(function) result: " + await taskpool.execute(printArgs, "execute task by func")); }
taskpoolExecute();
示例三
// 支持async函数 @Concurrent async function delayExcute(): Promise { let ret = await Promise.all([ new Promise(resolve => setTimeout(resolve, 1000, "resolved")) ]); return ret; }
async function taskpoolExecute(): Promise { taskpool.execute(delayExcute).then((result: Object) => { console.info("taskPoolTest task result: " + result); }).catch((err: string) => { console.error("taskpool test occur error: " + err); }); }
taskpoolExecute();
示例四
// c.ets import taskpool from '@ohos.taskpool';
@Concurrent function strSort(inPutArr: Array): Array { let newArr = inPutArr.sort(); return newArr; } export async function func1(): Promise { console.info("taskpoolTest start"); let strArray: Array = ['c test string', 'b test string', 'a test string']; let task: taskpool.Task = new taskpool.Task(strSort, strArray); console.info("func1 result:" + await taskpool.execute(task)); }
export async function func2(): Promise { console.info("taskpoolTest2 start"); let strArray: Array = ['c test string', 'b test string', 'a test string']; taskpool.execute(strSort, strArray).then((result: Object) => { console.info("func2 result: " + result); }).catch((err: string) => { console.error("taskpool test occur error: " + err); }); }
// index.ets import { func1, func2 } from "./c";
func1(); func2();
示例五
// 任务取消成功 @Concurrent function inspectStatus(arg: number): number { // 第一次检查任务是否已经取消并作出响应 if (taskpool.Task.isCanceled()) { console.info("task has been canceled before 2s sleep."); return arg + 2; } // 2s sleep let t: number = Date.now(); while (Date.now() - t < 2000) { continue; } // 第二次检查任务是否已经取消并作出响应 if (taskpool.Task.isCanceled()) { console.info("task has been canceled after 2s sleep."); return arg + 3; } return arg + 1; }
async function taskpoolCancel(): Promise {
let task: taskpool.Task = new taskpool.Task(inspectStatus, 100); // 100: test number
taskpool.execute(task).then((res: Object)=>{
console.info("taskpool test result: " + res);
}).catch((err: string) => {
console.error("taskpool test occur error: " + err);
});
// 1s后取消task
setTimeout(()=>{
try {
taskpool.cancel(task);
} catch (e) {
console.error(taskpool: cancel error code: ${e.code}, info: ${e.message});
}
}, 1000);
}
taskpoolCancel();
示例六
// 已执行的任务取消失败 @Concurrent function inspectStatus(arg: number): number { // 第一次检查任务是否已经取消并作出响应 if (taskpool.Task.isCanceled()) { return arg + 2; } // 延时2s let t: number = Date.now(); while (Date.now() - t < 500) { continue; } // 第二次检查任务是否已经取消并作出响应 if (taskpool.Task.isCanceled()) { return arg + 3; } return arg + 1; }
async function taskpoolCancel(): Promise { let task: taskpool.Task = new taskpool.Task(inspectStatus, 100); // 100: test number taskpool.execute(task).then((res: Object)=>{ console.info("taskpool test result: " + res); }).catch((err: string) => { console.error("taskpool test occur error: " + err); });
setTimeout(()=>{
try {
taskpool.cancel(task); // 任务已执行,取消失败
} catch (e) {
console.error(taskpool: cancel error code: ${e.code}, info: ${e.message});
}
}, 3000); // 延时3s,确保任务已执行
}
taskpoolCancel();
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!