Android 中利用WebViewJavascriptBridge 实现js和java的交互

转自:http://blog.csdn.net/sk719887916/article/details/47189607


按安卓开发目前现状来说,开发者大部分时间还是花在UI的屏幕适配上,使用原生控件开发成本已不是那么理想,鉴于很多项目和iOS基于一致的ui界面,至使安卓UI开发成本花费更大的代价,因此目前结合Html5和原生控件是解决UI适配的一种很好的选择,处于APP性能也会用Java和native层进行结合。不管是哪种结合,其实原理都差不多,只要按照它的协议来,是很容易的,今天我们仅对于Html和Java层结合,学习下一个新的开源项目--WebViewJavascriptBridge。

   

一 什么是webViewjavascripBridge?

       WebViewJavascriptBridge是移动UIView和Html交互通信的桥梁,用作者的话来说就是实现java(ios为oc)和js的互相调用的桥梁。替代了WebView的自带的JavascriptInterface的接口,使得我们的开发更加灵活和安全。





 二 为什么要用webViewjavascripBridge?

     
    对于安卓开发有一段时间的人来说,知道安卓4.4以前谷歌的webview存在安全漏洞,网站可以通过js注入就可以随便拿到客户端的重要信息,甚至轻而易举的调用本地代码进行流氓行为,谷歌后来发现有此漏洞后,增加了防御措施,如果要是js调用本地代码,开发者 必须在代码申明 JavascriptInterface,
   列如在4.0之前我们要使得webView加载js只需如下代码:
  
[java]  view plain  copy
 print ?
  1. mWebView.addJavascriptInterface(new JsToJava(), "myjsfunction");    

     4.4之后调用需要在调用方法加入加入@JavascriptInterface注解,如果代码无此申明,那么也就无法使得js生效,也就是说这样就可以避免恶意网页利用js对安卓客户端的窃取和攻击。

        但是即使这样,我们很多时候需要在js记载本地代码的时候,要做一些判断和限制,或者有可能也会做些过滤和对用户友好提示,因此JavascriptInterface也就无法满足我们的需求了,特此有大神就写出了WebViewJavascriptBridge框架。

     



三 怎么使用webViewjavascripBridge


      1 将jsBridge.jar引入到我们的工程

              此jar,或者jar源码我们可以到gitHub上下载。

      2 WebView包需使用以上包的webView


              Layout中使用第三方view,
              EG:
             
[html]  view plain  copy
 print ?
  1. xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:layout_width="match_parent"  
  4.     android:layout_height="match_parent"  
  5.     android:orientation="vertical" >  
  6.   
  7.       
  8.     <Button   
  9.         android:id="@+id/button"  
  10.         android:layout_width="match_parent"  
  11.         android:text="@string/button_name"  
  12.         android:layout_height="48dp"  
  13.         />  
  14.       
  15.       
  16.     <com.github.lzyzsd.jsbridge.BridgeWebView  
  17.         android:id="@+id/webView"  
  18.         android:layout_width="match_parent"  
  19.         android:layout_height="match_parent" >  
  20.      com.github.lzyzsd.jsbridge.BridgeWebView>  
  21.   
  22. LinearLayout>  

  3 Java代码

      
