JS UI框架下FA与PA是如何交互的 原创 精华

鸿蒙开发者社区官方账号
发布于 2021-7-8 10:38
浏览
7收藏

上一篇“HarmonyOS UI框架关键技术解析”中,给大家介绍了基于JS/JAVA UI框架开发简单业务的方法。那么对于复杂业务,在当前HarmonyOS版本下,如何基于JS UI框架来开发呢?

JS UI框架下FA与PA交互的使用场景

通常一个典型使用JS UI框架的HarmonyOS应用开发模型如下图1所示:

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

::: hljs-center

图1 典型应用开发模型

:::

HarmonyOS的用户应用程序包APP由一个或多个Hap包组成。每个Hap可以包含一个或多个Ability。Ability分为两种类型:Feature Ability(简称FA)和Particle Ability(简称PA),FA和PA是HarmonyOS应用的基本组成单元,能够实现特定的业务功能。FA有UI界面,而PA无UI界面。FA有多种展现形式,如普通界面形式Page Ability,服务卡片形式Form等,一般使用JS 语言实现前台界面。PA支持ServiceAbility和Data Ability。ServiceAbility提供后台运行任务的能力,如处理复杂后台任务等。Data Ability用于对外部提供统一的数据访问抽象。这两个Ability一般使用Java 语言实现。

当前HarmonyOS Ability具体分类信息如下:

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

JS UI框架提供的声明式编程,使应用开发更加简单,但当前HarmonyOS JS API还不够丰富,无法处理数据等更复杂的业务。为了达到处理复杂业务,同时保证业务数据和UI的解耦,一般会将复杂逻辑放到PA中即JAVA端实现,而界面交互则放到FA中的UI部分即JS端实现,如图1所示。

这就涉及到FA(JS端)与PA(JAVA端)的交互,为此,Harmony OS JS UI框架提供了JS FA(Feature Ability)调用JAVA PA(Particle Ability)的机制,该机制提供了一种通道来传递方法调用、处理数据返回以及订阅事件上报。

下面我们通过一两个例子来解释该方法涉及的技术原理。

HarmonyOS下FA调用PA机制

接口拓展机制

为支持ACE开发框架一次开发,跨平台运行的目标,采用了接口拓展机制打通前端应用层和后端平台层。JS UI框架提供了一种自动封装平台能力扩展API的机制,让应用开发者轻松调用API即能完成JS端到JAVA端的传递方法调用、处理数据返回以及订阅事件上报。

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

::: hljs-center

图2 模块框架模型

:::

如图2所示,当前HarmonyOS支持JS作为前端应用开发语言,提供API接口,供开发者实现业务逻辑,通过类似接口拓展机制将JS层的参数传递到平台层(Native),同时在平台层提供插件代码(Plugin Native code)供三方平台实现业务逻辑。

◆ JS FrameWork

提供API用于传递方法调用,数据流通信,以及订阅事件回调。并通过JsBridge桥接起C++ 与JS,JsBridge主要负责加载JS代码,运行在QJS Engine上,将JS代码通过全局函数桥接到C++ 上,并将C++的结果返回给JS层。

◆ QJS Engine

QuickJS 是一个轻量且可嵌入的 JavaScript 引擎,包括模块、异步生成器和代理。

◆ ACE Framework

将JS的消息往平台层透传,将JS数据转换成C++ 类型的数据,再通过C++ 与JAVA的JNI接口类,将C++的数据传递到JAVA侧,并接收JAVA侧返回的数据。

◆ Native

负责平台层数据编解码,并根据解码后得到的FunctionName调用第三方开发者的插件代码逻辑。

◆ HarmonyOS API

平台层提供JAVA端API接口。开发者实现JAVA端对应接口的业务逻辑。

HarmonyOS下FA调用PA机制

JS UI框架当前提供了Ability和Internal Ability两种FA调用PA的方式:

● Ability调用方式:拥有独立的Ability生命周期,FA使用远端进程通信拉起并请求PA服务,适用于基本服务PA有多个FA调用或者PA在后台独立运行的场景。

● Internal Ability调用方式:PA与FA共进程,PA和FA采用内部函数调用的方式进行通信,适用于对服务响应时延要求较高的场景。该方式下PA不支持其他FA访问调用。

