JsBridge使用和原理

What is JsBridge

近期在做一個項目,使用的是Native+H5的方式實現(xiàn)的搬葬。眾所周知的是在Android中,Webview所實現(xiàn)的java與js的交互存在一些安全問題,并且這樣的使用方式,沒法讓一套H5同時適配Android和iOS兩個平臺抛猫,因此,就需要有一個中間組件來實現(xiàn)js與本地的代碼的交互孩灯,也就是JsBridge闺金。

在Android平臺我們選用了開源項目。整個庫的結(jié)構(gòu)也比較簡單:一個用來注入的js文件峰档,一個自定義的Webview(包括webViewClient)败匹,以及作為載體的BridgeHandler。

JsBridge的使用

在介紹JsBridge的原理之前讥巡,先簡單介紹下JsBridge的使用掀亩,也可以看github上的表述。

JsBridge庫集成

集成的方式有很多種:

  1. 使用作者推薦方式:
    repositories {  
        maven {url "https://jitpack.io"}  
    }  
    dependencies {  
        compile 'com.github.lzyzsd:jsbridge:1.0.4'
    }
  1. 使用源碼集成
    下載源碼尚卫,將源碼拷貝至自己的工程內(nèi)归榕,作為工程的文件尸红。
  2. 自定義Module
    下載源碼吱涉,新建Module刹泄,將源碼導入Module,并將項目依賴自定義的Module

