org.cef.handler

类 CefRequestHandlerAdapter

java.lang.Object

org.cef.handler.CefRequestHandlerAdapter

所有已实现的接口:

CefRequestHandler

public abstract class CefRequestHandlerAdapter
extends java.lang.Object
implements CefRequestHandler

An abstract adapter class for receiving browser request events. The methods in this class are empty. This class exists as convenience for creating handler objects.

用于接收浏览器请求事件的抽象适配器类。此类中的方法为空。此类存在是为了创建处理程序对象的便利。

嵌套类概要

从接口继承的嵌套类/接口 org.cef.handler.CefRequestHandler

CefRequestHandler.TerminationStatus

构造器概要

构造器

构造器和说明
CefRequestHandlerAdapter()

方法概要

限定符和类型	方法和说明
boolean	getAuthCredentials(CefBrowser browser, CefFrame frame, boolean isProxy, java.lang.String host, int port, java.lang.String realm, java.lang.String scheme, CefAuthCallback callback) Called on the IO thread when the browser needs credentials from the user. 当浏览器需要来自用户的凭据时，在IO线程上调用。
CefResourceHandler	getResourceHandler(CefBrowser browser, CefFrame frame, CefRequest request) Called on the IO thread before a resource is loaded. 在加载资源之前调用IO线程。
boolean	onBeforeBrowse(CefBrowser browser, CefFrame frame, CefRequest request, boolean user_gesture, boolean is_redirect) Called on the UI thread before browser navigation. 在浏览器导航之前调用UI线程。
boolean	onBeforeResourceLoad(CefBrowser browser, CefFrame frame, CefRequest request) Called on the IO thread before a resource request is loaded. 在加载资源请求之前在IO线程上调用。
boolean	onCertificateError(CefBrowser browser, CefLoadHandler.ErrorCode cert_error, java.lang.String request_url, CefRequestCallback callback) Called on the UI thread to handle requests for URLs with an invalid SSL certificate. 在UI线程上调用以处理具有无效SSL证书的URL请求。
void	onPluginCrashed(CefBrowser browser, java.lang.String pluginPath) Called on the browser process UI thread when a plugin has crashed. 当插件崩溃时，在浏览器进程UI线程上调用。
void	onProtocolExecution(CefBrowser browser, java.lang.String url, BoolRef allow_os_execution) Called on the UI thread to handle requests for URLs with an unknown protocol component. 在UI线程上调用以处理具有未知协议组件的URL的请求。
boolean	onQuotaRequest(CefBrowser browser, java.lang.String origin_url, long new_size, CefRequestCallback callback) Called on the IO thread when JavaScript requests a specific storage quota size via the webkitStorageInfo.requestQuota function. 当JavaScript通过webkitStorageInfo.requestQuota函数请求特定的存储配额大小时，在IO线程上调用。
void	onRenderProcessTerminated(CefBrowser browser, CefRequestHandler.TerminationStatus status) Called on the browser process UI thread when the render process terminates unexpectedly. 当渲染过程意外终止时，在浏览器进程UI线程上调用。
void	onResourceLoadComplete(CefBrowser browser, CefFrame frame, CefRequest request, CefResponse response, CefURLRequest.Status status, long receivedContentLength) Called on the IO thread when a resource load has completed. 资源加载完成后在IO线程上调用。
void	onResourceRedirect(CefBrowser browser, CefFrame frame, CefRequest request, CefResponse response, StringRef new_url) Called on the IO thread when a resource load is redirected. 重定向资源加载时在IO线程上调用。
boolean	onResourceResponse(CefBrowser browser, CefFrame frame, CefRequest request, CefResponse response) Called on the IO thread when a resource response is received. 收到资源响应时，在IO线程上调用。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

CefRequestHandlerAdapter

public CefRequestHandlerAdapter()

方法详细资料

getAuthCredentials

public boolean getAuthCredentials(CefBrowser browser,
                                  CefFrame frame,
                                  boolean isProxy,
                                  java.lang.String host,
                                  int port,
                                  java.lang.String realm,
                                  java.lang.String scheme,
                                  CefAuthCallback callback)

从接口复制的说明: CefRequestHandler

Called on the IO thread when the browser needs credentials from the user. Return true to continue the request and call CefAuthCallback::Continue() when the authentication information is available. Return false to cancel the request.

当浏览器需要来自用户的凭据时，在IO线程上调用。返回true以继续请求并在身份验证信息可用时调用CefAuthCallback :: Continue（）。返回false以取消请求。

指定者:

getAuthCredentials 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

isProxy - indicates whether the host is a proxy server. - 指示主机是否是代理服务器。

host - contains the hostname. - 包含主机名。

port - contains the port number. - 包含端口号。

realm - The realm of the request. - 请求的领域。

scheme - The scheme of the request. - 请求的方案。

callback - call CefAuthCallback::Continue() when the authentication information is available. - 当身份验证信息可用时，调用CefAuthCallback :: Continue（）。

返回:

