org.cef.handler

接口 CefRequestHandler

所有已知实现类:

CefClient, CefRequestHandlerAdapter

public interface CefRequestHandler

Implement this interface to handle events related to browser requests. The methods of this class will be called on the thread indicated.

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	CefRequestHandler.TerminationStatus Process termination status values.

方法概要

方法

限定符和类型	方法和说明
boolean	getAuthCredentials(CefBrowser browser, boolean isProxy, String host, int port, String realm, String scheme, CefAuthCallback callback) Called on the IO thread when the browser needs credentials from the user.
CefResourceHandler	getResourceHandler(CefBrowser browser, CefRequest request) Called on the IO thread before a resource is loaded.
boolean	onBeforeBrowse(CefBrowser browser, CefRequest request, boolean is_redirect) Called on the UI thread before browser navigation.
boolean	onBeforeResourceLoad(CefBrowser browser, CefRequest request) Called on the IO thread before a resource request is loaded.
boolean	onCertificateError(CefBrowser browser, CefLoadHandler.ErrorCode cert_error, String request_url, CefRequestCallback callback) Called on the UI thread to handle requests for URLs with an invalid SSL certificate.
void	onPluginCrashed(CefBrowser browser, String pluginPath) Called on the browser process UI thread when a plugin has crashed.
void	onProtocolExecution(CefBrowser browser, String url, BoolRef allow_os_execution) Called on the UI thread to handle requests for URLs with an unknown protocol component.
boolean	onQuotaRequest(CefBrowser browser, 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.
void	onRenderProcessTerminated(CefBrowser browser, CefRequestHandler.TerminationStatus status) Called on the browser process UI thread when the render process terminates unexpectedly.
void	onResourceRedirect(CefBrowser browser, CefRequest request, StringRef new_url) Called on the IO thread when a resource load is redirected.

方法详细资料

onBeforeBrowse

boolean onBeforeBrowse(CefBrowser browser,
                     CefRequest request,
                     boolean is_redirect)

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.

参数:

browser - The corresponding browser.

request - The request itself. Can't be modified.

is_redirect - true if the request was redirected.

返回:

true to cancel or false to allow to proceed.

onBeforeResourceLoad

boolean onBeforeResourceLoad(CefBrowser browser,
                           CefRequest request)

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

参数:

browser - The corresponding browser.

request - The request object may be modified.

callback - The request object may be modified.

返回:

To cancel the request return true otherwise return false.

getResourceHandler

CefResourceHandler getResourceHandler(CefBrowser browser,
                                    CefRequest request)

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.

参数:

browser - The corresponding browser.

request - The request itself. Should not be modified in this callback.

返回:

a CefResourceHandler instance or NULL.

onResourceRedirect

void onResourceRedirect(CefBrowser browser,
                      CefRequest request,
                      StringRef new_url)

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

参数:

browser - The corresponding browser.

request - The request itself. Should not be modified in this callback.

new_url - Contains the new URL and can be changed if desired.

getAuthCredentials

boolean getAuthCredentials(CefBrowser browser,
                         boolean isProxy,
                         String host,
                         int port,
                         String realm,
                         String scheme,
                         CefAuthCallback callback)

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.

参数:

browser - The corresponding browser.

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.

返回:

true to continue the request or false to cancel.

onQuotaRequest

boolean onQuotaRequest(CefBrowser browser,
                     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.

参数:

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.

返回:

true to handle the request or false to cancel the request.

onProtocolExecution

void onProtocolExecution(CefBrowser browser,
                       String url,
                       BoolRef allow_os_execution)

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.

onCertificateError

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

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.

参数:

browser - The corresponding browser.

cert_error - Error code describing the error.

request_url - The requesting URL.

callback - call CefRequestCallback::Continue() to continue or cancel the request.

返回:

true to handle the request or false to reject it.

onPluginCrashed

void onPluginCrashed(CefBrowser browser,
                   String pluginPath)

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

参数:

browser - The corresponding browser.

pluginPath - the path of the plugin that crashed.

onRenderProcessTerminated

void onRenderProcessTerminated(CefBrowser browser,
                             CefRequestHandler.TerminationStatus status)

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