JsBridge JavascriptとJavaの相互呼び出しを実現

27668 ワード

フロントエンドページJavascriptとNativeの相互呼び出しは携帯電話アプリケーションでますます一般的になり、JsBridgeは最も一般的なソリューションです.
Android開発でJavascriptとNativeコードの通信を実現できるのは、4つのルートがあります.
1.JavascriptInterface
2.WebViewClient.shouldOverrideUrlLoading()
3.WebChromeClient.onConsoleMessage()
4.WebChromeClient.onJsPrompt()
 
JavascriptInterface
Androidが提供するJavascriptとNative通信の公式ソリューションです.
まずJavaコードは、Javascript呼び出しに提供する役割を果たすクラスを実現します.
public class JavascriptInterface {

    @JavascriptInterface
    public void showToast(String toast) {
        Toast.makeText(MainActivity.this, toast, Toast.LENGTH_SHORT).show();
    }
}

そしてこのクラスをWebViewのJavascriptInterfaceに追加します.
webView.addJavascriptInterface(new JavascriptInterface(), "javascriptInterface");

Javascriptコードでは、NativeのクラスのメソッドをjavascriptInterfaceで直接呼び出すことができます.
function showToast(toast) {
    javascript:javascriptInterface.showToast(toast);
}

しかし、この公式提供のソリューションはAndroid 4.2セキュリティ・ホールは以前に存在していました.Android 4.2以降,@JavascriptInterfaceを加えて解決される.したがって、JavascriptInterfaceは、低バージョンのシステムと互換性があることを考慮すると適切ではありません.
 
WebViewClient.shouldOverrideUrlLoading()
この方法の役割はすべてのWebViewのUrlジャンプを遮断することである.ページは特殊なフォーマットのUrlジャンプを構築することができ、shouldOverrideUrlLoadingはUrlをブロックしてフォーマットを判断し、Nativeは自分の論理を実行することができます.
public class CustomWebViewClient extends WebViewClient {

    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        if (isJsBridgeUrl(url)) {
            // JSbridge     
            return true;
        }
        return super.shouldOverrideUrlLoading(view, url);
    }
}

 
WebChromeClient.onConsoleMessage()
これはAndroidがJavascriptにNativeコードにログ情報を印刷するAPIをデバッグするために提供するとともに、JavascriptとNativeコードの通信方法の一つとなっている.
Javascriptコードでconsoleを呼び出す.log('xxx')メソッド.
console.log('log message that is going to native code')

NativeコードのWebChromeClientにconsoleMessage()でコールバックされます.
consoleMessage.Message()が得たのはJavascriptコードconsole.ロゴ('xxx')の内容.
public class CustomWebChromeClient extends WebChromeClient {

    @Override
    public boolean onConsoleMessage(ConsoleMessage consoleMessage) {
        super.onConsoleMessage(consoleMessage);
        String msg = consoleMessage.message();//Javascript   Log  
    }
}

 
WebChromeClient.onJsPrompt()
実はWebChromeClientを除いてonJsPrompt()、そしてWebChromeClient.onJsAlert()とWebChromeClient.onJsConfirm().名前の通り、この3つのJavascriptがNativeコードに与えるコールバックインタフェースの役割は、それぞれヒント情報の提示、警告情報の提示、確認情報の提示である.Javascriptではalertとconfirmの使用率が高いため、JsBridgeのソリューションではonJsPrompt()を選択する傾向があります.
Javascriptで呼び出す
window.prompt(message, value)

WebChromeClient.onJsPrompt()はコールバックされます.
onJsPrompt()メソッドのmessageパラメータの値はJavascriptメソッドwindow.prompt()のmessageの値.
public class CustomWebChromeClient extends WebChromeClient {

    @Override
    public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) {
        //   JS      
        result.confirm();
        return true;
    }
}

 
JsBridge
前述の4つの通信方式はいずれもJavascript通信NativeのJavaであるが,逆にJava通信Javascriptは1つの方式しかない.
それはWebViewを呼び出すことですloadUrl()は、あらかじめ定義されたJavascriptメソッドを実行します.
webView.loadUrl(String.format("javascript:WebViewJavascriptBridge._handleMessageFromNative(%s)", data));

 
次に、JsBridgeというオープンソースコンポーネントを組み合わせて、JsBridgeの原理を説明します.
1.WebViewロードhtmlページ
    webView.registerHandler("submitFromWeb", ...);これはJavaレイヤが「submitFromWeb」というインタフェースメソッドを登録し、Javascriptに呼び出しを提供することを目的としています.この「submitFromWeb」のインタフェースメソッドのコールバックはBridgeHandlerです.handler().
    webView.callHandler("functionInJs", ..., new CallBackFunction());JavaレイヤがJavascriptをアクティブに呼び出す「functionInJs」メソッドです.
package com.github.lzyzsd.jsbridge.example;

public class MainActivity extends Activity implements OnClickListener {
@Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); webView = (BridgeWebView) findViewById(R.id.webView); webView.loadUrl("file:///android_asset/demo.html"); webView.registerHandler("submitFromWeb", new BridgeHandler() { @Override public void handler(String data, CallBackFunction function) { Log.i(TAG, "handler = submitFromWeb, data from web = " + data); function.onCallBack("submitFromWeb exe, response data from Java"); } });
webView.callHandler("functionInJs", new Gson().toJson(user), new CallBackFunction() { @Override public void onCallBack(String data) { } }); } }

