转载请注明出处  http://blog.csdn.net/typename/article/details/39495409powered by miechal zhao

概览：

Android WebView 做为承载网页的载体控件，他在网页显示的过程中会产生一些事件，并回调给我们的应用程序，以便我们在网页加载过程中做应用程序想处理的事情。比如说客户端需要显示网页加载的进度、网页加载发生错误等等事件。 WebView提供两个事件回调类给应用层，分别为WebViewClient,WebChromeClient开发者可以继承这两个类，接手相应事件处理。WebViewClient 主要提供网页加载各个阶段的通知，比如网页开始加载onPageStarted，网页结束加载onPageFinished等；WebChromeClient主要提供网页加载过程中提供的数据内容，比如返回网页的title,favicon等。

1.WebViewClient的基本使用

创建WebViewClient实例并设置到WebView对象中，具体代码参考如下：
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. classMyAndroidWebViewClientextendsWebViewClient {
  2. @Override
  3. publicvoidonPageStarted(WebView view, String url, Bitmap favicon) {
  4. // TODO
  5. }
  6. @Override
  7. publicvoidonPageFinished(WebView view, String url) {
  8. // TODO
  9. }
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. }
  2. webview.setWebViewClient(newMyAndroidWebViewClient ());

2.WebViewClient API详解