这两种调用方式在代码中可通过abilityType来标识,具体使用差异见下表:

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

FA调用PA注意事项:

● JS和JAVA侧定义好的“方法调用”在对外开放后,需要保证前向兼容性。

● 序列化数据默认最大支持200KB数据量,若需要传输大数据,可以使用对应接口ohos.utils.Parcel.setCapacity()调整buffer容量大小。

FA调用PA开发方法

下面来给大家详细介绍JS FA调用JAVA PA的开发方法。

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

::: hljs-center

图3 FA调用PA开发方法

:::

如图3所示,当FeatureAbility Plugin收到JS调用请求后,系统根据开发者在JS接口中设置的参数如指定的abilityType(Ability或Internal Ability),来选择对应的方式进行处理。开发者在onRemoteRequest()中实现PA提供的业务逻辑,不同的业务通过业务码来区分。

◆ FA端

1.Channel JS API提供以下模块能力:

● ModuleGroup

用于传递方法调用的类,通常用于上层应用者调用native中的某个方法而定义使用。调用callNative()方法即可将function以及对应的参数传递到平台层,需要在Native层也适配相应的逻辑代码。

简言之,即ModuleGroup实现JS调用JAVA方法,提供的JS API如下:

√ 调用PA能力,FeatureAbility.callAbility(OBJECT)

● EventGroup

用于数据流通信,通常用于平台层触发的Native事件通知应用层。在应用层调用subscribe()方法注册回调事件启动监听平台,调用unSubscribe()取消平台监听。第三方开发者在平台层需要适配相应的逻辑代码。

简言之,即EventGroup实现JAVA回调JS,提供的JS API如下:

√ 订阅PA能力,FeatureAbility.subscribeAbilityEvent(OBJECT, Function)

√ 取消订阅PA能力,FeatureAbility.unsubscribeAbilityEvent(OBJECT)

2.FeatureAbility Plugin

主要完成方法调用、数据流的参数传递(编解码)、线程切换、JNI转换等处理。

其主要提供以下2个重点模块:

● Internal Ability Manager

用于Internal Ability的管理,包括注册管理等,注册后的Internal Ability与FA共生命周期。

● Connection Manager

JS端与JAVA端通过接口扩展机制进行通信,通过bundleName和abilityName来进行关联。

◆ PA端

PA端提供以下两类接口:

● IRemoteObject.onRemoteRequest(int, MessageParcel, MessageParcel, MessageOption)

Ability调用方式,FA使用远端进程通信拉起并请求PA服务。

● AceInternalAbility.AceInternalAbilityHandler.onRemoteRequest(int, MessageParcel, MessageParcel, MessageOption)

Internal Ability调用方式,采用内部函数调用的方式和FA进行通信。

Ability调用方式流程

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

::: hljs-center

图4 JS FA调用JAVA PA过程(Ability方式)

:::

1.FA JS端指定PA的调用方式及相关消息码和内容,调用PA(订阅PA类似)。设置bundleName,abilityName,abilityType等。

2.PA JAVA端响应:

通过Ability方式拉起的PA继承自Ability,FA在请求PA服务时会连接到PA,连接成功后,PA在onConnect返回一个remote对象(RemoteObject),用于FA向PA发送消息。remote对象实现onRemoteRequest方法,用于响应FA端的请求。

示例代码如下:e.g.两数求和

◆ FA端 (Ability方式)


