js与native交互之JsBridge

接上篇

JsBridge

1.使用方法

1.1，java调用js指定方法，并有回调：

//java端的代码
webView.callHandler("functionInJs", param, new CallBackFunction() {
            @Override
            public void onCallBack(String data) {
                //拿到H5端回调回来的参数
            }
        });

//H5端的代码
bridge.registerHandler("functionInJs", function(data, responseCallback) {
             document.getElementById("show").innerHTML = ("data from Java: = " + data);
             var responseData = "Javascript Says Right back aka!";
             //将参数回调给native端
             responseCallback(responseData);
        });

java调用callHandler()的方法，必须要在H5中registerHandler()，而且方法名一样才能匹配到，
所以执行上可以看成 java—>js—>java。

1.2，js调用java

1，js发送消息给native端，并有回调

因为没有指定要处理的方法，则由java端的DefaultHandler拦截处理

//js代码
window.WebViewJavascriptBridge.send(
                data
                , function(responseData) {
                    //拿到H5端回调回来的参数
                    document.getElementById("show").innerHTML = "repsonseData from java, data = " + responseData
                }
            );

//java代码
//设置默认回调给JS的方法
webView.setDefaultHandler(new DefaultHandler());

public class DefaultHandler implements BridgeHandler {
    String TAG = "DefaultHandler";
    @Override
    public void handler(String data, CallBackFunction function) {
        if (function != null) {
             //将参数回调到H5端
            function.onCallBack("DefaultHandler response data"+ data);
        }
    }
}

js调用window.WebViewJavascriptBridge.send()的方法，会被java的DefaultHandler拦截
所以执行上可以看成 js—>java—>js。

2，js调用java指定方法，并有回调

//js代码
window.WebViewJavascriptBridge.callHandler(
                'submitFromWeb'
                , {'param': '中文测试'}
                , function(responseData) {
                //拿到H5端回调回来的参数
                document.getElementById("show").innerHTML = "send get responseData from java, data = " + responseData
                }
            );

//java代码
webView.registerHandler("submitFromWeb", new BridgeHandler() {
            @Override
            public void handler(String data, CallBackFunction function) {
                ToastUtil.showShort(ActivityDemo7.this,"hadler = submitFromWeb, data from web = " + data);
                //将参数回调到H5端
                function.onCallBack("submitFromWeb exe, response data 中文 from Java");
            }
        });

2.执行流程分析

2.1，java调用js指定方法，并有回调。

在java代码中，首先找到方法的入口，callHandler()。

webView.callHandler("functionInJs", params, new CallBackFunction() {
            @Override
            public void onCallBack(String data) {

            }
        });

进入callHandler()方法，调用了doSend()方法。

public void callHandler(String handlerName, String data, CallBackFunction callBack) {
        doSend(handlerName, data, callBack);
    }

看doSend()代码

/**
     * native主动调用js代码
     * @param handlerName js中的对应方法的名称
     * @param data 要传递的参数
     * @param responseCallback js代码执行后回调到这里的接口
     */
    private void doSend(String handlerName, String data, CallBackFunction responseCallback) {
        Message m = new Message();
        if (!TextUtils.isEmpty(data)) {
            m.setData(data);
        }
        if (responseCallback != null) {
            String callbackStr = String.format(BridgeUtil.CALLBACK_ID_FORMAT, ++uniqueId + (BridgeUtil.UNDERLINE_STR + SystemClock.currentThreadTimeMillis()));
//            doSend()中callbackStr:JAVA_CB_3_998
//            doSend()中callbackStr:JAVA_CB_4_1022
            Log.i("BridgeWebView","doSend()中callbackStr:"+callbackStr);
            responseCallbacks.put(callbackStr, responseCallback);
            m.setCallbackId(callbackStr);
        }
        if (!TextUtils.isEmpty(handlerName)) {
            m.setHandlerName(handlerName);
        }
        queueMessage(m);
    }

这里组装Message对象来保存调用方法的信息，假如存入了回调函数responseCallback ，则生成一个callbackStr 保存到本地的responseCallbacks中，继续进入queueMessage()方法

private void queueMessage(Message m) {
        //假如native调用js代码，则startupMessage为null
        if (startupMessage != null) {
            startupMessage.add(m);
        } else {
            dispatchMessage(m);
        }
    }

假如native调用js代码，则startupMessage为null，所以进入到dispatchMessage()方法中

void dispatchMessage(Message m) {
        String messageJson = m.toJson();
        //escape special characters for json string
        messageJson = messageJson.replaceAll("(\\\\)([^utrn])", "\\\\\\\\$1$2");
        messageJson = messageJson.replaceAll("(?<=[^\\\\])(\")", "\\\\\"");
        String javascriptCommand = String.format(BridgeUtil.JS_HANDLE_MESSAGE_FROM_JAVA, messageJson);
//        dispatchMessage()中javascriptCommand:javascript:WebViewJavascriptBridge._handleMessageFromNative('{\"data\":\"hello\"}');
//        dispatchMessage()中javascriptCommand:javascript:WebViewJavascriptBridge._handleMessageFromNative('{\"callbackId\":\"JAVA_CB_1_877\",\"data\":\"{\\\"location\\\":{\\\"address\\\":\\\"SDU\\\"},\\\"name\\\":\\\"大头鬼\\\"}\",\"handlerName\":\"functionInJs\"}');
        Log.i("BridgeWebView","dispatchMessage()中javascriptCommand:"+javascriptCommand);
        if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            this.loadUrl(javascriptCommand);
        }
    }

