org.cef.handler

接口 CefResourceRequestHandler

所有已知实现类:

CefResourceRequestHandlerAdapter

public interface CefResourceRequestHandler

Implement this interface to handle events related to browser requests. The methods of this class will be called on the IO thread unless otherwise indicated. (实现此接口以处理与浏览器请求相关的事件。除非另有说明，否则将在IO线程上调用此类的方法。)

方法概要

限定符和类型	方法和说明
CefCookieAccessFilter	getCookieAccessFilter(CefBrowser browser, CefFrame frame, CefRequest request) Called on the IO thread before a resource is loaded. (加载资源之前在IO线程上调用。)
CefResourceHandler	getResourceHandler(CefBrowser browser, CefFrame frame, CefRequest request) Called on the IO thread before a resource is loaded. (加载资源之前在IO线程上调用。)
boolean	onBeforeResourceLoad(CefBrowser browser, CefFrame frame, CefRequest request) Called on the IO thread before a resource request is loaded. (在加载资源请求之前在IO线程上调用。)
void	onProtocolExecution(CefBrowser browser, CefFrame frame, CefRequest request, BoolRef allowOsExecution) Called on the IO thread to handle requests for URLs with an unknown protocol component. (在IO线程上调用，以处理对具有未知协议组件的URL的请求。)
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线程上调用。)

方法详细资料

getCookieAccessFilter

CefCookieAccessFilter getCookieAccessFilter(CefBrowser browser,
                                            CefFrame frame,
                                            CefRequest request)

Called on the IO thread before a resource is loaded. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. (加载资源之前在IO线程上调用。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。)

参数:

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

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

request - The request itself. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求本身。无法在此回调中修改。实例仅在此方法的范围内有效。)

返回:

A CefCookieAccessFilter instance or null. (CefCookieAccessFilter实例，或者为null。)

getResourceHandler

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

Called on the IO thread before a resource is loaded. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. (加载资源之前在IO线程上调用。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。)

参数:

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

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

request - The request itself. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求本身。无法在此回调中修改。实例仅在此方法的范围内有效。)

返回:

A CefResourceHandler instance or null. (一个CefResourceHandler实例，或者为null。)

onBeforeResourceLoad

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

Called on the IO thread before a resource request is loaded. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. To redirect or change the resource load optionally modify |request|. Modification of the request URL will be treated as a redirect. (在加载资源请求之前在IO线程上调用。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。要重定向或更改资源负载，可以选择| request |。请求URL的修改将被视为重定向。)

参数:

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

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

request - The request itself. May be modified in this callback. Instance only valid within the scope of this method. (-请求本身。可以在此回调中进行修改。实例仅在此方法的范围内有效。)

返回:

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

onProtocolExecution

void onProtocolExecution(CefBrowser browser,
                         CefFrame frame,
                         CefRequest request,
                         BoolRef allowOsExecution)

Called on the IO thread to handle requests for URLs with an unknown protocol component. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. SECURITY WARNING: YOU SHOULD USE THIS METHOD TO ENFORCE RESTRICTIONS BASED ON SCHEME, HOST OR OTHER URL ANALYSIS BEFORE ALLOWING OS EXECUTION. (在IO线程上调用，以处理对具有未知协议组件的URL的请求。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。安全警告：在允许执行OS之前，您应该使用此方法来强制基于方案，主机或其他URL分析的限制。)

参数:

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

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

request - The request itself. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求本身。无法在此回调中修改。实例仅在此方法的范围内有效。)

allowOsExecution - Set to true to attempt execution via the registered OS protocol handler, if any. (-设置为true以尝试通过注册的OS协议处理程序执行（如果有）。)

onResourceLoadComplete

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. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. This method will be called for all requests, including requests that are aborted due to CEF shutdown or destruction of the associated browser. In cases where the associated browser is destroyed this callback may arrive after the CefLifeSpanHandler.onBeforeClose callback for that browser. The CefFrame.isValid method can be used to test for this situation, and care should be taken not to call |browser| or |frame| methods that modify state (like loadURL, sendProcessMessage, etc.) if the frame is invalid. (资源加载完成后在IO线程上调用。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。所有请求都将调用此方法，包括因CEF关闭或相关浏览器销毁而中止的请求。如果关联的浏览器被销毁，则该回调可能在该浏览器的CefLifeSpanHandler.onBeforeClose回调之后到达。 CefFrame.isValid方法可用于测试这种情况，并且应注意不要调用| browser |。或| frame |如果框架无效，则修改状态的方法（例如loadURL，sendProcessMessage等）。)

参数:

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

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

request - The request itself. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求本身。无法在此回调中修改。实例仅在此方法的范围内有效。)

response - The request response. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求响应。无法在此回调中修改。实例仅在此方法的范围内有效。)

status - The load completion status. (-加载完成状态。)

receivedContentLength - The number of bytes read. (-读取的字节数。)

onResourceRedirect

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

Called on the IO thread when a resource load is redirected. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. The |request| parameter will contain the old URL and other request-related information. (重定向资源负载时在IO线程上调用。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。 |请求|参数将包含旧的URL和其他与请求相关的信息。)

参数:

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

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

request - The request itself. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求本身。无法在此回调中修改。实例仅在此方法的范围内有效。)

response - The response that resulted in the redirect. Cannot be modified in this callback. Instance only valid within the scope of this method. (-导致重定向的响应。无法在此回调中修改。实例仅在此方法的范围内有效。)

new_url - Contains the new URL and can be changed if desired. (-包含新网址，可以根据需要进行更改。)

onResourceResponse

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

Called on the IO thread when a resource response is received. The |browser| and |frame| values represent the source of the request, and may be null for requests originating from service workers or CefURLRequest. To allow the resource load to proceed without modification return false. To redirect or retry the resource load optionally modify |request| and return true. Modification of the request URL will be treated as a redirect. Requests handled using the default network loader cannot be redirected in this callback. (收到资源响应时在IO线程上调用。 |浏览器|和| frame |值代表请求的来源，对于源自服务工作者或CefURLRequest的请求，可以为null。要允许资源加载不进行修改就返回false。要重定向或重试资源负载，可以选择| request |。并返回true。请求URL的修改将被视为重定向。使用默认网络加载器处理的请求无法在此回调中重定向。)

参数:

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

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

request - The request itself. May be modified in this callback. Instance only valid within the scope of this method. (-请求本身。可以在此回调中进行修改。实例仅在此方法的范围内有效。)

response - The request response. Cannot be modified in this callback. Instance only valid within the scope of this method. (-请求响应。无法在此回调中修改。实例仅在此方法的范围内有效。)

返回:

True if |request| was modified or false otherwise (如果| request |，则为true被修改，否则为假)