3.1 问题
应用程序需要访问WebView中当前显示内容的HTML源代码,读取或修改其中的某个值。
3.2 解决方案
(API Level 1)
创建一个JavaScript接口,作为WebView和应用程序代码间的桥梁。
3.3 实现机制
WebView.addJavascriptInterface()会为JavaScript绑定一个Java对象,这样就可以在WebView中调用此Java对象的方法。借助这个接口,就可以使用JavaScript在应用程序代码和WebView的HTML间编组数据了。
警告:
允许Javascript控制应用程序会存在安全威胁——允许远程执行应用程序的代码。请在确实需要使用时再使用本接口。
让我们来实际看一个示例。以下代码清单展示了WebView从本地assets目录中加载一个简单的HTML表单。以下代码清单则是一个使用了两个Javascript函数的Activity,这两个函数用来在Activity首选项与WebView的内容间交换数据。
assets/form.html
含有Javascript桥梁接口的Activity
public class MyActivity extends Activity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
WebView webview = new WebView(this);
//Javascript is not enabled by default
webview.getSettings().setJavaScriptEnabled(true);
webview.setWebViewClient(mClient);
//Attach the custom interface to the view
webview.addJavascriptInterface(new MyJavaScriptInterface(), "BRIDGE");
setContentView(webview);
webview.loadUrl("file:///android_asset/form.html");
}
private static final String JS_SETELEMENT =
"javascript:document.getElementById('%s').value='%s'";
private static final String JS_GETELEMENT =
"javascript:window.BRIDGE.storeElement('%s',document.getElementById('%s').value)";
private static final String ELEMENTID = "emailAddress";
private WebViewClient mClient = new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
//Before leaving the page, attempt to retrieve the email using JavaScript
executeJavascript(view,
String.format(JS_GETELEMENT, ELEMENTID, ELEMENTID) );
return false;
}
@Override
public void onPageFinished(WebView view, String url) {
//When page loads, inject address into page using JavaScript
SharedPreferences prefs = getPreferences(Activity.MODE_PRIVATE);
executeJavascript(view,
String.format(JS_SETELEMENT, ELEMENTID, prefs.getString(ELEMENTID, "")) );
}
};
private void executeJavascript(WebView view, String script) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
view.evaluateJavascript(script, null);
} else {
view.loadUrl(script);
}
}
private class MyJavaScriptInterface {
//Store an element in preferences
@JavascriptInterface
public void storeElement(String id, String element) {
SharedPreferences.Editor edit = getPreferences(Activity.MODE_PRIVATE).edit();
edit.putString(id, element);
edit.commit();
//If element is valid, raise a Toast
if(!TextUtils.isEmpty(element)) {
Toast.makeText(MyActivity.this, element, Toast.LENGTH_SHORT).show();
}
}
}
}
在这个稍微有点儿人为性质的示例中,在HTML中创建一个包含单个元素的表单并显示在WebView中。在Acivity的代码中,我们使用"emailAddress"这个ID在WebView中查找一个表单值,并在每次点击页面中的链接时(在本例中,就是单击表单的Submit按钮),通过shouldOverrideUrlLoading()回调把该值存储到SharedPreference中。每次页面加载结束后(即调用onPageFinished时),我们会视图将当前的值从SharedPreference重新注入Web表单中。
注意:
WebView中默认不启用JavaScript。为了不注入甚至渲染JavaScript,我们必须在初始化视图时调用WebSettings.setJavaScriptEnabled(true)。
我们创建了一个称作MyJavaScriptInterface的Java类,它定义了storeElement()方法。在创建了视图后,我们调用WebView.addJavascriptInterface()方法来把这个类的对象关联到视图上,并且给它起名BRIDGE。当调用此方法时,字符串参数就是用于在JavaScript代码中引用此接口的名称。
在这里,我们用字符串常量定义了两个JavaScript方法:JS_GETELEMENT和JS_SETELEMENT。在Android4.4之前,我们通过调用之前已经看到过的loadUri()方法在WebView上执行这些方法。然而,在API Level 19和以后的版本中,我们在WebView中新的用法evaluateJavascript()来达到此目的。示例代码验证当前使用的API Level,并且调用适当的方法。
注意,JS_GETELEMENT是一个引用,用来调用我们自定义的接口函数(如BRIDGE.storeElement),它将调用MyJavaScriptInterface的方法并把表单元素的值存储到首选项中。如果检查到表单中的值不为空,则还会显示一个Toast。
使用这种方式,可以在WebView中执行任意的JavaScript脚本,在自定义的接口中可以不需要包含任何方法。例如,JS_SETELEMENT使用纯JavaScript脚本来设置页面中表单元素的值。
经常使用这项技术的应用程序需要记住用户在应用程序中输入的表单数据,但表单必须是基于Web的,例如Web应用程序的预约表单或支付表单,而Web应用程序需要较高Level的API才可以访问。