这段代码就是native调用js代码的关键，方法中先从message对象中解析json数据将信息解析，拼接出类似

javascript:WebViewJavascriptBridge._handleMessageFromNative('{\"callbackId\":\"JAVA_CB_1_877\",\"data\":\"{\\\"location\\\":{\\\"address\\\":\\\"SDU\\\"},\\\"name\\\":\\\"大头鬼\\\"}\",\"handlerName\":\"functionInJs\"}

的代码，再通过

if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            this.loadUrl(javascriptCommand);
        }

在主线程中webView.loadUrl()，所以其实java调用js的核心还是webView.loadUrl()这个方法，但是JsBridge库对其进行了封装，这样java就不能调用js中的任意代码（本来webView.loadUrl()这个方法只要传入拼接对的js代码，就能调用该js代码）。
追踪到js的WebViewJavascriptBridge._handleMessageFromNative代码

function _handleMessageFromNative(messageJSON) {
        console.log(messageJSON);
        if (receiveMessageQueue && receiveMessageQueue.length > 0) {
            receiveMessageQueue.push(messageJSON);
        } else {
            _dispatchMessageFromNative(messageJSON);
        }
    }

这里还没搞懂receiveMessageQueue 的作用是什么，只知道调用了_dispatchMessageFromNative()方法，所以继续进入方法

//按照messageJson进行事件的调用，假如有callback，则调用完之后callback
    function _dispatchMessageFromNative(messageJSON) {
        setTimeout(function() {
            //解析出callbackId（假如存在回调）和参数，
            var message = JSON.parse(messageJSON);
            var responseCallback;
            //java call finished, now need to call js callback function
            //假如存在responseId，则回调完成时去除callId
            if (message.responseId) {
                responseCallback = responseCallbacks[message.responseId];
                if (!responseCallback) {
                    return;
                }
                responseCallback(message.responseData);
                delete responseCallbacks[message.responseId];
            } else {
                //直接发送
                if (message.callbackId) {
                    var callbackResponseId = message.callbackId;
                    responseCallback = function(responseData) {
                        //js回调给java
                        _doSend({
                            responseId: callbackResponseId,
                            responseData: responseData
                        });
                    };
                }
                var handler = WebViewJavascriptBridge._messageHandler;
                if (message.handlerName) {
                    handler = messageHandlers[message.handlerName];
                }
                //查找指定handler
                try {
                    handler(message.data, responseCallback);
                } catch (exception) {
                    if (typeof console != 'undefined') {
                        console.log("WebViewJavascriptBridge: WARNING: javascript handler threw.", message, exception);
                    }
                }
            }
        });
    }

这段代码中，因为是java主动调用js，所以message.responseId为null，直接走else，先组装回调函数responseCallBack()

if (message.callbackId) {
                    var callbackResponseId = message.callbackId;
                    responseCallback = function(responseData) {
                        //js回调给java
                        _doSend({
                            responseId: callbackResponseId,
                            responseData: responseData
                        });
                    };
                }

接着根据handler = messageHandlers[message.handlerName];拿到handler

//查找指定handler
                try {
                    handler(message.data, responseCallback);
                } catch (exception) {
                    if (typeof console != 'undefined') {
                        console.log("WebViewJavascriptBridge: WARNING: javascript handler threw.", message, exception);
                    }
                }

最后就是调用方法，追踪到注册的方法

connectWebViewJavascriptBridge(function(bridge) {
            ......
            //为js注册Handler，
            bridge.registerHandler("functionInJs", function(data, responseCallback) {
                document.getElementById("show").innerHTML = ("data from Java: = " + data);
                var responseData = "Javascript Says Right back aka!";
                responseCallback(responseData);
            });
        })

最后调用了responseCallback(responseData)，responseCallback()在上面已经组装成功，就是调用了_doSend()这个方法

//sendMessage add message, 触发native处理 sendMessage
//将数据返回到native，回调到native时就是调用这个方法
function _doSend(message, responseCallback) {
        if (responseCallback) {
            var callbackId = 'cb_' + (uniqueId++) + '_' + new Date().getTime();
            responseCallbacks[callbackId] = responseCallback;
            message.callbackId = callbackId;
        }
        sendMessageQueue.push(message);
        messagingIframe.src = CUSTOM_PROTOCOL_SCHEME + '://' + QUEUE_HAS_MESSAGE;
    }

这里涉及到一些前端的知识，利用iframe.src的变化，触发了BridgeWebViewClient的shouldOverrideUrlLoading将数据返回到native端，这样就实现了js回调到native了。

所以总体上流程是：

Paste_Image.png

3，js调用java指定方法，并有回调

找到js代码的入口，window.WebViewJavascriptBridge.callHandler(...)

