blob: eb25debee1629dbd1f075d435b258aa8822e5ff8 [file] [log] [blame]
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <stdint.h>
#include <memory>
#include <string>
#include "base/callback_forward.h"
#include "content/common/content_export.h"
#include "net/base/request_priority.h"
namespace net {
class URLRequest;
namespace content {
class ResourceContext;
class ResourceDispatcherHostDelegate;
// This value is returned by header interceptors below, to determine if a
// request should proceed based on the values of HTTP headers.
enum class HeaderInterceptorResult {
// Allow the request to proceed with the given headers.
// Force the request to fail, since the headers were not supported values.
// Force the request to fail and kill the renderer process, since it attempted
// to use an illegal header value that could pose a security risk.
// This callback is invoked when the interceptor finishes processing the
// header.
// Parameter 1 indicates whether to continue the request, fail it, or kill the
// renderer process (and fail it).
typedef base::Callback<void(HeaderInterceptorResult)> OnHeaderProcessedCallback;
// This callback is registered by interceptors who are interested in being
// notified of certain HTTP headers in outgoing requests. For e.g. Origin.
// Parameter 1 contains the HTTP header.
// Parameter 2 contains its value.
// Parameter 3 contains the child process id.
// Parameter 4 contains the current ResourceContext.
// Parameter 5 contains the callback which needs to be invoked once the
// interceptor finishes its processing.
typedef base::Callback<void(const std::string&,
const std::string&,
class CONTENT_EXPORT ResourceDispatcherHost {
// Returns the singleton instance of the ResourceDispatcherHost.
static ResourceDispatcherHost* Get();
// This does not take ownership of the delegate. It is expected that the
// delegate have a longer lifetime than the ResourceDispatcherHost.
virtual void SetDelegate(ResourceDispatcherHostDelegate* delegate) = 0;
// Controls whether third-party sub-content can pop-up HTTP basic auth
// dialog boxes.
virtual void SetAllowCrossOriginAuthPrompt(bool value) = 0;
// Registers the |interceptor| for the |http_header| passed in.
// The |starts_with| parameter is used to match the prefix of the
// |http_header| in the response and the interceptor will be invoked if there
// is a match. If the |starts_with| parameter is empty, the interceptor will
// be invoked for every occurrence of the |http_header|.
// Currently only HTTP header based interceptors are supported.
// At the moment we only support one interceptor per |http_header|.
virtual void RegisterInterceptor(const std::string& http_header,
const std::string& starts_with,
const InterceptorCallback& interceptor) = 0;
// Updates the priority for |request|. Modifies request->priority(), and may
// start the request loading if it wasn't already started.
virtual void ReprioritizeRequest(net::URLRequest* request,
net::RequestPriority priority) = 0;
virtual ~ResourceDispatcherHost() {}
} // namespace content