[java]  view plain  copy
 print ?
  1. public class MainActivity extends Activity implements OnClickListener {  
  2.   
  3.     private final String TAG = "MainActivity";  
  4.   
  5.     BridgeWebView webView;  
  6.   
  7.     Button button;  
  8.   
  9.     int RESULT_CODE = 0;  
  10.   
  11.     ValueCallback mUploadMessage;  
  12.   
  13.     static class Location {  
  14.         String address;  
  15.     }  
  16.   
  17.     static class User {  
  18.         String name;  
  19.         Location location;  
  20.         String testStr;  
  21.     }  
  22.   
  23.     @Override  
  24.     protected void onCreate(Bundle savedInstanceState) {  
  25.         super.onCreate(savedInstanceState);  
  26.         setContentView(R.layout.activity_main);  
  27.   
  28.         webView = (BridgeWebView) findViewById(R.id.webView);  
  29.   
  30.         button = (Button) findViewById(R.id.button);  
  31.   
  32.         button.setOnClickListener(this);  
  33.   
  34.         webView.setDefaultHandler(new DefaultHandler());  
  35.   
  36.         webView.setWebChromeClient(new WebChromeClient() {  
  37.   
  38.             @SuppressWarnings("unused")  
  39.             public void openFileChooser(ValueCallback uploadMsg, String AcceptType, String capture) {  
  40.                 this.openFileChooser(uploadMsg);  
  41.             }  
  42.   
  43.             @SuppressWarnings("unused")  
  44.             public void openFileChooser(ValueCallback uploadMsg, String AcceptType) {  
  45.                 this.openFileChooser(uploadMsg);  
  46.             }  
  47.   
  48.             public void openFileChooser(ValueCallback uploadMsg) {  
  49.                 mUploadMessage = uploadMsg;  
  50.                 pickFile();  
  51.             }  
  52.         });  
  53.         //加载本地网页  
  54.   
  55.         //webView.loadUrl("file:///android_asset/demo.html");  
  56.         //加载服务器网页  
  57.         webView.loadUrl("https://www.baidu.com");  
  58.   
  59.         //必须和js同名函数,注册具体执行函数,类似java实现类。  
  60.         webView.registerHandler("submitFromWeb"new BridgeHandler() {  
  61.   
  62.             @Override  
  63.             public void handler(String data, CallBackFunction function) {  
  64.   
  65.                 String str ="这是html返回给java的数据:" + data;  
  66.                 // 例如你可以对原始数据进行处理  
  67.                 makeText(MainActivity.this, str, LENGTH_SHORT).show();  
  68.   
  69.                 Log.i(TAG, "handler = submitFromWeb, data from web = " + data);  
  70.                 function.onCallBack( str + ",Java经过处理后截取了一部分:"+ str.substring(0,5));  
  71.             }  
  72.   
  73.         });  
  74.         //模拟用户获取本地位置  
  75.         User user = new User();  
  76.         Location location = new Location();  
  77.         location.address = "上海";  
  78.         user.location = location;  
  79.         user.name = "Bruce";  
  80.   
  81.         webView.callHandler("functionInJs"new Gson().toJson(user), new CallBackFunction() {  
  82.             @Override  
  83.             public void onCallBack(String data) {  
  84.                 makeText(MainActivity.this"网页在获取你的位置", LENGTH_SHORT).show();  
  85.   
  86.             }  
  87.         });  
  88.   
  89.         webView.send("hello");  
  90.   
  91.     }  
  92.   
  93.     public void pickFile() {  
  94.         Intent chooserIntent = new Intent(Intent.ACTION_GET_CONTENT);  
  95.         chooserIntent.setType("image/*");  
  96.         startActivityForResult(chooserIntent, RESULT_CODE);  
  97.     }  
  98.   
  99.     @Override  
  100.     protected void onActivityResult(int requestCode, int resultCode, Intent intent) {  
  101.         if (requestCode == RESULT_CODE) {  
  102.             if (null == mUploadMessage){  
  103.                 return;  
  104.             }  
  105.             Uri result = intent == null || resultCode != RESULT_OK ? null : intent.getData();  
  106.             mUploadMessage.onReceiveValue(result);  
  107.             mUploadMessage = null;  
  108.         }  
  109.     }  
  110.   
  111.     @Override  
  112.     public void onClick(View v) {  
  113.         if (button.equals(v)) {  
  114.             webView.callHandler("functionInJs""data from Java"new CallBackFunction() {  
  115.   
  116.                 @Override  
  117.                 public void onCallBack(String data) {  
  118.                     // TODO Auto-generated method stub  
  119.                     Log.i(TAG, "reponse data from js " + data);  
  120.                 }  
  121.   
  122.             });  
  123.         }  
  124.   
  125.     }  
  126.   
  127. }  

      
      通过实例化webView,用法和安卓原生的view没多大区别,设置WebChromClient, 设置加载的html(同样支持网络和本地文件),接着我们需要给web注册和html端约定好的js方法名。代码列举的 submitFromweb和js的执行的方法名一致,玩过NDK的JNI调用的朋友也知道必须和c代码之间有个约定,其实js桥和jni有点类似,

通过注册handler来实现回调,Java代码中通过js返回的数据,进行处理后在调用function.onCallback返回给js.这里不做过多解释

[java]  view plain  copy
 print ?
  1. //必须和js同名函数,注册具体执行函数,类似java实现类。  
  2.         webView.registerHandler("submitFromWeb"new BridgeHandler() {  
  3.   
  4.             @Override  
  5.             public void handler(String data, CallBackFunction function) {  
  6.   
  7.                 String str ="这是html返回给java的数据:" + data;  
  8.                 // 例如你可以对原始数据进行处理  
  9.                 makeText(MainActivity.this, str, LENGTH_SHORT).show();  
  10.   
  11.                 Log.i(TAG, "handler = submitFromWeb, data from web = " + data);  
  12.                 function.onCallBack( str + ",Java经过处理后截取了一部分:"+ str.substring(0,5));  
  13.             }  
  14.   
  15.         });  

     如果是webview刚开始就执行一段Java代码 ,可以通过webView.CallHandler()来实现 。当然我们注册的方法也要和js里面的方法名一致。
      
[java]  view plain  copy
 print ?
  1. webView.callHandler("functionInJs"new Gson().toJson(user), new CallBackFunction() {  
  2.            @Override  
  3.            public void onCallBack(String data) {  
  4.             makeText(MainActivity.this"网页在获取你的位置", LENGTH_SHORT).show();  
  5.   
  6.            }  
  7.        });  

  3 Html和js实现

         html代码如下,效果图



    