使用JsBridge庫

  • 提供操作給Js調(diào)用

      webView.registerHandler("submitFromWeb", new BridgeHandler(){
          @Override
          public void handler(String data, CallBackFunction function){
              function.onCallBack("submitFrom web exe, response data from java");
          }
      }
    

Js如果需要調(diào)用Java提供的方法時候怎爵,則需要調(diào)用這個Handler特石,而在注冊時參數(shù)submitFromWeb將作為Js調(diào)用時使用的Key值。調(diào)用方式如下:

    WebViewJavascriptBridge.callHandler(
        'submitFromWeb',
        {'param':str1},
        function(responseData){
            //這里打印的應該是上面Handler實現(xiàn)方法中的callback的入?yún)ⅲ簊ubmitFrom web exe, response data from java
            document.getElementById("show").innerHTML = "response data from java, data = "+responseData
        }
    )

另外鳖链,庫也提供了一個簡單的沒有回調(diào)的調(diào)用方式:

    webView.setDefaultHandler(new DefaultHandler());

Js調(diào)用的方式也可以簡化為:

    WebViewJavascriptBridge.send(
        data,
        function(responseData){
            //java中DefaultHandler所實現(xiàn)的方法中callback所定義的入?yún)?        }
    )
  • 提供操作給Java調(diào)用
    注冊方法與Java雷同:

      WebViewJavascriptBridge.registerHandler("functionInJs", function(data, responseCallback) {
          document.getElementById("show").innerHTML = ("data from Java: = " + data);
          var responseData = "Javascript Says Right back aka!";
          responseCallback(responseData);
      });
    

Java調(diào)用Handler時姆蘸,也跟Js一樣:

    webView.callHandler("functionInJs", new Gson().toJson(user),
        new CallBackFunction(){
            @Override
            public void onCallBack(String data){
            }
        }
    );

同樣的,在JS中也可以注冊默認的Handler芙委,以方便Java調(diào)用時逞敷,通過send方法發(fā)送數(shù)據(jù)

    bridge.init(function(message, responseCallback) {
        console.log('JS got a message', message);
        var data = {
            'Javascript Responds': 'Wee!'
        };
        console.log('JS responding with', data);
        responseCallback(data);
    });

java調(diào)用send方法:

    webView.send("hello");

JsBridge使用原理

在講JsBridge的實現(xiàn)之前,首先要講下各個文件的作用:

  • WebViewJavascriptBridge.js     被注入到各個頁面的js文件灌侣;提供初始化推捐,注冊Handler,調(diào)用Handler等方法侧啼。
  • WebViewJavascriptBridge.java    bridge接口文件,定義了發(fā)送信息的方法牛柒,由BridgeWebView來實現(xiàn)。
  • BridgeWebView.java         WebView的子類痊乾,提供了注冊Handler皮壁,調(diào)用Handler等方法。
  • BridgeWebViewClient.java       WebViewClient的子類哪审,重寫了ShouldOverrideUrlLoading蛾魄,onPageFinish,onPageStart等方法协饲。
  • BridgeHandler.java          作為Java與Js交互的載體畏腕。Java&Js通過Handler的名稱來找到響應的Handler來操作。
  • DefaultBridgeHandler.java      BridgeHandler的子類茉稠,不做任何操作描馅。僅為Java提供默認的接收數(shù)據(jù)的Handler。
  • CallBackFunction.java        回調(diào)函數(shù)而线,Handler處理完成后铭污,用來給Js發(fā)送消息。
  • Message.java             消息對象膀篮,用來封裝與js交互時的json數(shù)據(jù)嘹狞,callid,responseid等誓竿。
  • BridgeUtil.java            工具類磅网,提供從Url中提取數(shù)據(jù),獲取回調(diào)方法筷屡,注入js等方法涧偷。

JsBridge調(diào)用過程

  1. Native初始化webview簸喂,注冊Handler;加載頁面完成后燎潮,將WebViewJavascriptBridge.js文件注入頁面喻鳄。查詢消息隊列是否有信息需要被接收。
  2. H5頁面初始化确封,注冊Handler除呵,查詢消息隊列是否有信息需要別接收。
  3. 用戶操作爪喘,H5調(diào)用本地功能:Js將消息內(nèi)容放在sendMessageQueue中颜曾,并設(shè)置iframe的src為yy://__QUEUE_MESSAGE__/
  4. Webview設(shè)置的WebViewClient攔截到約定url,調(diào)用Webview的刷新消息隊列的方法flushMessageQueue秉剑,此方法就是加載了一個url:javascript:WebViewJavascriptBridge._fetchQueue();,這也是Js中定義的方法泛啸,另外定義了一個回調(diào);回調(diào)方法主要做了兩件事:①判斷Native是否為此返回數(shù)據(jù)保有響應回調(diào)操作秃症,若有候址,則執(zhí)行,若沒有种柑,則為判斷callId岗仑,不為空時為這個callId初始化一個回調(diào)。②通過handlername判斷是否為默認的Handler還是自定義的Handler聚请,調(diào)用相應Handler的handler方法荠雕,入?yún)橄?shù)據(jù)內(nèi)容和第一步中定義的回調(diào)∈簧停【這段較為難消化炸卑,需要閱讀代碼來理解】
  5. Js中_fetchQueue設(shè)置了iframe的src,內(nèi)容為:yy://return/_fetchQueue/+第二步中放入sendMessageQueue中的消息內(nèi)容煤傍。
  6. WebViewClient攔截到url為yy://return/盖文,調(diào)用WebView的handlerReturnData方法;通過url中定義的方法名蚯姆,找到第四個步驟中定義的回調(diào)五续,并調(diào)用×淞担回調(diào)方法走完后疙驾,刪除此回調(diào)方法。
  7. 如果Js在調(diào)用Handler的時候設(shè)置了回調(diào)方法郭毕,也就是在第四步驟中的含有callId它碎,就會調(diào)用queueMessage的方法,然后往下就是走Native給Js發(fā)送消息的步驟。
    Ps: Native給Js發(fā)送消息的步驟跟上述從第三步驟到第七步驟完全相同扳肛,只不過Native和Js對象調(diào)換位置即可偏竟。

JsBridge的核心

JsBridge之所以能實現(xiàn)Native與Js相互調(diào)用的功能,其核心實現(xiàn)其實就是:

  1. 攔截Url
  2. load url("javascript:js_method()");

