鸿蒙Harmony开发实战:线程异步JS 机制总结

背景介绍

回调函数是 JavaScript 中常见的一种编程模式,它在异步编程中起到了重要作用。在 NAPI (Node.js API)中,回调函数也被广泛应用,用于处理各种异步操作,例如文件读写、网络请求等。按照触发源或目的线程分为 JS 线程、C++ 线程,按照回调方式分为同步回调、异步回调,本文重点介绍 C++ 线程异步回调 JS 的机制。

C++ 异步回调 JS 机制

机制一 Async Work

首先需要进行数据定义,如下所示

接着调用 napi_create_async_work 接口

机制二 Threadsafe Function

JS 函数只能被 JS 主线程调用。如果 native 创建的其他线程需要调用 JS 函数,则需要拿到 JS 主线程的 napi_env 来调用 N-API 函数。

若 native 创建的其他线程必须与 JS 主线程进行通信,线程安全函数 API 提供了 native 创建的其他线程调用 JS 函数的方法。

使用样例

回调函数定义,如下所示

应用调用

使用步骤

线程安全函数的使用步骤是,先 napi_create_threadsafe_function 创建函数引用, napi_call threadsafe_function 通过这个函数引用调用线程安全函数。

机制说明

napi create threadsafe_function 是通过创建 uv _async 实例 &async 并绑定 AsyncCb, 再在其他线程中调用 napi_call_threadsafe_function(tsfn) 后 (tsfn 数据结构包含&async),使用 uv_async_send(&async) 唤醒持有 async 的 JS 主线程消息队列,并调用 async 的回调 AsyncCb->call js_cb()。

注意事项

1.napi_release_threadsafe_function 最后一个参数为 napi_tsfn_abort 时,会立即关闭线程安全函数,导致 JS 主线程无法回调函数;

2.如果创建的线程安全函数的最大队列大小为 0,则 Napi_call_threadsafe_function()永远不会阻塞。

3.napi_call_threadsafe_function()不应该在 JS 线程的 napi_tsfn_blocking 中调用,因为如果队列满了,它可能会导致 JavaScript 线程死锁。

机制三 uv_queue_work

首先需要进行数据定义,如下所示

接着调用 uv_queue_work 接口

相关推荐
SEO_juper4 分钟前
用 Python 写一个 GEO 可见性检查脚本:你的网站现在能被 AI 引用吗
开发语言·人工智能·爬虫·python·seo·外贸独立站
西柚小萌新19 分钟前
【LLM&&AI应用开发 八股文】--4.3.Agent智能体(下)
java·开发语言·数据库
北极有牛21 分钟前
cpp学习笔记--常量指针
java·开发语言·算法
回眸&啤酒鸭22 分钟前
【回眸】OpenSwarm 多智能体协作系统实战指南
大数据·前端·人工智能
用户693717500138431 分钟前
2026,程序员的时代拐点到了
android·前端·后端
大龄秃头程序员34 分钟前
一次 iBeacon + BLE 无感解锁方案的实现记录
前端
半杯咖啡半行码42 分钟前
C++ 编程与 STL 模板:从泛型编程到内存安全详解
开发语言·c++
xq95271 小时前
HDC Assistant 插件横空出世
harmonyos
小兔子1 小时前
Python 的 GIL 与 free-threading:3.13 之后「去 GIL」走到哪一步了
前端
caoerzhong1 小时前
JeeWMS 开源 WMS 部署避坑指南:Java 仓库管理系统的环境基线、四类根因与可复现交付
java·开发语言·开源