// abilityType: 0-Ability; 1-Internal Ability
const ABILITY_TYPE_EXTERNAL = 0;
const ABILITY_TYPE_INTERNAL = 1;
// syncOption(Optional, default sync): 0-Sync; 1-Async
const ACTION_SYNC = 0;
const ACTION_ASYNC = 1;
const ACTION_MESSAGE_CODE_PLUS = 1001;
export default {  
  plus: async function() {    
    var actionData = {};    
    actionData.firstNum = 1024;    
    actionData.secondNum = 2048;
    
    // 请求参数,abilityName、bundleName、messageCode、abilityType、actionData需要求和的2个入参    
    var action = {};    
    action.bundleName = 'com.example.hiaceservice';    
    action.abilityName = 'com.example.hiaceservice.ComputeServiceAbility';    
    action.messageCode = ACTION_MESSAGE_CODE_PLUS;
    action.data = actionData;
    // 使用ability方式    
    action.abilityType = ABILITY_TYPE_EXTERNAL;    
    action.syncOption = ACTION_SYNC;
    
    // FA调用PA    
    var result = await FeatureAbility.callAbility(action);    
    var ret = JSON.parse(result);    
    if (ret.code == 0) {      
      console.info('plus result is:' + JSON.stringify(ret.abilityResult));    
    } else {      
      console.error('plus error code:' + JSON.stringify(ret.code));
    }  
  }
}

◆ PA端(Ability方式)


public class ComputeServiceAbility extends Ability {  
  private MyRemote remote = new MyRemote();  
  // FA在请求PA服务时会连接PA,连接成功后,需要在onConnect返回一个remote对象,供FA向PA发送消息  
  @Override  
  protected IRemoteObject onConnect(Intent intent) {    
    super.onConnect(intent);    
    return remote.asObject();  
  }
  // remote对象的实现,完成消息请求处理,回传  
  class MyRemote extends RemoteObject implements IRemoteBroker {    
    private static final int SUCCESS = 0;    
    private static final int ERROR = 1;    
    private static final int PLUS = 1001;       
    
    MyRemote() {      
      super("MyService_MyRemote");    
    }    
    @Override    
    public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) {      
      switch (code) {
      // 消息码PLUS        
      case PLUS: {
        // 消息参数解析          
        String dataStr = data.readString();          
        RequestParam param = new RequestParam();          
        try {                  
          param = ZSONObject.stringToClass(dataStr, RequestParam.class);          
        } catch (RuntimeException e) {
          HiLog.error(LABEL, "convert failed.");          
        }          
        
        // 返回结果设置          
        Map<String, Object> result = new HashMap<String, Object>();          
        result.put("code", SUCCESS);          
        result.put("abilityResult", param.getFirstNum() + param.getSecondNum());          
        // 返回结果回传          
        reply.writeString(ZSONObject.toZSONString(result));          
        break;        
      }        
      default: {          
        Map<String, Object> result = new HashMap<String, Object>();
        result.put("abilityError", ERROR);          
        reply.writeString(ZSONObject.toZSONString(result));          
        return false;        
      }      
    }      
    return true;    
  }    
  @Override    
  public IRemoteObject asObject() {      
     return this;    
   } 
  }
}

Internal Ability调用方式流程

JS UI框架下FA与PA是如何交互的-鸿蒙开发者社区

::: hljs-center

图5 JS FA调用JAVA PA过程(Internal Ability方式)

:::

1.FA JS端指定PA的调用方式及相关消息码和内容,调用PA(订阅PA类似)。设置bundleName,abilityName,abilityType等。

\2. PA JAVA端响应:

通过Internal Ability方式拉起的PA需要继承自AceInternalAbility,且需要在AceAbility中注册该Internal Ability(AceAbility中执行register方法)。

PA中通过setInternalAbilityHandler方法注册onRemoteRequest方法,用于响应FA端的请求。

示例代码如下:e.g.两数求和

◆ FA端(Internal Ability方式)

和使用ability方式代码类似,区别是需要改变方式类型为Internal Ability:

action.abilityType = ABILITY_TYPE_INTERNAL;

◆ PA端(Internal Ability方式):

//Internal Ability注册:在MainAbility注册
public class MainAbility extends AceAbility {  
  @Override  
  public void onStart(Intent intent) {    
    // 注册, 如果需要在Page初始化(onInit或之前)时调用AceInternalAbility的能力,注册操作需要在super.onStart之前进行    
    ComputeInternalAbility.register(this);    
    ...    
    super.onStart(intent);  
  }  
  @Override   
  public void onStop() {    
    // 注销    
    ComputeInternalAbility.unregister();     
    super.onStop();  
  }
}

在JAVA目录下实现InternalAbility(此处为ComputeInternalAbility)