我々は次第にcallHandler()法の実現に深く入り込んだ.ここでdoSend()メソッドが呼び出されます.ここでcallbackIdについて説明します.
callbackIdが生成されるとJavascriptだけでなく、key-valueペアとresponseCallbackペアでresponseCallbacksというMapに保存されます.
その目的は、Javascriptが処理結果をJava層にコールバックした後、Java層がcallbackIdに基づいて対応するresponseCallbackを見つけ、後続のコールバック処理を行うことである.
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()));
            responseCallbacks.put(callbackStr, responseCallback);
            m.setCallbackId(callbackStr);
        }
        if (!TextUtils.isEmpty(handlerName)) {
            m.setHandlerName(handlerName);
        }
        queueMessage(m);
    }

最終的にはBridgeWebViewですdispatchMessage(Message m)メソッドが呼び出すのはthisである.loadUrl()が呼び出されました_handleMessageFromNativeというJavascriptメソッド.では、このJavascriptの方法はどこから来たのでしょうか.
final static String JS_HANDLE_MESSAGE_FROM_JAVA = "javascript:WebViewJavascriptBridge._handleMessageFromNative('%s');";

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);
        if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            this.loadUrl(javascriptCommand);
        }
    }

 
2.ページのロードが完了すると、Javascriptが追加されます.
WebViewClient.onPageFinished()の中のBridgeUtil.webViewLoadLocalJs(view, BridgeWebView.toLoadJs).assert/WebViewJavascriptBridgeに保存していますjsはWebViewにロードされます.
package com.github.lzyzsd.jsbridge;

public class BridgeWebViewClient extends WebViewClient {
  
    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);

        if (BridgeWebView.toLoadJs != null) {
            BridgeUtil.webViewLoadLocalJs(view, BridgeWebView.toLoadJs);
        }

        //
        if (webView.getStartupMessage() != null) {
            for (Message m : webView.getStartupMessage()) {
                webView.dispatchMessage(m);
            }
            webView.setStartupMessage(null);
        }
    }
}

WebViewJavascriptBridgeを見てみましょうjsのコードでfunction_が見つかりますhandleMessageFromNative()というJavascriptメソッドです.
 
3.次にWebViewJavascriptBridgeを分析する.js
    _handleMessageFromNative()メソッドで呼び出されます.dispatchMessageFromNative()メソッド.
Javaレイヤからのアクティブコールを処理すると、「直接送信」のelseブランチが実行されます.
    message.callbackIdは取り出され、Javascript処理が完了した後に結果データをJavaレイヤコードにコールバックするためのresponseCallbackをインスタンス化します.
次はメッセージに従います.handleName(この解析例では、handleNameの値が「functionInJs」である)は、messageHandlersというMapでhandlerを取得し、最後にhandlerに渡して処理します.
function _dispatchMessageFromNative(messageJSON) {
    setTimeout(function() {
        var message = JSON.parse(messageJSON);
        var responseCallback;
        //java call finished, now need to call js callback function
        if (message.responseId) {
            ...
        } else {
            //    
            if (message.callbackId) {
                var callbackResponseId = message.callbackId;
                responseCallback = function(responseData) {
                    _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);
                }
            }
        }
    });
} 

    
4.ページ登録の「functionInJs」メソッドは、Java呼び出しJavascriptに提供されます.
上の分析を続けると、messageHandlerはどこで設定されているのでしょうか.答えは最初にloadUrl("file:///android_asset/demo.html");このdemo.htmlにロードされます.
    bridge.registerHandler("functionInJs", ...)ここには「functionInJs」が登録されています.
<html>
    <head>
    ...
    </head>
    <body>
    ...
    </body>
    <script>
        ...

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

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

 
5.「functionInJs」の実行が完了したら結果をJavaに返信する
「funciontInJs」の実行後に呼び出されたresponseCallbackはまさに_dispatchMessageFromNative()はインスタンス化され、実際には呼び出されます.doSend()メソッド.
    _doSend()メソッドは、まずMessageをsendMessageQueueにプッシュします.
次にメッセージを変更します.src、ここでJava層のWebViewClientを出発します.shouldOverrideUrlLoading()のコールバック.
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;
}

BridgeWebViewClientでshouldOverrideUrlLoading()では、webViewを先に実行します.flushMessageQueue()のブランチ.
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
    try {
        url = URLDecoder.decode(url, "UTF-8");
    } 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()まずJavascriptを実行する_flushQueue()メソッドで、CallBackFunctionが付属しています.
Javascriptの_flushQueue()メソッドはsendMessageQueueのすべてのメッセージをJavaレイヤに返信します.
CallBackFunctionとは,messageQueueを解析して1つのMessageをforループで処理することであり,まさにforループで「functionInJs」のJava層コールバック手法が実行される.
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++) {
                    ...
                }
            }
        });
    }
}

 
これでJsBridgeの呼び出しプロセスの解析が完了します.JsBridgeはMessageQueueを使用した後、分析すると少し回りますが、原理は変わりません.
JavascriptがJavaを呼び出すのはWebViewClient.shouldOverrideUrlLoading().もちろん、冒頭で別の3つの方法を紹介します.
JavaがJavascriptを呼び出すのはWebViewです.loadUrl("javascript:xxxx").
 
参照先:
よくh 5と疎通します!いくつかの一般的なhybrid通信方式;
AndroidはWebViewJavascriptBridgeを利用してjsとjavaのインタラクションを実現する.
GitHub:lzyzsd/JsBridge