android webView笔记

WebView 概述：

       WebView(网络视图)能加载显示网页，可以将其视为一个浏览器。WebView内部实现是采用渲染引擎来展示view的内容，提供网页前进后退，网页放大，缩小，搜索等。

1.WebView的基本使用：

1.在要Activity中实例化WebView组件：WebView webView = new WebView(this);

2.调用WebView的loadUrl()方法，设置WevView要显示的网页：
       互联网用：webView.loadUrl("http://www.google.com");
       本地文件用：webView.loadUrl("file:///android_asset/XX.html"); 本地文件存放在：assets 文件中

3.调用Activity的setContentView( )方法来显示网页视图

4.加入网络权限<uses-permissionandroid:name="android.permission.INTERNET"/>

2.WebView API使用详解

1）请求加载网页部分

public void loadData (String data, String mimeType, String encoding) 

加载指定的data数据

参数说明：

data  字符串String形式的数据 可以通过base64编码而来

mineType data数据的 MIME类型， e.g. 'text/html'

encoding data数据的编码格式

注：

1.Javascript有同源限制，同源策略限制了一个源中加载文本或者脚本与来自其他源中的数据交互方式。避免这种限制可以使用loadDataWithBaseURL()方法。

2.encoding参数制定data参数是否为base64或者 URL 编码，如果data是base64编码那么 encoding必须填写 "base64“。

public void loadDataWithBaseURL (String baseUrl, String data, String mimeType, String encoding, String historyUrl)  

使用baseUrl加载base URL的网页内容，baseUrl解决相关url使用Javascript相同源问题。

public void loadUrl (String url) 

加载制定url的网页内容

public void loadUrl (String url, Map<String, String> additionalHttpHeaders)  

加载制定url并携带http header数据。

public void reload ()  重新加载页面。注：<span style="color:#ff0000;">页面所有资源会重新加载</span><pre name="code" class="java"> public void stopLoading ()  

停止加载

2) 前进后退

<pre name="code" class="java">public void goBack ()  

public void goForward ()  

public void goBackOrForward (int steps) 

以当前的index为起始点前进或者后退到历史记录中指定的steps，  如果steps为负数则为后退，正数则为前进

public boolean canGoForward ()

<span><span></span></span><pre name="code" class="java"><pre name="code" class="java"><span style="font-size:10px;"><span style="font-size: 15px;">检查是否有可以前进的历史记录。</span></span>

public boolean canGoBack ()

<span><span></span></span><pre name="code" class="java"><pre name="code" class="java"><pre name="code" class="java"><span style="font-size:10px;"><span style="font-size: 15px;">检查是否有可以后退的历史记录。</span></span>

3)JavaScript操作

public void addJavascriptInterface (Object object, String name) 

当网页需要和App进行交互时，可以注入Java对象提供给JavaScritp调用.  Java对象提供相应的方法供js使用.

可以通过getSettings()获得WebSettings，然后用setJavaScriptEnabled()使能JavaScript：

注：（重要）

问题：在Android 4.2以下使用这个api会涉及到JavaScript安全问题， javascript可以通过反射这个java对象的相关类进行攻击。

解决：可以采用白名单的机制调用这个方法.

在Android4.2极其以上系统需要给提供js调用的方法前加入一个注视：@JavaScriptInterface; 在虚拟机当中 Javascript调用Java方法会检测这个anotation，如果方法被标识@JavaScriptInterface则Javascript可以成功调用这个Java方法，否则调用不成功。

example：

class JsObject {     @JavascriptInterface     public String toString() { return "injectedObject"; }  }  webView.addJavascriptInterface(new JsObject(), "injectedObject"); 

public void evaluateJavascript (String script, ValueCallback<String> resultCallback)  

这个方法在Android 4.4系统引入，因此只能在Android4.4系统中才能使用，提供在当前页面显示上下文中异步执行javascript代码

注：（重要）

这个方法必须在UI线程调用，这个函数的回调也会在UI线程执行。

那么在Android4.4一下如何执行javascrit代码呢

可以通过 WebView提供的loadUrl方法：具体格式如下：

    webView.loadUrl("javascript:alert(injectedObject.toString())");  

