// Copyright (c) 2014 The Chromium Embedded Framework Authors. All rights

// reserved. Use of this source code is governed by a BSD-style license that

// can be found in the LICENSE file.

package org.cef.handler;

import org.cef.browser.CefBrowser;

import org.cef.browser.CefFrame;

import org.cef.handler.CefResourceRequestHandler;

import org.cef.misc.BoolRef;

import org.cef.network.CefRequest;

/**

* Implement this interface to provide handler implementations.

*/

public interface CefRequestContextHandler {

/**

* Called on the IO thread before a resource request is initiated. The |browser| and |frame|

* values represent the source of the request. This method will not be called if the client

* associated with |browser| returns a non-null value from

* CefRequestHandler.getResourceRequestHandler for the same request (identified by

* CefRequest.getIdentifier).

*

* @param browser The corresponding browser.

* @param frame The frame generating the event. Instance only valid within the scope of this

* method.

* @param request The request itself. Cannot be modified in this callback. Instance only valid

* within the scope of this method.

* @param isNavigation True if the resource request is a navigation.

* @param isDownload True if the resource request is a download.

* @param requestInitiator The origin (scheme + domain) of the page that initiated the request.

* @param disableDefaultHandling Set to true to disable default handling of the request, in

* which case it will need to be handled via

* CefResourceRequestHandler.getResourceHandler or it will be canceled.

* @return A CefResourceRequestHandler instance or null.

*/

CefResourceRequestHandler getResourceRequestHandler(CefBrowser browser, CefFrame frame,

CefRequest request, boolean isNavigation, boolean isDownload, String requestInitiator,

BoolRef disableDefaultHandling);

}