成人免费xxxxx在线视频软件_久久精品久久久_亚洲国产精品久久久_天天色天天色_亚洲人成一区_欧美一级欧美三级在线观看

HarmonyOS JS FA調用PA新方式

作者：包月東
開發 OpenHarmony
JS FA調用Java PA一般通過FeatureAbility這種傳統方式調用。本文先回顧傳統方式，在傳統方式的痛點上引入兩種新方式。

[[431269]]

想了解更多內容，請訪問：

51CTO和華為官方合作共建的鴻蒙技術社區

https://harmonyos.51cto.com

簡介

​ JS FA調用Java PA一般通過FeatureAbility這種傳統方式調用。本文先回顧傳統方式，在傳統方式的痛點上引入兩種新方式。

傳統方式

方法說明

常見的JS FA調用Java Pa一般通過以下三個方法

(1) FeatureAbility.callAbility(OBJECT)：調用PA能力。

(2) FeatureAbility.subscribeAbilityEvent(OBJECT, Function)：訂閱PA能力。

(3) FeatureAbility.unsubscribeAbilityEvent(OBJECT)：取消訂閱PA能力。

1.能常用于同步調用方法

比如：

  1. //實現（Java） 
  2. public int add(int a, int b) { 
  3.     return a + b; 
  4. } 
  5.  
  6. //調用： 
  7. add: async function (data) { 
  8.     let params = getRequestAction(ACTION_MESSAGE_CODE_ADD); 
  9.     params.data = data; 
  10.     var ret = await FeatureAbility.callAbility(params) 
  11.     console.log("result:" + JSON.parse(ret) + "," + ret) 
  12.     return JSON.parse(ret) 
  13. } 

2.常用于調用異步方法，因為(2)是通過監聽的方式實現異步回調，所以在不需要監聽時最好調用(3)取消

比如：

  1. //實現（Java） 
  2. public void addAsync(int a, int b, Callback cb) { 
  3.     new Thread(() -> { 
  4.         int ret = a + b;//假設這里是一個耗時操作 
  5.         cb.reply(ret ); 
  6.     }).start(); 
  7. } 
  8.  
  9. //調用（JS）： 
  10. addAsync: async function (data,func) { 
  11.     let params = getRequestAction(ACTION_MESSAGE_CODE_ADDAsync); 
  12.     params.data = data; 
  13.     FeatureAbility.subscribeAbilityEvent(params, (callbackData) => { 
  14.         var callbackJson = JSON.parse(callbackData); 
  15.         //console.log('getAirlineOpenCity is: ' + JSON.stringify(callbackJson.data)); 
  16.         func(callbackJson.data) 
  17.     }) 
  18. }, 

實現步驟

在開發過程中應用中常用Internal Ability，現以Internal Ability說明。

Internal Ability需要實現的步驟：

(1)在java中創建java類繼承AceInternalAbility，設置setInternalAbilityHandler回調，在回調方法onRemoteRequest中通過命令碼code匹配對應的方法名,Parcel中解析方法參數;

(2)在AbilityPackage或者Ability的生命周期對java類對象進行注冊和反注冊;

(3)在JS中創建對應JS類，調用FeatureAbility.callAbility，FeatureAbility.subscribeAbilityEvent傳遞命令碼和方法參數;

痛點

從實現步驟看出，建立Js FA到Java PA的通道，比較繁瑣，以下操作如果能夠由系統自動完成，那么用戶只關注java端方法實現、js端調用，使用就簡便很多。

(1)進行注冊，反注冊;

(2)解析方法名，方法參數;

(3)返回值需要通過parcel進行回傳;

注意點