先說第二點敞峭,Native調(diào)用Js,通過加載以javascript:開頭的url即可實現(xiàn)調(diào)用Js的方法蝉仇。這個很好理解旋讹,在web中也是通過這種方式調(diào)用Js的方法的。
然后細說下第一點的實現(xiàn):

  1. 向body中添加一個不可見的iframe元素轿衔。通過攔截url的方法來執(zhí)行相應的操作沉迹,但是頁面本身不能跳轉(zhuǎn),所以改變一個不可見的iframe的src就可以讓webview攔截到url害驹,而用戶是無感知的鞭呕。
  2. 攔截url。通過shouldOverrideUrlLoading來攔截約定規(guī)則的Url宛官,再做具體操作葫松。
    Ps: 添加iframe是H5自身可實現(xiàn)的,但是如果H5來實現(xiàn)的話底洗,需要每個頁面實現(xiàn)腋么,且耦合較高;因此放在庫里亥揖,通過加載完成注入的方式珊擂,則會降低耦合

先就這么多~~
留個思考的問題:無論是js發(fā)送消息給Native,還是Native發(fā)送消息給Js费变,首先都會發(fā)送一個_fetchQueue摧扇,然后再發(fā)送return;那這兩步是否可以合并成一步呢?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末挚歧,一起剝皮案震驚了整個濱河市扛稽,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌滑负,老刑警劉巖庇绽,帶你破解...
    沈念sama閱讀 207,248評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異橙困,居然都是意外死亡瞧掺,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,681評論 2 381
  • 文/潘曉璐 我一進店門凡傅,熙熙樓的掌柜王于貴愁眉苦臉地迎上來辟狈,“玉大人,你說我怎么就攤上這事『咦” “怎么了明未?”我有些...
    開封第一講書人閱讀 153,443評論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長壹蔓。 經(jīng)常有香客問我趟妥,道長,這世上最難降的妖魔是什么佣蓉? 我笑而不...
    開封第一講書人閱讀 55,475評論 1 279
  • 正文 為了忘掉前任披摄,我火速辦了婚禮,結(jié)果婚禮上勇凭,老公的妹妹穿的比我還像新娘疚膊。我一直安慰自己,他們只是感情好虾标,可當我...
    茶點故事閱讀 64,458評論 5 374
  • 文/花漫 我一把揭開白布寓盗。 她就那樣靜靜地躺著,像睡著了一般璧函。 火紅的嫁衣襯著肌膚如雪傀蚌。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,185評論 1 284
  • 那天蘸吓,我揣著相機與錄音喳张,去河邊找鬼。 笑死美澳,一個胖子當著我的面吹牛销部,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播制跟,決...
    沈念sama閱讀 38,451評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼舅桩,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了雨膨?” 一聲冷哼從身側(cè)響起擂涛,我...
    開封第一講書人閱讀 37,112評論 0 261
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎聊记,沒想到半個月后撒妈,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,609評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡排监,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,083評論 2 325
  • 正文 我和宋清朗相戀三年狰右,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片舆床。...
    茶點故事閱讀 38,163評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡棋蚌,死狀恐怖嫁佳,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情谷暮,我是刑警寧澤蒿往,帶...
    沈念sama閱讀 33,803評論 4 323
  • 正文 年R本政府宣布,位于F島的核電站湿弦,受9級特大地震影響瓤漏,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜颊埃,卻給世界環(huán)境...
    茶點故事閱讀 39,357評論 3 307
  • 文/蒙蒙 一蔬充、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧竟秫,春花似錦、人聲如沸跷乐。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,357評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽愕提。三九已至馒稍,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間浅侨,已是汗流浹背纽谒。 一陣腳步聲響...
    開封第一講書人閱讀 31,590評論 1 261
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留如输,地道東北人鼓黔。 一個月前我還...
    沈念sama閱讀 45,636評論 2 355
  • 正文 我出身青樓,卻偏偏與公主長得像不见,于是被迫代替她去往敵國和親澳化。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 42,925評論 2 344

推薦閱讀更多精彩內(nèi)容