true to continue the request or false to cancel. 如果继续请求，则为true;如果取消，则为false

getResourceHandler

public CefResourceHandler getResourceHandler(CefBrowser browser,
                                             CefFrame frame,
                                             CefRequest request)

从接口复制的说明: CefRequestHandler

Called on the IO thread before a resource is loaded. To allow the resource to load normally return NULL. To specify a handler for the resource return a CefResourceHandler object. The |request| object should not be modified in this callback.

在加载资源之前调用IO线程。允许资源正常加载返回NULL。要为资源指定处理程序，请返回CefResourceHandler对象。 |请求|不应在此回调中修改对象。

指定者:

getResourceHandler 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

request - The request itself. Should not be modified in this callback. - 请求本身。不应该在此回调中修改。

返回:

a CefResourceHandler instance or NULL. 一个CefResourceHandler实例或NULL。

onBeforeBrowse

public boolean onBeforeBrowse(CefBrowser browser,
                              CefFrame frame,
                              CefRequest request,
                              boolean user_gesture,
                              boolean is_redirect)

从接口复制的说明: CefRequestHandler

Called on the UI thread before browser navigation. Return true to cancel the navigation or false to allow the navigation to proceed. The request object cannot be modified in this callback. CefLoadHandler.onLoadingStateChange() will be called twice in all cases. If the navigation is allowed CefLoadHandler.onLoadStart() and CefLoadHandler.onLoadEnd() will be called. If the navigation is canceled CefLoadHandler.onLoadError() will be called with an errorCode value of ERR_ABORTED.

在浏览器导航之前调用UI线程。返回true以取消导航，返回false以允许导航继续。无法在此回调中修改请求对象。在所有情况下，CefLoadHandler.onLoadingStateChange（）将被调用两次。如果允许导航，则将调用CefLoadHandler.onLoadStart（）和CefLoadHandler.onLoadEnd（）。如果导航被取消，将调用CefLoadHandler.onLoadError（），其errorCode值为ERR_ABORTED。

指定者:

onBeforeBrowse 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

request - The request itself. Can't be modified. - 请求本身。无法修改。

user_gesture - true if the request was initiated by a user gesture. - 如果请求是由用户手势发起的，则为true。

is_redirect - true if the request was redirected. - 如果请求被重定向，则为true。

返回:

true to cancel or false to allow to proceed. 如果取消，则为true;如果允许，则为false。

onBeforeResourceLoad

public boolean onBeforeResourceLoad(CefBrowser browser,
                                    CefFrame frame,
                                    CefRequest request)

从接口复制的说明: CefRequestHandler

Called on the IO thread before a resource request is loaded.

在加载资源请求之前在IO线程上调用。

指定者:

onBeforeResourceLoad 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

request - The request object may be modified. - 可以修改请求对象。

返回:

To cancel the request return true otherwise return false. 要取消请求，请返回true，否则返回false。

onCertificateError

public boolean onCertificateError(CefBrowser browser,
                                  CefLoadHandler.ErrorCode cert_error,
                                  java.lang.String request_url,
                                  CefRequestCallback callback)

从接口复制的说明: CefRequestHandler

Called on the UI thread to handle requests for URLs with an invalid SSL certificate. Return true and call CefAllowCertificateErrorCallback:: Continue() either in this method or at a later time to continue or cancel the request. Return false to cancel the request immediately. If callback is empty the error cannot be recovered from and the request will be canceled automatically. If "ignore-certificate-errors" command-line switch is set all invalid certificates will be accepted without calling this method.

在UI线程上调用以处理具有无效SSL证书的URL请求。返回true并在此方法中或稍后调用CefAllowCertificateErrorCallback :: Continue（）以继续或取消请求。返回false以立即取消请求。如果回调为空，则无法恢复错误，请求将自动取消。如果设置了“ignore-certificate-errors”命令行开关，则无需调用此方法即可接受所有无效证书。

指定者:

onCertificateError 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

cert_error - Error code describing the error. - 描述错误的错误代码。

request_url - The requesting URL. - 请求URL。

callback - call CefRequestCallback::Continue() to continue or cancel the request. - 调用CefRequestCallback :: Continue（）继续或取消请求。

返回:

true to handle the request or false to reject it. true表示处理请求，false表示拒绝请求。

onPluginCrashed

public void onPluginCrashed(CefBrowser browser,
                            java.lang.String pluginPath)

从接口复制的说明: CefRequestHandler

Called on the browser process UI thread when a plugin has crashed.

当插件崩溃时，在浏览器进程UI线程上调用。

指定者:

onPluginCrashed 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

pluginPath - the path of the plugin that crashed. - 崩溃的插件的路径。

onProtocolExecution

public void onProtocolExecution(CefBrowser browser,
                                java.lang.String url,
                                BoolRef allow_os_execution)

从接口复制的说明: CefRequestHandler