其中javascript: 是执行javascript代码的标识 ， 后面是javascript语句。

    public void removeJavascriptInterface (String name)  

删除addJavascripInterface时对webview注入的java对象. 此方法在不同的Android系统WebView会有问题，会存在失效情况。

4）网页查找功能

public void findAllAsync (String find) 

异步执行查找网页内包含的字符并设置高亮，查找结果会回调.

public void findNext (boolean forward) 

查找下一个匹配的字符

example：

    public class TestFindListener implements android.webkit.WebView.FindListener {          private FindListener mFindListener;                public TestFindListener(FindListener findListener) {              mFindListener = findListener;          }                @Override          public void onFindResultReceived(int activeMatchOrdinal, int numberOfMatches,                  boolean isDoneCounting) {              mFindListener.onFindResultReceived(activeMatchOrdinal, numberOfMatches, isDoneCounting);          }      }               public void findAllAsync(String searchString) {             if (android.os.Build.VERSION_CODES.JELLY_BEAN <= Build.VERSION.SDK_INT)                 mWebView.findAllAsync(searchString);             else {                 int number = mWebView.findAll(searchString);                 if (mIKFindListener !=null)                     mIKFindListener.onFindResultReceived(number);                 fixedFindAllHighLight();  // 参见我之前一篇博文Android WebView API findAll bug             }         }                  mWebView.findNext(forward);  

5）数据清除

    public void clearCache (boolean includeDiskFiles)  

清除网页访问留下的缓存，由于内核缓存是全局的因此这个方法不仅仅针对webview而是针对整个应用程序.

public void clearFormData () 

这个api仅仅清除自动完成填充的表单数据，并不会清除WebView存储到本地的数据。

    public void clearHistory ()  

清除当前webview访问的历史记录，只会webview访问历史记录里的所有记录除了当前访问记录.

    public void clearMatches ()  

清除网页查找的高亮匹配字符

3.WebViewClient API详解

1）网页加载时机部分

public boolean shouldOverrideUrlLoading(WebView view, String url) 

当加载的网页需要重定向的时候就会回调这个函数告知我们应用程序是否需要接管控制网页加载，如果应用程序接管，并且return true意味着主程序接管网页加载，如果返回false让webview自己处理。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url    即将要被加载的url

@return  true 当前应用程序要自己处理这个url， 返回false则不处理。

Tips

(1) 当请求的方式是"POST"方式时这个回调是不会通知的。

(2) 当我们访问的地址需要我们应用程序自己处理的时候，可以在这里截获，比如我们发现跳转到的是一个market的链接，那么我们可以直接跳转到应用市场，或者其他app。

public void onPageStarted(WebView view, String url, Bitmap favicon)  

当内核开始加载访问的url时，会通知应用程序，对每个main frame这个函数只会被调用一次，页面包含iframe 或者framesets 不会另外调用一次onPageStarted，当网页内内嵌的frame 发生改变时也不会调用onPageStarted。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url    即将要被加载的url

@param favicon 如果这个favicon已经存储在本地数据库中，则会返回这个网页的favicon，否则返回为null。

Tips：

(1) iframe 可能不少人不知道什么含义，这里我解释下，iframe 我们加载的一张，下面有很多链接，我们随便点击一个链接是即当前host的一个iframe.

(2) 有个问题可能是开发者困惑的，onPageStarted和shouldOverrideUrlLoading 在网页加载过程中这两个函数到底哪个先被调用。

     当我们通过loadUrl的方式重新加载一个网址时候，这时候会先调用onPageStarted再调用shouldOverrideUrlLoading，当我们在打开的这个网址点击一个link，这时候会先调用shouldOverrideUrlLoading 再调用onPageStarted。不过shouldOverrideUrlLoading不一定每次都被调用，只有需要的时候才会被调用。

public void onPageFinished(WebView view, String url)  

当内核加载完当前页面时会通知我们的应用程序，这个函数只有在main frame情况下才会被调用，当调用这个函数之后，渲染的图片不会被更新，如果需要获得新图片的通知可以使用@link WebView.PictureListener#onNewPicture。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url    即将要被加载的url

    public void onLoadResource(WebView view, String url)  

通知应用程序WebView即将加载url 制定的资源

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url    即将加载的url 资源

public WebResourceResponse shouldInterceptRequest(WebView view,              String url) 

通知应用程序内核即将加载url制定的资源，应用程序可以返回本地的资源提供给内核，若本地处理返回数据，内核不从网络上获取数据。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url    raw url 制定的资源

@return 返回WebResourceResponse包含数据对象，或者返回null

Tips

这个回调并不一定在UI线程执行，所以我们需要注意在这里操作View或者私有数据相关的动作。

如果我们需要改变网页的背景，或者需要实现网页页面颜色定制化的需求，可以在这个回调时机处理。

public void onReceivedError(WebView view, int errorCode,              String description, String failingUrl)

当浏览器访问制定的网址发生错误时会通知我们应用程序，比如网络错误。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param errorCode 错误号可以在WebViewClient.ERROR_* 里面找到对应的错误名称。

@param description 描述错误的信息

@param failingUrl  当前访问失败的url，注意并不一定是我们主url

Tips

在onReceiveError我们可以自定义网页的错误页面。

    public void onFormResubmission(WebView view, Message dontResend,                  Message resend)  

如果浏览器需要重新发送POST请求，可以通过这个时机来处理。默认是不重新发送数据。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param dontResent 当浏览器不需要重新发送数据时，可以使用这个参数。

@param resent 当浏览器需要重新发送数据时， 可以使用这个参数。

    public void doUpdateVisitedHistory(WebView view, String url,                  boolean isReload)  

通知应用程序可以将当前的url存储在数据库中，意味着当前的访问url已经生效并被记录在内核当中。这个函数在网页加载过程中只会被调用一次。注意网页前进后退并不会回调这个函数。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url 当前正在访问的url 

@ param isReload 如果是true 这个是正在被reload的url

    public void onReceivedSslError(WebView view, SslErrorHandler handler,                  SslError error)  

当网页加载资源过程中发现SSL错误会调用此方法。我们应用程序必须做出响应，是取消请求handler.cancel(),还是继续请求handler.proceed();内核的默认行为是handler.cancel();

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param handler 处理用户请求的对象。

@param error  SSL错误对象

Tips

内核会记住本次选择，如果下次还有相同的错误，内核会直接执行之前选择的结果。

public void onReceivedHttpAuthRequest(WebView view,              HttpAuthHandler handler, String host, String realm) 

通知应用程序WebView接收到了一个Http auth的请求，应用程序可以使用supplied 设置webview的响应请求。默认行为是cancel 本次请求。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param handler 用来响应WebView请求的对象

@param host  请求认证的host

@param realm 认真请求所在的域

    public boolean shouldOverrideKeyEvent(WebView view, KeyEvent event)   

提供应用程序同步一个处理按键事件的机会，菜单快捷键需要被过滤掉。如果返回true，webview不处理该事件，如果返回false， webview会一直处理这个事件，因此在view 链上没有一个父类可以响应到这个事件。默认行为是return false；

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param  event 键盘事件名

@return  如果返回true,应用程序处理该时间，返回false 交有webview处理。

    public void onScaleChanged(WebView view, float oldScale, float newScale)  

通知应用程序webview 要被scale。应用程序可以处理改事件，比如调整适配屏幕。

public void onReceivedLoginRequest(WebView view, String realm,              String account, String args) 

通知应用程序有个自动登录的帐号过程

参数说明：

@param view 请求登陆的webview

@param realm 账户的域名，用来查找账户。

@param account 一个可选的账户，如果是null 需要和本地的账户进行check， 如果是一个可用的账户，则提供登录。

@param  args  验证制定参数的登录用户

4. WebChromeClient API详解

    public void onProgressChanged(WebView view, int newProgress)  

通知应用程序当前网页加载的进度。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

public void onReceivedTitle(WebView view, String title)  

当document 的title变化时，会通知应用程序

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param title  document新的title

Tips

这个函数调用时机不确定，有可能很早，有可能很晚，取决于网页把title设置在什么位置，大多数网页一般把title设置到页面的前面，因此很多情况会比较早回调到这个函数。

public void onReceivedIcon(WebView view, Bitmap icon) 

当前页面有个新的favicon时候，会回调这个函数。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param icon 当前页面的favicon

public void onReceivedTouchIconUrl(WebView view, String url,              boolean precomposed)

通知应用程序 apple-touch-icon的 url 

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。

@param url  apple-touch-icon 的服务端地址

@param precomposed  如果precomposed 是true 则touch-icon是预先创建的

Tips 

如果应用程序需要这个icon的话， 可以通过这个url获取得到 icon。

public void onShowCustomView(View view, CustomViewCallback callback)  

通知应用程序webview需要显示一个custom view，主要是用在视频全屏HTML5Video support。

参数说明：

@param view 即将要显示的view

@param callback  当view 需要dismiss 则使用这个对象进行回调通知。

public void onHideCustomView()  

退出视频通知

public boolean onCreateWindow(WebView view, boolean isDialog,                  boolean isUserGesture, Message resultMsg)  

请求创建一个新的窗口，如果我们应用程序接管这个请求，必须返回true，并且创建一个新的webview来承载主窗口。

如果应用程序不处理，则需要返回false，默认行为和返回false表现一样。

参数说明：

@param view 请求创建新窗口的webview

@param isUserGesture 如果是true，则说明是来自用户收拾操作行为，比如用户点击链接

@param isDialog true 请求创建的新窗口必须是个dialog，而不是全屏的窗口。

@param resultMsg 当webview创建时需要发送一个消息。WebView.WebViewTransport.setWebView(WebView)

Tips 具体例子如下：

      private void createWindow(final Message msg) {      WebView.WebViewTransport transport = (WebView.WebViewTransport) msg.obj;      final Tab newTab = mWebViewController.openTab(null, Tab.this, true,              true);      transport.setWebView(newTab.getWebView());      msg.sendToTarget();        }  

    public void onRequestFocus(WebView view)  

webview请求得到focus，发生这个主要是当前webview不是前台状态，是后台webview。

    public void onCloseWindow(WebView window)  

通知应用程序从关闭传递过来的webview并从view tree中remove。

    public boolean onJsAlert(WebView view, String url, String message,                  JsResult result)  

通知应用程序显示javascript alert对话框，如果应用程序返回true内核认为应用程序处理这个消息，返回false，内核自己处理。

参数说明：

@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。
@param url 当前请求弹出javascript 对话框webview 加载的url地址。

@param message 弹出的内容信息

@result 用来响应用户的处理。

Tips

如果我们应用接管处理， 则必须给出result的结果，result.cancel,result.comfirm必须调用其中之后，否则内核会hang住。

    public boolean onJsConfirm(WebView view, String url, String message,                  JsResult result)  

通知应用程序提供confirm 对话框。

参数说明同上onJsAlert

    public boolean onJsPrompt(WebView view, String url, String message,                  String defaultValue, JsPromptResult result)  

通知应用程序显示一个prompt对话框。 

Tips

必须调用result.confirm 方法如果应用程序接管这个方法。

    public boolean onJsBeforeUnload(WebView view, String url, String message,                  JsResult result)  

通知应用程序显示一个对话框，让用户选择是否离开当前页面，这个回调是javascript中的onbeforeunload事件，如果客户端返回true，内核会认为客户端提供对话框。默认行为是return false。

参数说明和之前介绍的onJsAlert()相同。

public void onExceededDatabaseQuota(String url, String databaseIdentifier,              long quota, long estimatedDatabaseSize, long totalQuota,              WebStorage.QuotaUpdater quotaUpdater) 

通知应用程序webview内核web sql 数据库超出配额，请求是否扩大数据库磁盘配额。默认行为是不会增加数据库配额。

参数说明：

@param url 触发这个数据库配额的url地址

@param databaseIdentifier  指示出现数据库超过配额的标识。

@param quota   原始数据库配额的大小，是字节单位bytes

@param estimatedDatabaseSize  到达底线的数据大小 bytes

@param totalQuota 总的数据库配额大小 bytes

@param quotaUpdater 更新数据库配额的对象，可以使用 quotaUpdater.updateQuota(newQuota);配置新的数据库配额大小。

    public void onReachedMaxAppCacheSize(long requiredStorage, long quota,                  WebStorage.QuotaUpdater quotaUpdater)  

通知应用程序内核已经到达最大的appcache。

appcache是HTML5针对offline的一个数据处理标准。

public void onGeolocationPermissionsShowPrompt(String origin,              GeolocationPermissions.Callback callback) 

当前页面请求是否允许进行定位。

GeolocationPermissions.Callback的使用

public void invoke(String origin, boolean allow, boolean retain);

参数说明：

@param origin 权限设置的源地址

@param allow 是否允许定位

@retain 当前的选择是否让内核记住。

    public void onGeolocationPermissionsHidePrompt()  

    public void openFileChooser(ValueCallback<Uri> uploadFile, String acceptType, String capture)  

这个回调是私有回调， 当页面需要请求打开系统的文件选择器，则会回调这个方法，比如我们需要上传图片，请求拍照，邮件的附件上传等等操作。

如果不实现这个私有API，则上面的请求都将不会执行。

5.WebSettings API详解

调用WebSettings设置的所有函数是异步制定的，因此我们设置某个状态并不能马上生效。

    public synchronized void setLoadsImagesAutomatically(boolean flag)  

设置当前webview是否需要加载图片，这个标记控制整个webview的状态，并且对所有的资源都采取这种策略。如果设置为false 那么访问的当前网址中的所以图片资源将不会被加载。默认值是true；

public synchronized void setBlockNetworkImage (boolean flag)

当getLoadsImagesAutomatically返回true这个方法才有效， 默认值为：false；

public void setCacheMode(int mode) 

一个普通网页的加载cache会被检查，内容也会被重新校验，第一次访问网页时，会存储cache到本地，设置策略可以让网页加载方式发生变化，cache模式有如下几种:

LOAD_DEFAULT: 如果我们应用程序没有设置任何cachemode， 这个是默认的cache方式。 加载一张网页会检查是否有cache，如果有并且没有过期则使用本地cache，否则                                   从网络上获取。

LOAD_CACHE_ELSE_NETWORK: 使用cache资源，即使过期了也使用，如果没有cache才从网络上获取。

LOAD_NO_CACHE: 不使用cache 全部从网络上获取

LOAD_CACHE_ONLY:  只使用cache上的内容。

    public void setLoadWithOverviewMode(boolean overview)  

概览模式的设置，默认指是false。

    public synchronized void setJavaScriptEnabled (boolean flag)  

默认值是false.  如果我们网页需要javascript时，需要开启这个设置，否则网页加载不全。

webSettings.setUseWideViewPort(true);//设置此属性，可任意比例缩放webSettings.setLoadWithOverviewMode(true);

打开页面时， 自适应屏幕

WebSettings webSettings =   mWebView .getSettings();       webSettings.setJavaScriptEnabled(true);  webSettings.setBuiltInZoomControls(true);webSettings.setSupportZoom(true);

便页面支持缩放

webview.requestFocusFromTouch();

如果webView中需要用户手动输入用户名、密码或其他，则webview必须设置支持获取手势焦点。

setJavaScriptEnabled(true);  //支持jssetPluginsEnabled(true);  //支持插件 setUseWideViewPort(false);  //将图片调整到适合webview的大小 setSupportZoom(true);  //支持缩放 setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); //支持内容重新布局  supportMultipleWindows();  //多窗口 setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);  //关闭webview中缓存 setAllowFileAccess(true);  //设置可以访问文件 setNeedInitialFocus(true); //当webview调用requestFocus时为webview设置节点webview webSettings.setBuiltInZoomControls(true); //设置支持缩放 setJavaScriptCanOpenWindowsAutomatically(true); //支持通过JS打开新窗口 setLoadWithOverviewMode(true); // 缩放至屏幕的大小setLoadsImagesAutomatically(true);  //支持自动加载图片