1// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_H_
6#define CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_H_
7
8#include "base/callback_forward.h"
9#include "net/base/net_errors.h"
10
11namespace net {
12class URLRequest;
13}
14
15namespace content {
16
17class DownloadItem;
18class ResourceContext;
19class ResourceDispatcherHostDelegate;
20struct DownloadSaveInfo;
21struct Referrer;
22
23class CONTENT_EXPORT ResourceDispatcherHost {
24 public:
25  typedef base::Callback<void(DownloadItem*, net::Error)>
26    DownloadStartedCallback;
27
28  // Returns the singleton instance of the ResourceDispatcherHost.
29  static ResourceDispatcherHost* Get();
30
31  // This does not take ownership of the delegate. It is expected that the
32  // delegate have a longer lifetime than the ResourceDispatcherHost.
33  virtual void SetDelegate(ResourceDispatcherHostDelegate* delegate) = 0;
34
35  // Controls whether third-party sub-content can pop-up HTTP basic auth
36  // dialog boxes.
37  virtual void SetAllowCrossOriginAuthPrompt(bool value) = 0;
38
39  // Initiates a download by explicit request of the renderer (e.g. due to
40  // alt-clicking a link) or some other chrome subsystem.
41  // |is_content_initiated| is used to indicate that the request was generated
42  // from a web page, and hence may not be as trustworthy as a browser
43  // generated request.  If |download_id| is invalid, a download id will be
44  // automatically assigned to the request, otherwise the specified download id
45  // will be used.  (Note that this will result in re-use of an existing
46  // download item if the download id was already assigned.)  If the download
47  // is started, |started_callback| will be called on the UI thread with the
48  // DownloadItem; otherwise an error code will be returned.
49  virtual net::Error BeginDownload(
50      scoped_ptr<net::URLRequest> request,
51      const Referrer& referrer,
52      bool is_content_initiated,
53      ResourceContext* context,
54      int child_id,
55      int route_id,
56      bool prefer_cache,
57      scoped_ptr<DownloadSaveInfo> save_info,
58      uint32 download_id,
59      const DownloadStartedCallback& started_callback) = 0;
60
61  // Clears the ResourceDispatcherHostLoginDelegate associated with the request.
62  virtual void ClearLoginDelegateForRequest(net::URLRequest* request) = 0;
63
64  // Causes all new requests for the route identified by |child_id| and
65  // |route_id| to be blocked (not being started) until
66  // ResumeBlockedRequestsForRoute is called.
67  virtual void BlockRequestsForRoute(int child_id, int route_id) = 0;
68
69  // Resumes any blocked request for the specified route id.
70  virtual void ResumeBlockedRequestsForRoute(int child_id, int route_id) = 0;
71
72 protected:
73  virtual ~ResourceDispatcherHost() {}
74};
75
76}  // namespace content
77
78#endif  // CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_H_
79