1.java給js端返回結果(回消息)時，僅支持String。

  1. public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) { 
  2.   switch (code) { 
  3.     case PLUS: { 
  4.       // 返回結果當前僅支持String，對于復雜結構可以序列化為ZSON字符串上報 
  5.       reply.writeString(ZSONObject.toZSONString(result)); 

雖然reply擁有writeInt，writeBoolean等等方法，但目前支持writeString。

2.被調用的java方法運行在非UI線程。

  1. public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) { 
  2.     LogUtil.info(TAG, "isMain:"+(EventRunner.current() == EventRunner.getMainEventRunner())); 

通過在onRemoteRequest處打印當前線程是否UI線程，我們可以得出js調用過來在java代碼處是非UI線程的，如果在此處進行UI操作，就會有一定的風險。

如果存在UI操作，可以context.getUITaskDispatcher().syncDispatch(Runnable)或者new EventHandler(EventRunner.getMainEventRunner()).postTask方式處理。

  1. //方式1：uiTaskDispatcher,需要context 
  2. context.getUITaskDispatcher().syncDispatch(task); 
  3.  
  4. //方式2：EventHandler 
  5. new EventHandler(EventRunner.getMainEventRunner()).postTask(task); 

Parcel的大小是200kb，如果超過200kb(實際沒這么多)，會拋異常，如下：

官網對于Parcel的介紹

  • The default capacity of a Parcel instance is 200KB. If you want more or less, use setCapacity(int) to change it.
  • Note: Only data of the following data types can be written into or read from a Parcel: byte, byteArray, short, shortArray, int, intArray, long, longArray, float, floatArray, double, doubleArray, boolean, booleanArray, char, charArray, String, StringArray, PlainBooleanArray, Serializable, Sequenceable, and SequenceableArray.

解決辦法：增大parcel的容量

  1. if (message.length() > 100 * 1000) { 
  2.     int capacity = (int) (message.length() * 2.1f); 
  3.     boolean setFlag = data.setCapacity(capacity); 
  4.     LogUtil.info(TAG, "SYNC capacity:" + capacity + " " + setFlag); 
  5. } 

4.CallAbility的TF_ASYNC 與Subscribe的區別

雖然兩個看上去都像異步，但是從調用上看CallAbility的TF_ASYNC仍然是同步的，只是沒有使用onRemoteRequest的reply方式進行回傳。

  1. private boolean replyResult(MessageParcel reply, MessageOption option, int code, String data) { 
  2.     if (option.getFlags() == MessageOption.TF_SYNC) { 
  3.         // SYNC 
  4.         if (data.length() > 100 * 1000) { 
  5.             int capacity = (int) (data.length() * 2.1f); 
  6.             boolean setFlag = reply.setCapacity(capacity); 
  7.             LogUtil.info(TAG, "SYNC capacity:" + capacity + " " + setFlag); 
  8.         } 
  9.         reply.writeString(data); 
  10.     } else { 
  11.         // ASYNC 
  12.         MessageParcel responseData = MessageParcel.obtain(); 
  13.         if (data.length() > 100 * 1000) { 
  14.             int capacity = (int) (data.length() * 2.1f); 
  15.             boolean setFlag = responseData.setCapacity(capacity); 
  16.             LogUtil.info(TAG, "ASYNC capacity:" + capacity + " " + setFlag); 
  17.         } 
  18.         responseData.writeString(data); 
  19.         IRemoteObject remoteReply = reply.readRemoteObject(); 
  20.         try { 
  21.             remoteReply.sendRequest(code, responseData, MessageParcel.obtain(), new MessageOption()); 
  22.         } catch (RemoteException exception) { 
  23.             LogUtil.error(TAG, "RemoteException", exception); 
  24.             return false; 
  25.         } finally { 
  26.             responseData.reclaim(); 
  27.         } 
  28.     } 
  29.     return true; 
  30. } 
  31.      
  32.      
  33.   private void replySubscribeMsg(int code, String message) { 
  34.     MessageParcel data = MessageParcel.obtain(); 
  35.     MessageParcel reply = MessageParcel.obtain(); 
  36.     MessageOption option = new MessageOption(); 
  37.     if (message.length() > 100 * 1000) { 
  38.         int capacity = (int) (message.length() * 2.1f); 
  39.         boolean setFlag = data.setCapacity(capacity); 
  40.         LogUtil.info(TAG, "SYNC capacity:" + capacity + " " + setFlag); 
  41.     } 
  42.     data.writeString(message); 
  43.     // 如果僅支持單FA訂閱，可直接觸發回調：remoteObjectHandler.sendRequest(100, data, reply, option); 
  44.     try { 
  45.         remoteObject.sendRequest(code, data, reply, option); 
  46.     } catch (RemoteException e) { 
  47.         e.printStackTrace(); 
  48.     } 
  49.     reply.reclaim(); 
  50.     data.reclaim(); 
  51. } 

新方式一： js2java-codegen

從上面實現java,js通信的步驟可以看出，我們在java端對js傳過來的方法、方法參數進行解析，解析完值后如果有返回值還需要通過Parcel回傳。要是能夠系統自動幫我們實現對方法名，方法參數的解析，那就省去一大部分工作。

正好，鴻蒙推出了js2java-codegen這個注解。

條件

Toolchains的2.2.0.3以上

實現步驟

1.在module下的gradle開啟js2java-codegen。

  1. ohos { 
  2.     ... 
  3.     defaultConfig { 
  4.         .... 
  5.         javaCompileOptions { 
  6.             annotationProcessorOptions { 
  7.                 arguments = ['jsOutputDir': rootDir.path+'./entry/src/main/js/default/generated'] // 方式1設置生成路徑 
  8.                 //arguments = ['jsOutputDir': project.file("src/main/js/default/generated")] //方式2設置路徑 
  9.             } 
  10.         } 
  11.     } 
  12.     compileOptions { 
  13.         f2pautogenEnabled  true // 此處為啟用js2java-codegen工具的開關 
  14.     } 

 注：jsOutputDir的路徑一定要配置好，否則下面的編譯階段會報以下錯誤。

2.編寫提供給js調用的java類。

  1. @InternalAbility(registerTo = "com.freesonwill.facallpa.MainAbility") 
  2. public class JsBridgeX { 
  3.     private static final String TAG = "JsBridgeX"; 
  4.      
  5.     @ContextInject 
  6.     AbilityContext abilityContext; 
  7.  
  8.     public int add(int a, int b) { 
  9.         return a + b; 
  10.     } 

解釋：

1)使用InternalAbility注解java類，注解處理器會根據此類生成對應JsBridgeXStub.java和JsBridgeX.js，這兩個類幫我們建立了通信通道;

2)屬性registerTo設為想要注冊到的Ability類的全稱。因為開發中我們可能用到context相關的方法，比如啟動一個Ability。這里的registerTo和下面的@ContextInject配合使用，使被修飾的abilityContext指向MainAbility;

3.編譯

點擊Build -> Build HAP(s)/APP(s) -> Build HAP(s)，js2java-codegen工具會為我們生成通信通道，JsBridgeXStub.java和JsBridgeX.js。

JsBridgeXStub.java

  1. public class JsBridgeXStub extends AceInternalAbility { 
  2.  public static final String BUNDLE_NAME = "com.freesonwill.facallpa"; 
  3.  
  4.  public static final String ABILITY_NAME = "com.freesonwill.facallpa.JsBridgeXStub"; 
  5. ... 
  6.  
  7.  private AbilityContext abilityContext; 
  8.  
  9.  public JsBridgeXStub() { 
  10.    super(BUNDLE_NAME, ABILITY_NAME); 
  11.  } 
  12.  
  13.  public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, 
  14.      MessageOption option) { 
  15.    Map<String, Object> result = new HashMap<String, Object>(); 
  16.    switch(code) { 
  17.      case OPCODE_add: { 
  18.      java.lang.String zsonStr = data.readString(); 
  19.      ZSONObject zsonObject = ZSONObject.stringToZSON(zsonStr); 
  20.      int a = zsonObject.getObject("a", int.class); //解析add方法第1個參數 
  21.      int b = zsonObject.getObject("b", int.class); //解析add方法第2個參數 
  22.      result.put("code", SUCCESS); 
  23.      result.put("abilityResult", service.add(a, b));//OPCODE_add 對應servcie.add方法 
  24.      break;} 

點開JsBridgeXStub.java，我們看到，在onRemoteRequest這里仍然是方法名，方法參數解析。

JsBridgeX.js

  1.  const BUNDLE_NAME = 'com.freesonwill.facallpa'; 
  2. const ABILITY_NAME = 'com.freesonwill.facallpa.JsBridgeXStub'; 
  3. ... 
  4. const sendRequest = async (opcode, data) => { 
  5.     var action = {}; 
  6.     action.bundleName = BUNDLE_NAME; 
  7.     action.abilityName = ABILITY_NAME; 
  8.     action.messageCode = opcode; 
  9.     action.data = data; 
  10.     action.abilityType = ABILITY_TYPE_INTERNAL; 
  11.     action.syncOption = ACTION_SYNC; 
  12.     return FeatureAbility.callAbility(action);  //仍然是熟悉的FeatureAbility.callAbility方法 
  13. } 
  14. class JsBridgeX { 
  15.     async add(a, b) { 
  16.         if (arguments.length != 2) { 
  17.             throw new Error("Method expected 2 arguments, got " + arguments.length); 
  18.         } 
  19.         let data = {}; 
  20.         data.a = a; 
  21.         data.b = b; 
  22.         const result = await sendRequest(OPCODE_add, data); 
  23.         return JSON.parse(result); 
  24.     } 

我們看到，這里使用了FeatureAbility.callAbility，action的data屬性中包含了要調用的方法名(add)和方法參數(a,b)。

4.使用

  1. import JsBridgeX from '../../generated/JsBridgeX.js'; 
  2. const bridge = new JsBridgeX() 
  3.  
  4. ... 
  5. //使用方式1：promise+then 
  6. bridge.add(a, b).then(ret => { 
  7.     prompt.showToast({ 
  8.         message: `${a}+$ = ${ret.abilityResult}` 
  9.     }) 
  10. }) 
  11. //使用方式2:await 
  12. var ret = await bridge.add(a, b); 
  13. prompt.showToast({ 
  14.     message: `${a}+$ = ${ret.abilityResult}` 
  15. }) 

注意點

1.返回值從abilityResult屬性獲取，如上ret.abilityResult。

  1. prompt.showToast({ 
  2.     message: `${a}+$ = ${ret.abilityResult}` 
  3. }) 

2.只支持同步方法FeatureAbility.callAbility，不支持FeatureAbility.subscribeAbilityEvent、FeatureAbility.unsubscribeAbilityEvent。從目前官網資料看，生成的方法都是FeatureAbility.callAbility方式。

3.void方法，private，protected，default訪問權限的方法不會生成。

  1. public void add(int a, int b) {//add 方法不會生成 
  2.     return a + b; 
  3. } 
  4.  
  5. int add(int a, int b) {//private，protected，default的方法不會生成 
  6.     return a + b; 
  7. } 

4.生成對應的js方法都是async的。

  1. async add(a, b) { 
  2.     if (arguments.length != 2) { 
  3.         throw new Error("Method expected 2 arguments, got " + arguments.length); 
  4.     } 
  5.     let data = {}; 
  6.     data.a = a; 
  7.     data.b = b; 
  8.     const result = await sendRequest(OPCODE_add, data); 
  9.     return JSON.parse(result); 
  10. } 

 5.非public方法通過編譯不會暴露給js，即生成的js代碼沒有對應方法，如果想要public方法也不想暴露給js用，可以使用**@ExportIgnore**。

  1. @ExportIgnore 
  2. public boolean helloChar(){ 
  3.     return true; 
  4. } 

 6.只支持文件中public的頂層類，不支持接口類和注解類。

7.跟傳統的調用方式不同，js端必須new 一個實例，通過實例調用方法。

  1. const bridge = new JsBridgeX() 
  2. bridge.add(a, b) 

新方式二：LocalParticleAbility

不同于上面的js2java-codegen這種方式，LocalParticleAbility在系統內部已經建立好通道，不需要編譯生成額外的代碼，在java端實現，在js端調用就行，比js2java-codegen更加簡單。

條件

從API Version 6 開始支持。

實現步驟

1.java端實現接口LocalParticleAbility，添加方法。

  1. package com.freesonwill.facallpa.biz; 
  2. public class MyLocalParticleAbility implements LocalParticleAbility { 
  3.     //interface 
  4.     public int add(int a, int b) { 
  5.         return a + b; 
  6.     } 
  7.  
  8.     public void addAsync(int a, int b, Callback cb) { 
  9.         new Thread(() -> { 
  10.             int ret = a + b;//假設這里是一個耗時操作 
  11.             cb.reply(ret ); 
  12.         }).start(); 
  13.     } 

 注：這里列舉了同步和異步的兩種方式，異步需要LocalParticleAbility.Callback的reply方法返回。

2.注冊。

  1. public class MainAbility extends AceAbility { 
  2.  
  3.     @Override 
  4.     public void onStart(Intent intent) { 
  5.         super.onStart(intent); 
  6.         MyLocalParticleAbility.getInstance().register(this); 
  7.     } 
  8.     @Override 
  9.     public void onStop() { 
  10.         super.onStop(); 
  11.         MyLocalParticleAbility.getInstance().deregister(this); 
  12.     } 
  13. } 

 3.js端調用。

a) 創建LocalParticleAbility對象

  1. this.javaInterface = createLocalParticleAbility('com.freesonwill.facallpa.biz.MyLocalParticleAbility'); 

 b)調用方法

調用同步方法

  1. add(a, b) { 
  2.     this.javaInterface.add(a, b).then(ret => { 
  3.         prompt.showToast({ 
  4.             message: `${a}+$ = ${ret}` 
  5.         }) 
  6.     }) 
  7. }, 
  8. 或者   
  9. async add(a, b) { 
  10.     let ret = await this.javaInterface.add(a, b); 
  11.     console.log("rst:" + JSON.stringify(ret)) 
  12. }, 

 調用異步方法

  1. addAsync(a, b) {  
  2.     this.javaInterface.addAsync(1, 2, rst => { 
  3.         console.log("rst:" + JSON.stringify(rst)) 
  4.     }) 
  5. }, 

從上面可以看出LocalParticleAbility既支持同步又支持異步，彌補了js2java-codegen的不足。

注意點

  1. 目前從官網中js端的createLocalParticleAbility找不到，目前調試不行。
  2. API Version 6 開始支持。
  3. 需要注冊和反注冊。

總結

傳統JS FA的調用方式需要關注方法名，方法參數的傳遞解析，比較復雜，后續大概率會被LocalParticleAbility這種簡潔方式替換。

js2java-codegen提供了APT技術幫我們生成通道代碼，但是受限于不能實現異步，函數必須有返回值等，實用性不強。

LocalParticleAbility優勢很大，是未來的方向，目前雖然提供了文檔，但是在DevEco Studio 3.0端 SDK 6仍然不能成功。

想了解更多內容，請訪問：

51CTO和華為官方合作共建的鴻蒙技術社區

https://harmonyos.51cto.com

 

責任編輯：jianghua 來源： 鴻蒙社區
鴻蒙HarmonyOS應用
相關推薦

2021-09-10 15:13:41

鴻蒙HarmonyOS應用

2022-03-07 14:58:10

ArkUIJS FAJava

2021-12-20 10:07:39

鴻蒙HarmonyOS應用

2022-02-17 21:28:08

AbilityJSFA鴻蒙

2021-07-16 09:54:49

鴻蒙HarmonyOS應用

2022-06-02 14:27:05

UI框架JS

2022-02-17 21:19:35

JSFA操作系統鴻蒙

2022-02-24 16:00:59

Ability鴻蒙JS

2021-11-15 15:11:14

鴻蒙HarmonyOS應用

2022-09-08 15:18:51

Ability鴻蒙

2022-05-20 10:56:54

AbilityeTS FA調用

2018-09-11 11:03:45

存儲新方式DNA存儲

2009-04-25 09:30:55

Firefox瀏覽器

2017-07-17 11:12:07

大數據醫療戴爾

2009-12-25 16:40:33

DDN接入

2022-05-24 15:06:57

AbilityeTS FA鴻蒙

2010-11-25 10:07:01

Ubuntu滾動更新

2013-08-15 09:54:02

2011-09-07 14:30:35

MPLSMPLS故障

2009-03-14 19:03:29

Windows Mob更新方式
點贊
收藏

51CTO技術棧公眾號

主站蜘蛛池模板： 欧美色视频免费 | 日韩中文一区二区三区 | 久久性色 | 成人免费毛片在线观看 | 婷婷色在线播放 | 日本不卡在线观看 | 欧洲毛片 | 久久久久久亚洲精品 | 欧美一级电影免费 | 男人视频网站 | 久久另类视频 | h视频免费观看 | 国产精品电影在线观看 | 国产福利91精品 | 男人天堂久久久 | 天天影视综合 | 欧美激情国产精品 | 99精品久久| 欧美一区二区 | 欧美黑人体内she精在线观看 | 国产成人综合在线 | 激情五月综合 | 欧美激情在线精品一区二区三区 | 亚洲一区电影 | 国产黄色在线 | 黄色国产 | 日韩精品一区在线 | 国产区一区二区三区 | 99爱国产 | 久久精品一级 | 人人看人人射 | 综合久久综合久久 | 亚洲欧美中文日韩在线v日本 | 亚洲综合五月天婷婷 | 中文字幕国产高清 | 久草福利 | 亚洲第一在线 | 亚洲三级免费看 | 国产成都精品91一区二区三 | 理论片午午伦夜理片影院 | 日本中文字幕日韩精品免费 |