//function的responseData是回调的值
            //js调用特定的java方法
            window.WebViewJavascriptBridge.callHandler(
                'submitFromWeb'
                , {'param': '中文测试'}
                , function(responseData) {
                    document.getElementById("show").innerHTML = "send get responseData from java, data = " + responseData
                }
            );

进入callHandler()方法，也是调用了_doSend()方法，将数据传递到native

function callHandler(handlerName, data, responseCallback) {
        _doSend({
            handlerName: handlerName,
            data: data
        }, responseCallback);
    }

与上面js调用java流程中的_doSend()一样，通过改变iframe.src触发native的shouldOverrideUrlLoading()方法

 @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        try {
            url = URLDecoder.decode(url, "UTF-8");
            Log.i("BridgeWebViewClient","查看触发的schema:"+url);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }

        if (url.startsWith(BridgeUtil.YY_RETURN_DATA)) { // 如果是返回数据
            webView.handlerReturnData(url);
            return true;
        } else if (url.startsWith(BridgeUtil.YY_OVERRIDE_SCHEMA)) { //
            webView.flushMessageQueue();
            return true;
        } else {
            return super.shouldOverrideUrlLoading(view, url);
        }
    }

接着走的是webView.flushMessageQueue()这个方法

void flushMessageQueue() {
        if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            loadUrl(BridgeUtil.JS_FETCH_QUEUE_FROM_JAVA, new CallBackFunction() {

                @Override
                public void onCallBack(String data) {
                    // deserializeMessage
                    List<Message> list = null;
                    try {
                        list = Message.toArrayList(data);
                    } catch (Exception e) {
                        e.printStackTrace();
                        return;
                    }
                    if (list == null || list.size() == 0) {
                        return;
                    }
                    for (int i = 0; i < list.size(); i++) {
                        Message m = list.get(i);
                        String responseId = m.getResponseId();
                        // 是否是response
                        if (!TextUtils.isEmpty(responseId)) {
                            CallBackFunction function = responseCallbacks.get(responseId);
                            String responseData = m.getResponseData();
                            function.onCallBack(responseData);
                            responseCallbacks.remove(responseId);
                        } else {
                            CallBackFunction responseFunction = null;
                            // if had callbackId
                            final String callbackId = m.getCallbackId();
                            if (!TextUtils.isEmpty(callbackId)) {
                                responseFunction = new CallBackFunction() {
                                    @Override
                                    public void onCallBack(String data) {
                                        Message responseMsg = new Message();
                                        responseMsg.setResponseId(callbackId);
                                        responseMsg.setResponseData(data);
                                        queueMessage(responseMsg);
                                    }
                                };
                            } else {
                                responseFunction = new CallBackFunction() {
                                    @Override
                                    public void onCallBack(String data) {
                                        // do nothing
                                    }
                                };
                            }
                            BridgeHandler handler;
                            if (!TextUtils.isEmpty(m.getHandlerName())) {
                                handler = messageHandlers.get(m.getHandlerName());
                            } else {
                                handler = defaultHandler;
                            }
                            if (handler != null) {
                                handler.handler(m.getData(), responseFunction);
                            }
                        }
                    }
                }
            });
        }
    }

这个方法是在BridgeWebView中定义的，做的是在主线程中调用loadUrl(javascript:WebViewJavascriptBridge._fetchQueue()， new CallBackFunction());这个方法。
所以，追踪到js中的_fetchQueue()中

// 提供给native调用,该函数作用:获取sendMessageQueue返回给native,由于android不能直接获取返回的内容,所以使用url shouldOverrideUrlLoading 的方式返回内容
    function _fetchQueue() {
        var messageQueueString = JSON.stringify(sendMessageQueue);
        sendMessageQueue = [];
        //android can't read directly the return data, so we can reload iframe src to communicate with java
        messagingIframe.src = CUSTOM_PROTOCOL_SCHEME + '://return/_fetchQueue/' + encodeURIComponent(messageQueueString);
    }

这里将js传递的参数拼接入Url中，传递到native，而相应的shouldOverrideUrlLoading 中调用handlerReturnData()这个方法

/**
     * 处理返回的数据
     *
     * @param url
     */
    void handlerReturnData(String url) {
        String functionName = BridgeUtil.getFunctionFromReturnUrl(url);
        CallBackFunction f = responseCallbacks.get(functionName);
        String data = BridgeUtil.getDataFromReturnUrl(url);
        if (f != null) {
            f.onCallBack(data);
            responseCallbacks.remove(functionName);
            return;
        }
    }

这里就是调用native本地方法

if (f != null) {
            f.onCallBack(data);
}

所以总体上流程是

Paste_Image.png

留意整个流程，js的第一次_doSend()只不过是通知native调用javascript:WebViewJavascriptBridge._fetchQueue();来取消息，包括要调用的方法，参数，回调的id。所以其实真正调用native方法的是js层的_fetchQueue()。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,053评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,527评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,779评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,685评论 1赞 276
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,699评论 5赞 366
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,609评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,989评论 3赞 396
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,654评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,890评论 1赞 298
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1赞 330
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,394评论 4赞 319
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,976评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2赞 342

推荐阅读更多精彩内容