【quickhybrid】API的分類:短期API、長期API

来源:http://www.cnblogs.com/dailc/archive/2017/12/25/8107876.html
-Advertisement-
Play Games

前言 一切就緒,開始規劃API,這裡在規劃前對API進行了一次分類:__短期API、長期API__ 首先申明下,這個是在實際框架演變過程中自創的一個概念,其它混合框架可能也會有這個概念,但應該是會在原生底層來實現,而不是前端實現。。 而這裡由於是 ,所以相比其它混合框架,前端多了一個處理引擎(包括多 ...


前言

一切就緒,開始規劃API,這裡在規劃前對API進行了一次分類:短期API、長期API

首先申明下,這個是在實際框架演變過程中自創的一個概念,其它混合框架可能也會有這個概念,但應該是會在原生底層來實現,而不是前端實現。。
而這裡由於是前端驅動,所以相比其它混合框架,前端多了一個處理引擎(包括多平臺適配,API處理等等)

劃分的憑據

根據API回調的實際執行次數來劃分,執行一次自動回收的是短期API,可以執行多次的是長期API

譬如,短期回調包括:

ui
    alert,toast等等
page
    open,reload等等
...

譬如,長期回調包括:

navigator
    hookBackBtn,setRightBtn
event
    registerEvent:'resume','netChange'等等
...

而且規定,短期API執行完一次後必須自動刪除引用,避免無法及時回收,長期API則不會自動回收,會一直監聽直到主動取消或頁面關閉

如下圖

在代碼層次兩者有何區別?

API設計的一個原則就是儘量簡單優雅,所以__在H5的調用層次來看,這兩種不會有任何區別__,比如

quick.navigator.setTitle({
    title: '測試標題',
    subTitle: '子標題',
    success: function(result) {},
    error: function(err) {}
});

quick.navigator.setRightBtn({
    isShow: 1,
    text: '按鈕右1',
    which: 0,
    success: function(result) {
        /**
         * 按鈕點擊後回調
         */
    },
    error: function(error) {}
});

這兩個API從定義上一個是長期回調,一個是短期回調,但是在調用者看來,寫法不會有區別,仍然是同一種風格的,也不會要求傳遞額外參數

在框架定義層次,需要區分

雖然在調用層次來看,並無區別,但是在框架內部,還是有所不同的

譬如

// 在原生調用完對應的方法後,會執行對應的回調函數id,並刪除
const responseCallbacks = {};
// 長期存在的回調,調用後不會刪除
const responseCallbacksLongTerm = {};

長期API在調用後,回調會添加到responseCallbacksLongTerm池中,短期AP會添加到responseCallbacks

// 這裡規定,原生執行方法完畢後準備通知h5執行回調時,回調函數id是responseId
responseCallback = responseCallbacks[responseId];
// 預設先短期再長期
responseCallback = responseCallback || responseCallbacksLongTerm[responseId];
// 執行本地的回調函數
responseCallback && responseCallback(responseData);
delete responseCallbacks[responseId];

在回調執行階段,如果是短期回調,會自動刪除引用,方便垃圾處理器自動回收(裡面會保證短期id和長期id不重覆)

在原生容器層面兩者的區別?

在H5框架層次,長期API和短期API的差距也不是很大,但是在原生層面,差距明顯變大(這也是為什麼會把這兩種單獨劃分成兩個概念)

為了儘可能的減少冗餘信息,我們僅以navigator.setRightBtnsetTitleAPI為例,它們的前端調用我們在前面已經看到了,那麼它在原生容器中的實現如下

原生中長期API是會先行監聽的(考慮過調用後監聽和調用前監聽兩種模式,最終採取了調用前監聽-結合了原生原有代碼考慮)

以下的偽代碼基於前面的JSBridge介紹文章,這裡假設已經瞭解了,不再贅述

註意:這裡的setTitle為短期API,但是如果想要給它加上點擊回調的話是需要變成長期API的,我們僅以短期的狀態為例

Android容器中的對比

public class NavigatorApi implements IBridgeImpl {
    public static void setTitle(..., JSONObject params, Callback callback) {
        // 獲取了參數後直接改變了導航欄的標題
        ...
        // 然後開始回調
        callback.apply(...);
    }
    
    public static void setRightBtn(..., JSONObject params, Callback callback) {
        // 解析參數,然後將回調信息和監聽函數添加到webview控制器中,這個控制器預設監聽了很多事件。但只有這些回調信息添加後才會執行
        // 裡面也包括了更改按鈕的文字或圖標
        ...
        WebloaderControl.addPort(callback.port, 'xxx右側按鈕監聽事件');
    }
}

WebloaderControl中的作用是監聽各種事件(如利用一些天然的resume事件等),然後當對應事件觸發時,只有回調池中(addPort添加進的)存在,才會執行

其中'xxx右側按鈕監聽事件'是在webview自行監聽的,這裡就不再贅述了

只需直到,WebloaderControl.addPort,右側監聽事件中才會執行添加進去的回調,否則是沒有什麼操作的

可以看到短期API和長期API的形態是不一樣的,一個是調用後立即執行,一個是已經監聽了,就等著你的回調

iOS容器中的對比

@implementation NavigatorApi
- (void)registerHandlers {
    [self registerHandlerName:@"setTitle" handler:^(id data, WVJBResponseCallback responseCallback) {
        // 同樣,在執行完功能後進行回調
        ...
        responseCallback(...);
    }
    
    [self registerHandlerName:@"setRightBtn" handler:^(id data, WVJBResponseCallback responseCallback) {
        // 裡面也包括了更改按鈕的文字或圖標等一些步驟
        ...
        // 同樣,這裡是將回調添加到緩存池中,然後監聽到對於按鈕點擊時就會執行回調
        [self cacheCallback:responseCallback handlerName:@"setRightBtn"];
    }
}

iOS和Android中相比,雖然實現代碼不一樣,但是邏輯是一致的,同樣在監聽後才會執行對應回調

結束語

短期和長期概念只是用來更好的劃分和管理API,有了這個概念後,接下來就可以開始對API進行統一規划了

返回根目錄

源碼

github上這個框架的實現

quickhybrid/quickhybrid


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • ...
  • win10 64位 mysql安裝過程出現status顯示failed ...
  • MySQL中使用group_concat()函數長度限制問題,怎麼修改!!! ...
  • 1.1 索引的介紹 索引是對資料庫表中一列或多列的值進行排序的一種結構,使用索引可快速訪問資料庫表中的特定信息。如果想按特定職員的姓來查找他或她,則與在表中搜索所有的行相比,索引有助於更快地獲取信息。 索引的一個主要目的就是加快檢索表中數據的方法,亦即能協助信息搜索者儘快的找到符合限制條件的記錄ID ...
  • 自動佈局是一項強大的功能,它允許開發者創建一個單一的用戶界面,它會自動調整屏幕大小,方向和本地化,Xcode5中的編輯界面的自動佈局功能已經大大增強了。當約束缺失或錯誤配置時,界面生成器可以修複佈局。 參考資料:《iOS7開發快速入門》 ...
  • 轉載請註明原文鏈接:http://www.cnblogs.com/yanyojun/p/8099523.html 代碼已上傳到github:https://github.com/YanYoJun/FragmentTabHostDemo 上一篇有講過使用ViewPager來實現標簽卡效果的。這一篇講一 ...
  • Android遠程桌面助手理論上相容Android4.4至Android8.1之間所有的原生安卓系統,其他第三方ROM,如MIUI、Flyme、EMUI和Smartisan OS等也都陸續測試過,目前尚未發現相容性問題。 ...
  • 前言 在框架規劃時,就有提到過這個框架的一些常用功能需要支持 環境下的調用,也就是需要實現API的多平臺支撐 為什麼要多平臺支撐?核心仍然是復用代碼,比如在微信下,在釘釘下,在quick容器下, 如果沒有多平臺支撐,那麼 只能用於quick容器下,釘釘和微信下就得分別用其它代碼實現, 代碼復用率低, ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...