Called on the UI thread to handle requests for URLs with an unknown protocol component. Set |allow_os_execution| to true to attempt execution via the registered OS protocol handler, if any. SECURITY WARNING: YOU SHOULD USE THIS METHOD TO ENFORCE RESTRICTIONS BASED ON SCHEME, HOST OR OTHER URL ANALYSIS BEFORE ALLOWING OS EXECUTION.

在UI线程上调用以处理具有未知协议组件的URL的请求。设置| allow_os_execution |如果有，则尝试通过已注册的OS协议处理程序执行。安全警告：在允许执行操作系统之前，您应该使用此方法根据方案，主机或其他URL分析来执行限制。

指定者:

onProtocolExecution 在接口中 CefRequestHandler

onQuotaRequest

public boolean onQuotaRequest(CefBrowser browser,
                              java.lang.String origin_url,
                              long new_size,
                              CefRequestCallback callback)

从接口复制的说明: CefRequestHandler

Called on the IO thread when JavaScript requests a specific storage quota size via the webkitStorageInfo.requestQuota function.

当JavaScript通过webkitStorageInfo.requestQuota函数请求特定的存储配额大小时，在IO线程上调用。

指定者:

onQuotaRequest 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

origin_url - is the origin of the page making the request. - 是发出请求的页面的来源。

new_size - is the requested quota size in bytes. - 是请求的配额大小（以字节为单位）。

callback - call CefRequestCallback::Continue() either in this method or at a later time to grant or deny the request. - 在此方法中或稍后调用CefRequestCallback :: Continue（）以授予或拒绝请求。

返回:

true to handle the request or false to cancel the request. true表示处理请求，false表示取消请求。

onRenderProcessTerminated

public void onRenderProcessTerminated(CefBrowser browser,
                                      CefRequestHandler.TerminationStatus status)

从接口复制的说明: CefRequestHandler

Called on the browser process UI thread when the render process terminates unexpectedly. |status| indicates how the process terminated.

当渲染过程意外终止时，在浏览器进程UI线程上调用。 |状态|表示进程是如何终止的。

指定者:

onRenderProcessTerminated 在接口中 CefRequestHandler

onResourceLoadComplete

public void onResourceLoadComplete(CefBrowser browser,
                                   CefFrame frame,
                                   CefRequest request,
                                   CefResponse response,
                                   CefURLRequest.Status status,
                                   long receivedContentLength)

从接口复制的说明: CefRequestHandler

Called on the IO thread when a resource load has completed. |request| and |response| represent the request and response respectively and cannot be modified in this callback. |status| indicates the load completion status. |received_content_length| is the number of response bytes actually read.

资源加载完成后在IO线程上调用。 |要求|和|响应|分别代表请求和响应，不能在此回调中修改。 |状态|表示装载完成状态。 | received_content_length |是实际读取的响应字节数。

指定者:

onResourceLoadComplete 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

request - The request itself. Should not be modified in this callback. - 请求本身。不应该在此回调中修改。

response - The response that resulted in the redirect. Should not be modified in this callback. - 导致重定向的响应。不应该在此回调中修改。

status - The load completion status - 负载完成状态

receivedContentLength - The number of bytes read - 读取的字节数

onResourceRedirect

public void onResourceRedirect(CefBrowser browser,
                               CefFrame frame,
                               CefRequest request,
                               CefResponse response,
                               StringRef new_url)

从接口复制的说明: CefRequestHandler

Called on the IO thread when a resource load is redirected.

重定向资源加载时在IO线程上调用。

指定者:

onResourceRedirect 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

request - The request itself. Should not be modified in this callback. - 请求本身。不应该在此回调中修改。

response - The response that resulted in the redirect. Should not be modified in this callback. - 导致重定向的响应。不应该在此回调中修改。

new_url - Contains the new URL and can be changed if desired. - 包含新URL，如果需要可以更改。

onResourceResponse

public boolean onResourceResponse(CefBrowser browser,
                                  CefFrame frame,
                                  CefRequest request,
                                  CefResponse response)

从接口复制的说明: CefRequestHandler

Called on the IO thread when a resource response is received. To allow the resource to load normally return false. To redirect or retry the resource modify |request| (url, headers or post body) and return true. The |response| object cannot be modified in this callback.

收到资源响应时，在IO线程上调用。允许资源正常加载返回false。要重定向或重试资源修改|请求| （网址，标题或帖子正文）并返回true。 |响应|在此回调中无法修改对象。

指定者:

onResourceResponse 在接口中 CefRequestHandler

参数:

browser - The corresponding browser. - 相应的浏览器。

frame - The frame generating the event. Instance only valid within the scope of this method. - 生成事件的帧。实例仅在此方法的范围内有效。

request - The request itself. To redirect or retry the resource modify |request| (url, headers or post body) and return true - 请求本身。要重定向或重试资源修改|请求| （网址，标题或帖子正文）并返回true

response - The response that resulted in the redirect. Should not be modified in this callback. - 导致重定向的响应。不应该在此回调中修改。

返回:

True if request modified or false otherwise 如果请求被修改则为True，否则为false