1）网页加载时机部分
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanshouldOverrideUrlLoading(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。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonPageStarted(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不一定每次都被调用，只有需要的时候才会被调用。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonPageFinished(WebView view, String url)

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

参数说明：
@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。
@param url    即将要被加载的url

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonLoadResource(WebView view, String url)

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

参数说明：
@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。
@param url    即将加载的url 资源

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicWebResourceResponse shouldInterceptRequest(WebView view,
  2. String url)

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

参数说明：
@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，即是这个webview。
@param url    raw url 制定的资源
@return 返回WebResourceResponse包含数据对象，或者返回null

Tips
这个回调并不一定在UI线程执行，所以我们需要注意在这里操作View或者私有数据相关的动作。
如果我们需要改变网页的背景，或者需要实现网页页面颜色定制化的需求，可以在这个回调时机处理。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedError(WebView view,interrorCode,
  2. String description, String failingUrl)

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

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

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

@param description 描述错误的信息
@param failingUrl  当前访问失败的url，注意并不一定是我们主url
Tips
在onReceiveError我们可以自定义网页的错误页面。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonFormResubmission(WebView view, Message dontResend,
  2. Message resend)

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

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

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

@param resent 当浏览器需要重新发送数据时， 可以使用这个参数。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoiddoUpdateVisitedHistory(WebView view, String url,
  2. booleanisReload)

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

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

@param url 当前正在访问的url

@ param isReload 如果是true 这个是正在被reload的url
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedSslError(WebView view, SslErrorHandler handler,
  2. SslError error)

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

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

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

@param error  SSL错误对象
Tips
内核会记住本次选择，如果下次还有相同的错误，内核会直接执行之前选择的结果。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedHttpAuthRequest(WebView view,
  2. 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 认真请求所在的域
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanshouldOverrideKeyEvent(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处理。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonScaleChanged(WebView view,floatoldScale,floatnewScale)

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

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedLoginRequest(WebView view, String realm,
  2. String account, String args)

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

参数说明：
@param view 请求登陆的webview
@param realm 账户的域名，用来查找账户。
@param account 一个可选的账户，如果是null 需要和本地的账户进行check， 如果是一个可用的账户，则提供登录。
@param  args  验证制定参数的登录用户
3.WebChromeClient 基本使用

4. WebChromeClient API详解

创建WebChromeClient实例并设置到WebView对象中，具体代码参考如下：
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonProgressChanged(WebView view,intnewProgress)

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

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

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedTitle(WebView view, String title)

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

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

@param title  document新的title

Tips
这个函数调用时机不确定，有可能很早，有可能很晚，取决于网页把title设置在什么位置，大多数网页一般把title设置到页面的前面，因此很多情况会比较早回调到这个函数。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedIcon(WebView view, Bitmap icon)

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

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

@param icon 当前页面的favicon

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReceivedTouchIconUrl(WebView view, String url,
  2. booleanprecomposed)
通知应用程序 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。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonShowCustomView(View view, CustomViewCallback callback)

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

参数说明：
@param view 即将要显示的view
@param callback  当view 需要dismiss 则使用这个对象进行回调通知。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonHideCustomView()

退出视频通知

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanonCreateWindow(WebView view,booleanisDialog,
  2. booleanisUserGesture, Message resultMsg)

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

如果应用程序不处理，则需要返回false，默认行为和返回false表现一样。
参数说明：
@param view 请求创建新窗口的webview
@param isUserGesture 如果是true，则说明是来自用户收拾操作行为，比如用户点击链接
@param isDialog true 请求创建的新窗口必须是个dialog，而不是全屏的窗口。
@param resultMsg 当webview创建时需要发送一个消息。WebView.WebViewTransport.setWebView(WebView)
Tips 具体例子如下：
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. privatevoidcreateWindow(finalMessage msg) {
  2. WebView.WebViewTransport transport = (WebView.WebViewTransport) msg.obj;
  3. finalTab newTab = mWebViewController.openTab(null, Tab.this,true,
  4. true);
  5. transport.setWebView(newTab.getWebView());
  6. msg.sendToTarget();
  7. }
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonRequestFocus(WebView view)

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

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonCloseWindow(WebView window)

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

[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanonJsAlert(WebView view, String url, String message,
  2. 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住。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanonJsConfirm(WebView view, String url, String message,
  2. JsResult result)

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

参数说明同上onJsAlert
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanonJsPrompt(WebView view, String url, String message,
  2. String defaultValue, JsPromptResult result)

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

Tips
必须调用result.confirm 方法如果应用程序接管这个方法。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicbooleanonJsBeforeUnload(WebView view, String url, String message,
  2. JsResult result)

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

参数说明和之前介绍的onJsAlert()相同。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonExceededDatabaseQuota(String url, String databaseIdentifier,
  2. longquota,longestimatedDatabaseSize,longtotalQuota,
  3. 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);配置新的数据库配额大小。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonReachedMaxAppCacheSize(longrequiredStorage,longquota,
  2. WebStorage.QuotaUpdater quotaUpdater)

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

appcache是HTML5针对offline的一个数据处理标准。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonGeolocationPermissionsShowPrompt(String origin,
  2. GeolocationPermissions.Callback callback)

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

GeolocationPermissions.Callback的使用
public void invoke(String origin, boolean allow, boolean retain);
参数说明：
@param origin 权限设置的源地址
@param allow 是否允许定位
@retain 当前的选择是否让内核记住。
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidonGeolocationPermissionsHidePrompt()
[java] view plaincopy在CODE上查看代码片派生到我的代码片

  1. publicvoidopenFileChooser(ValueCallback<Uri> uploadFile, String acceptType, String capture)

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

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

Android WebView 开发详解(二)相关推荐

  1. Android openGl开发详解(二)

    https://zhuanlan.zhihu.com/p/35192609 Android openGl开发详解(二)--通过SurfaceView,TextureView,GlSurfaceView ...

  2. Android openGl开发详解(二)——通过SurfaceView，TextureView，GlSurfaceView显示相机预览（附Demo）

    最近公司在做自定义相机这一块,之前使用的是第三方,后来需求变更,第三方不支持添加动态贴纸,所以只能自己扩展.当然网上有很多例子,但是关于添加动态贴纸的例子几乎找不到,反正我是没找到(欲哭无泪).当然, ...

  3. Android WebView 开发详解(一)

    转载请注明出处  http://blog.csdn.net/typename/article/details/39030091 powered by meichal zhao 概览: Android ...

  4. Android WebView 开发详解(三)

    转载请注明出处   http://blog.csdn.net/typename/article/details/40302351 powered by miechal zhao 概览 Android ...

  5. 全志 android 编译,全志Android SDK编译详解(二)

    注意要确定安装了jdk) 第一步: cd  lichee; ./build.sh  -p sun5i_elite -k 3.0  (apt-get install uboot-mkimage需要安装m ...

  6. android开发照相机啊,Android照相机开发详解（一）

    Android相机开发详解(一) Android相机开发详解(一) 请支持原创,尊重原创,转载请注明出处:http://blog.csdn.net/kangweijian(来自kangweijian的 ...

  7. Android USB 开发详解

    Android USB 开发详解 先附上 Android USB 官方文档 Android通过两种模式支持各种 USB 外设和 Android USB 附件(实现Android附件协议的硬件):USB ...

  8. Android相机开发详解（一）

    Android相机开发详解(一) 请支持原创,尊重原创,转载请注明出处:http://blog.csdn.net/kangweijian(来自kangweijian的csdn博客) Android相机 ...

  9. 《Android游戏开发详解》——第1章，第1.6节函数（在Java中称为“方法”更好）...

    本节书摘来自异步社区<Android游戏开发详解>一书中的第1章,第1.6节函数(在Java中称为"方法"更好),作者 [美]Jonathan S. Harbour,更 ...

最新文章

  1. js运动动画的八个知识点
  2. 【异常（待解决）】org.apache.http.NoHttpResponseException: api.weixin.qq.com:443 failed to respond...
  3. 苏宁易购唱共享之歌，共享干衣、共享数据、共享快递盒为哪般？
  4. android dialog activity 窗口全透明,Android Dialog形式的Activity
  5. [原创]java WEB学习笔记18：java EE 中的MVC 设计模式(理论)
  6. web 端可交互的离线渲染器，求 star～
  7. 如何查询Linux软件安装源,Zypper——suse软件查询 安装 升级 与 软件源编辑
  8. Windows的CRT中的setlocale()
  9. 2021年南京市高考成绩查询,2021年南京高考各高中成绩及本科升学率数据排名及分析...
  10. 后缀–ize_英语常用后缀-ize
  11. mysql blob 读取 图片_mysql中以blob形式存储的图片文件 通过ajax方式传输 在js中设置成img控件的src...
  12. PHP中mq是什么,MQ是什么
  13. 电脑版微信小程序全屏显示方法，手机横屏方法。
  14. 学python大数据培训
  15. kestrel虚拟服务器,如何使Kestrel Web服务器监听非本地主机的请求？
  16. 《C++Primer》学习笔记（6-10章）
  17. 第47章 QR-Decoder-OV5640二维码识别—零死角玩转STM32-F429系列
  18. 基于STC89C52RC模块的巡线小车
  19. 光刻胶剥离和光掩模清洁的工艺顺序
  20. 5.2JVM生命周期以及类加载

热门文章

  1. php 循环curl,PHP实现的curl批量请求操作示例
  2. angularjs 让当前路由重新加载_Spring Cloud Gateway的动态路由怎样做？集成Nacos实现很简单...
  3. 网站接入QQ登录最新2020 java版本
  4. DocKer linux Centos 安装DocKer 只需要十步
  5. 二叉树的中序遍历—leetcode94
  6. FreeBSD挂截U盘和光盘
  7. Android代码片段:设备信息
  8. /MD, /MDD, /ML, /MT,/MTD(使用运行时库)
  9. #1398 : 网络流五·最大权闭合子图
  10. TCP滑动窗口和拥塞控制机制