[html]  view plain  copy
 print ?
  1. <html>  
  2.     <head>  
  3.         <meta content="text/html; charset=utf-8" http-equiv="content-type">  
  4.         <title>  
  5.             js调用java  
  6.         title>  
  7.     head>  
  8.       
  9.     <body>  
  10.         <p>  
  11.             <xmp id="show">  
  12.             xmp>  
  13.         p>  
  14.         <p>  
  15.             <xmp id="init">  
  16.             xmp>  
  17.         p>  
  18.         <p>  
  19.             <input type="text" id="text1" value="用户名(username)" />  
  20.         p>  
  21.         <p>  
  22.             <input type="text" id="text2" value="password" />  
  23.         p>  
  24.         <p>  
  25.             <input type="button" id="enter" value="发消息给Native" onclick="testClick();"  
  26.             />  
  27.         p>  
  28.         <p>  
  29.             <input type="button" id="enter1" value="调用Native方法" onclick="testClick1();"  
  30.             />  
  31.         p>  
  32.         <p>  
  33.             <input type="button" id="enter2" value="显示html" onclick="testDiv();" />  
  34.         p>  
  35.         <p>  
  36.             <input type="file" value="打开文件"  />  
  37.         p>  
  38.     body>  
  39.       
  40. html>  

  js代码


    
[javascript]  view plain  copy
 print ?
  1.    

      这段代码不难理解,我们对上面的id为enter的Button注册了一个点击事件,点击后执行以下testClick()方法,依次类推,其他Button注册事件相同,


     当点击“发消息给Native”的按钮时,Js通过webWiew的jsBridage.send()发送一条数据给java层(密码和用户名),同时在此用function()来执行应java层回调函数的。此demo中是把java返回的数据插入到"show"的div里面去。

   

testClick1():此方法中调用callHandler来调用Java代码的submitFromweb同名函数,可以结合上面的Activty的代码理解下,此函数调用我们已在java注册实现好的

   

[java]  view plain  copy
 print ?
  1. //必须和js同名函数,注册具体执行函数,类似java实现类。  
  2.         webView.registerHandler("submitFromWeb"new BridgeHandler() {  
  3.   
  4.             @Override  
  5.             public void handler(String data, CallBackFunction function) {  
  6.   
  7.                 String str ="这是html返回给java的数据:" + data;  
  8.                 // 例如你可以对原始数据进行处理  
  9.                 makeText(MainActivity.this, str, LENGTH_SHORT).show();  
  10.   
  11.                 Log.i(TAG, "handler = submitFromWeb, data from web = " + data);  
  12.                 function.onCallBack( str + ",Java经过处理后截取了一部分:"+ str.substring(0,5));  
  13.             }  
  14.   
  15.         });  

     java注册Js函数如上面列子 ,那么在js中注册方法来注册呢,

    在js中我们同样可以直接注册一个回调函数,通过 bridge.registerHandler()来注册,接着调用 responseCallback(responseData)来返回数据给java代码的同名函数。f

也可以直接调用init()来指定网页首次加载上面注册java代码。

  

[java]  view plain  copy
 print ?
  1. connectWebViewJavascriptBridge(function(bridge) {  
  2.           bridge.init(function(message, responseCallback) {  
  3.               console.log('JS got a message', message);  
  4.               var data = {  
  5.                   'Javascript Responds''Wee!'  
  6.               };  
  7.               console.log('JS responding with', data);  
  8.               responseCallback(data);  
  9.           });  
  10.   
  11.           bridge.registerHandler("functionInJs", function(data, responseCallback) {  
  12.               document.getElementById("show").innerHTML = ("data from Java: = " + data);  
  13.               var responseData = "Javascript Says Right back aka!";  
  14.               responseCallback(responseData);  
  15.           });  
  16.       })  


四 总结

  
   通过以上的代码示例,不难发现此框架的优雅和简便,对js和java双方来说,如果html中的js需要调用java代码,而java代码没做任何实现,那么这个js也是无效的,反之java代码注册的回调函数,没在js里去实现,那么Java也无法获取js远程数据,由此可见此,此通信是双方的,必须由双发来约定,这样就避免了安卓之前存在js注入漏洞,也很大的提高了安全性,也可以保证我们的网页数据不被第三方的APP获取,怎么说呢,比如你的项目某一html界面,被安卓浏览器或者其他第三方App恶意加载你们的网站或网页,那么它的java代码调用你的js函数,比如由你的Js事先注册或者实现,不然跟本无法调用。这样就保证了这个html的唯一性,第三方可以加载预览你的网页,但是第三方java 不能和你的js交互通信。同样加载第三方的网页时候,我们可以对第三方网页进行一些行为的过滤,进而对用户进行友好提示。
  
    以上代码只是此开源框架一部分功能,还有很多的功能需要我们去挖掘,以后再给大家解剖下此开源项目的内部实现。欢迎阅读


项目开源地址:https://github.com/lzyzsd/JsBridge



你可能感兴趣的:(Android,HTML5)