JSFA调用PA之三Ability调用方式

原创
系统 OpenHarmony
我们借助官方文档的案例来解读一下 Ability 调用方式的具体实现方法。

​想了解更多内容,请访问:​

​51CTO和华为官方合作共建的鸿蒙技术社区​

​https://harmonyos.51cto.com​

引言

  • 【FFH】JSFA调用PA(一)Ability概念及Ability与Internal Ability
  • 【FFH】JSFA调用PA(二) Internal Ability调用方式

上两篇文章我们已经了解到了Ability的概念,还有JS FA调用Java PA两种方式,Ability和Internal Ability的区别,还有第二篇文章对InternalAbility调用方式的讲解。

接下来我们借助官方文档的案例来解读一下 Ability 调用方式的具体实现方法。

在此之前,我们先来看一下一些相关概念。

相关概念

RPC( Remote Procedure Call)

Ability方式中,与FA通过RPC方式通信,先来了解一下什么是RPC,RPC 是 Remote Procedure Call ,翻译过来就是远程过程调用,说白了就是一个机器远程调用并执行另一个机器上的函数。

所以他是个比较宽泛的概念,其中我们经常用到的HTTP协议就属于常见的一种RPC实现方式。

在HarmonyOS有很多地方都用到了RPC方式通信,比如跨设备调用,远程拉起FA,FA的迁移流转等等。

Intent

了解完什么是RPC,那么RPC具体是通过什么让发送方和接收机方知道要干什么的呢?其实就是接下来我们要说的对象之间传递信息的载体—Intent。

开发者的PA首次被FA连接时回调,并返回IRemoteObject对象,用于后续的业务通信。开发者需要继承Ability类并重写onConnect(Intent: intent)方法,其中该方法的参数就是Intent,所以他到底是拿来干嘛的呢?

在HarmonyOS中提供了Intent机制来协助Ability之间的通信,例如,当一个Ability需要启动另一个Ability时,或者一个AbilitySlice需要导航到另一个AbilitySlice时。

Intent是一个将要执行的动作的抽象的描述,在HarmonyOS中由以下元素构成:

用大白话讲,Intent就是作为Ability之间交流的粘合剂,接收方Ability可以从Intent获得到发送方发送了什么请求。

JS FA调用Java PA — Ability调用方式

接下来进入正题。

JS FA端

这部分我们就不细说,因为和InternalAbility的实现方法差不多,只是action.abilityType值不一样,要具体了解就看看上一篇文章吧。

// 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;

var action = {};
action.bundleName = 'com.example.hiaceservice';
action.abilityName = 'com.example.hiaceservice.ComputeServiceAbility';
action.messageCode = ACTION_MESSAGE_CODE_PLUS;
action.data = actionData;
action.abilityType = ABILITY_TYPE_EXTERNAL;
action.syncOption = ACTION_SYNC;

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方式)

这里我们还是以官方文档的案例为参考,我们对官方案例进行一个步骤分解,以方便理解

​https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-fa-calls-pa-examples-0000000000618000​

1.导入相关ohos接口包

// ohos相关接口包
import ohos.aafwk.ability.Ability;
import ohos.aafwk.content.Intent;
import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;
import ohos.rpc.IRemoteBroker;
import ohos.rpc.IRemoteObject;
import ohos.rpc.RemoteObject;
import ohos.rpc.MessageParcel;
import ohos.rpc.MessageOption;
import ohos.utils.zson.ZSONObject;

import java.util.HashMap;
import java.util.Map;

2.创建一个继承Ability的类并且重写onConnect方法

创建完这个类之后,先重写onConnect(Intent: intent)方法,并且在onConnect返回一个remote对象,供FA向PA发送消息。

public class ComputeServiceAbility extends Ability {
// 定义日志标签
private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0, "MY_TAG");

// FA在请求PA服务时会调用Ability.connectAbility连接PA,连接成功后,需要在onConnect返回一个remote对象,供FA向PA发送消息
@Override
protected IRemoteObject onConnect(Intent intent) {
super.onConnect(intent);
return remote.asObject();
}
}

3.继承RemoteObject类重写方法完成业务逻辑

private MyRemote remote = new MyRemote();  
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) {
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());
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;
}
}

完整示例代码请查看官方文档

​https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-fa-calls-pa-examples-0000000000618000​

​想了解更多内容,请访问:​

​51CTO和华为官方合作共建的鸿蒙技术社区​

​https://harmonyos.51cto.com​

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2022-02-17 21:19:35

JSFA操作系统鸿蒙

2022-02-17 21:05:26

AbilityJS FAJava PA

2022-02-24 16:00:59

Ability鸿蒙JS

2021-11-15 15:11:14

鸿蒙HarmonyOS应用

2021-10-27 10:05:55

鸿蒙HarmonyOS应用

2021-09-10 15:13:41

鸿蒙HarmonyOS应用

2022-03-07 14:58:10

ArkUIJS FAJava

2012-08-23 09:56:40

AJAX

2021-12-20 10:07:39

鸿蒙HarmonyOS应用

2012-06-19 13:25:15

Web

2022-07-11 16:26:37

eTS计算鸿蒙

2009-12-22 15:14:33

WCF调用

2024-08-13 08:25:16

C#外部程序方式

2024-05-27 00:20:00

2010-01-21 11:23:58

C++函数调用

2010-01-20 14:25:56

函数调用

2023-10-30 09:35:01

注册中心微服务

2010-03-04 11:07:21

Python解释器

2010-03-04 09:27:34

调用Python脚本

2024-04-19 08:49:50

微服务RPC事件驱动
点赞
收藏

51CTO技术栈公众号