public class ComputeInternalAbility extends AceInternalAbility {  
  private static final String BUNDLE_NAME = "com.example.hiaceservice";  
  private static final String ABILITY_NAME = "com.example.hiaceservice.ComputeInternalAbility";  
  private static final int SUCCESS = 0;  
  private static final int ERROR = 1;  
  private static final int PLUS = 1001;  
  
  private static ComputeInternalAbility instance;
  private AbilityContext abilityContext;  
  // 如果多个Ability实例都需要注册当前InternalAbility实例,需要更改构造函数,设定自己的bundleName和abilityName  
  public ComputeInternalAbility() {    
    super(BUNDLE_NAME, ABILITY_NAME);  
  }  
  public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) {    
    switch (code) {      
    case PLUS: {        
      String dataStr = data.readString();        
      RequestParam param = new RequestParam();        
      try {                
        param = ZSONObject.stringToClass(dataStr, RequestParam.class);        
      } catch (RuntimeException e) {                
        HiLog.error(LABEL, "convert failed.");        
      }        
      
      // 返回结果当前仅支持String,对于复杂结构可以序列化为ZSON字符串上报        
      Map<String, Object> result = new HashMap<String, Object>();        
      result.put("code", SUCCESS);        
      result.put("abilityResult", param.getFirstNum() + param.getSecondNum());        
      // SYNC        
      if (option.getFlags() == MessageOption.TF_SYNC) {          
        reply.writeString(ZSONObject.toZSONString(result));        
      } else {          
      // ASYNC          
        MessageParcel responseData = MessageParcel.obtain();          
        responseData.writeString(ZSONObject.toZSONString(result));          
        IRemoteObject remoteReply = reply.readRemoteObject();          
        try {            
          remoteReply.sendRequest(0, responseData, MessageParcel.obtain(), new MessageOption());          
        } catch (RemoteException exception) {
          return false;          
        } finally {              
          responseData.reclaim();          
        }        
      }        
      break;      
    }      
    default: {        
      Map<String, Object> result = new HashMap<String, Object>();        
      result.put("abilityError", ERROR);        
      reply.writeString(ZSONObject.toZSONString(result));        
      return false;      
    }    
  }    
  return true;  
}  

/**  * Internal ability 注册接口。  */  
  public static void register(AbilityContext abilityContext) {    
    instance = new ComputeInternalAbility();    
    instance.onRegister(abilityContext);  
  }  
  private void onRegister(AbilityContext abilityContext) {    
    this.abilityContext = abilityContext;    
    this.setInternalAbilityHandler((code, data, reply, option) -> {   
    return this.onRemoteRequest(code, data, reply, option);    
    });  
  }  
/**   * Internal ability 注销接口。   */  
  public static void unregister() {    
    instance.onUnregister();  
  }  
  private void onUnregister() {    
    abilityContext = null;    
    this.setInternalAbilityHandler(null);  
  }
}

以上代码样例只是关键部分,完整代码样例可参考官网资料【JS FA如何调用PA】:

● JS FA如何调用PA

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-js-fa-call-pa-0000001050435961

本文介绍了JS FA(Feature Ability)调用JAVA PA(Particle Ability)的机制和使用场景,基于JS UI框架开发的应用可以使用该机制完成更丰富的功能。未来HarmonyOS会持续丰富完善JS API,为开发者提供更便捷的API能力。

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
分类
已于2021-7-8 10:39:21修改
10
收藏 7
回复
举报
6条回复
按时间正序
/
按时间倒序
红叶亦知秋
红叶亦知秋

值得学习下。

回复
2021-7-8 21:28:48
每天100行
每天100行

支持!

回复
2021-7-11 21:30:37
Der_带鱼
Der_带鱼

插眼!支持!

回复
2021-7-11 23:23:27
爱吃土豆丝的打工人
爱吃土豆丝的打工人

HarmonyOS最终应该是提倡  java+js的开发方式,他们可以进行互通操作,而且在某些方面java处理简单就使用java,有些地方js处理简单就使用js。

1
回复
2021-7-13 08:46:07
鸿联
鸿联

学习!

回复
2021-7-26 21:12:46
XY道衍
XY道衍

大佬,gooooood!

回复
2021-7-28 09:19:31
回复
    相关推荐