尧图网站建设 尧图网络
  • 首页
  • 关于我们
  • 服务项目
  • 案例展示
  • 建站流程
  • 资讯中心
  • 联系我们
首页/资讯中心/详情

# 鸿蒙 Web 容器(四):ArkTS 拿到请求后,怎么「按 action 找能力」?

# 鸿蒙 Web 容器(四):ArkTS 拿到请求后,怎么「按 action 找能力」?
📅 发布时间:2026/7/10 19:10:19

鸿蒙 Web 容器(四):ArkTS 拿到请求后,怎么「按 action 找能力」?

这是「ArkWeb / JSBridge」系列的第 4 篇,对应 demo 提交 4:新增BridgeDispatcher按action分发到模拟底座能力。

上一步,ArkTS 已经能收到 H5 发来的BridgeRequest了,但只是「记了一笔」。这一步让它真去干活:根据action找到对应能力、执行、把结果包成统一的BridgeResponse。

一、类比:分发器就是「政务大厅前台」

你去政务大厅办事,不会直接冲进某个科室,而是先到前台说「我要办身份证」。前台按业务名在名册里一查,把你指到对应窗口;窗口办完,给你一张统一格式的回执。

桥的这一层就是这个前台,叫BridgeDispatcher:

  • H5 报一个业务名action(getDeviceInfo/getCurrentTime/openToast);
  • 分发器按 action 找到对应能力实现;
  • 办完,把结果统一包成BridgeResponse(成功/失败一个格式)。
dispatch(req:BridgeRequest):BridgeResponse{try{if(req.action===BridgeAction.GET_DEVICE_INFO)returnok(req.id,biz.getDeviceInfo());if(req.action===BridgeAction.GET_CURRENT_TIME)returnok(req.id,biz.getCurrentTime());if(req.action===BridgeAction.OPEN_TOAST)returnok(req.id,biz.openToast(msg));returnfail(req.id,404,'未知 action: '+req.action);// 名册里没有}catch(e){returnfail(req.id,500,'能力执行出错');// 窗口办砸了}}

这正是小程序的运行机制:H5 写wx.getSystemInfo(),小程序宿主收到后按这个 API 名去找它的底座实现。我们这里把「宿主按 API 名分发」这件事,用BridgeDispatcher亲手复刻了一遍。

二、能力实现:分两层,和 demo 其他切片一样

具体能力没有都堆在分发器里,而是照 demo 一贯的分层拆成 Biz / Imp:

  • NativeAbilityImp(实现层):真去调系统能力。getDeviceInfo读deviceInfo.brand / productModel / osFullName,getCurrentTime读Date。它扮演的就是「ASCF 里 C++/NDK 底座」的角色——前端只认 action,底座具体怎么实现(读系统、调 NDK)归这层。
  • NativeAbilityBiz(业务层):编排 Imp。现在多是透传,但它是预留「参数校验 / 数据加工 / 多能力组合」的地方。
// Imp:真正读底座能力readDeviceInfo():Record<string,string>{return{brand:deviceInfo.brand,model:deviceInfo.productModel,osVersion:deviceInfo.osFullName};}

openToast是「效果」类能力,真弹出需要页面的UIContext,这层拿不到,所以本步先回执一个 mock,下一步在页面层接真实 Toast。

三、为什么「统一返回结构」这么重要?

不管成功、未知 action、还是执行炸了,回的都是同一个形状BridgeResponse { id, code, message, data }:

  • 成功 →code: 0+data;
  • 没这个能力 →code: 404;
  • 执行异常 →code: 500(try/catch兜住,绝不让一个能力的崩溃把整座桥带塌)。

H5 那头就能用一套逻辑处理所有结果:看code判断成败,不用为每个 action 写不同的解析。桥的健壮性,一半靠这个「不管怎样都给一张格式统一的回执」。

四、现在能看到什么

WebBridgeChannel.send在记完请求后,多了一步dispatcher.dispatch(req),并把响应也记进账本。所以页面底部那条日志,状态会从「待处理」翻成「完成」,下面多出一行↩开头的响应 JSON——点「获取设备信息」,你会看到真实的设备品牌/型号被 ArkTS 取出来、包成BridgeResponse记了下来。只差最后一步:把它送回 H5。

一句话总结

分发器像政务大厅前台:H5 报业务名action,它按名册找到对应能力(NativeAbilityImp扮演底座、Biz做编排),办完统一包成BridgeResponse——成功、未知、异常都是同一个形状,try/catch保证一个能力崩了不连累整座桥。这就是小程序「按 API 名分发到底座」的核心。下一步,把这张回执真正回传给 H5,闭环就成了。

相关新闻

  • 2026年新消息:武汉四害消杀服务商综合评估与优选指南 - 品牌鉴赏官2026
  • 数据驱动的神经网络初始化技术解析
  • 医用超声图像模拟系统:模拟病灶算法代码详解

最新新闻

  • 2026河南CPPM线上课程选择指南:正规性与内容核验要点 - 企智芯
  • Neko漫画阅读器终极指南:如何轻松整合Toonily与Weeb Central等多平台资源
  • 3分钟免费解锁WeMod专业版:终极破解工具Wand-Enhancer完整指南
  • 2026重庆欧米茄卡地亚积家手表回收 正规商家高价无套路推荐 - 名奢变现站
  • SUSTechPOINTS:面向自动驾驶的3D点云智能标注平台架构解析与实战应用
  • 成都全域回收点位汇总,合扬箱包回收覆盖主城且支持上门 - 开心测评

日新闻

  • OpenClaw本地化部署:xParse文档解析引擎实战指南
  • 蓝牙 5.4 协议栈深度解析:从 HCI 到 L2CAP 的 7 层数据流
  • PyTorch nn.CrossEntropyLoss 实战:3种权重设置与标签平滑对比(附代码)

周新闻

  • 基于YOLOv12的番茄成熟度智能检测系统开发
  • 终极RimWorld模组管理指南:用RimSort告别模组冲突烦恼
  • AI Agent框架开发:从理论到实践的完整指南

月新闻

  • 2026年6月公司网站搭建最新热门渠道测评:四大低成本/零代码平台对比+避坑
  • 【Linux】Linux arm 编译QT程序,出现expected “}“报错
  • 【MATLAB例程】四基站二维AOA定位与距离辅助增强对比仿真。基于角度观测和测距修正的固定目标平面定位精度分析

关于尧图

  • 公司简介
  • 团队介绍
  • 企业文化
  • 荣誉资质

服务项目

  • 定制开发
  • 电商建站
  • UI 设计
  • 运维服务

快速链接

  • 案例展示
  • 建站流程
  • 常见问题
  • 资讯中心

联系方式

  • 📍北京市朝阳区互联网产业园 A 座 10 层
  • 📞400-888-8888
  • ✉️contact@rkmt.cn
  • 🕐周一至周日 9:00-21:00

© 2024 北京尧图网络科技有限公司 版权所有 | 京 ICP 备 XXXXXXXX 号