1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
// Copyright (c) 2011 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.
#ifndef CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_DELEGATE_H_
#define CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_DELEGATE_H_
#pragma once
#include <string>
#include "base/basictypes.h"
#include "webkit/glue/resource_type.h"
class GURL;
class ResourceDispatcherHostLoginDelegate;
class ResourceHandler;
class ResourceMessageFilter;
namespace content {
class ResourceContext;
struct ResourceResponse;
}
namespace net {
class AuthChallengeInfo;
class SSLCertRequestInfo;
class URLRequest;
}
namespace content {
// Interface that the embedder provides to ResourceDispatcherHost to allow
// observing and modifying requests.
class ResourceDispatcherHostDelegate {
public:
// Called when a request begins. Return false to abort the request.
virtual bool ShouldBeginRequest(
int child_id,
int route_id,
const std::string& method,
const GURL& url,
ResourceType::Type resource_type,
const content::ResourceContext& resource_context,
const GURL& referrer) = 0;
// Called after ShouldBeginRequest when all the resource handlers from the
// content layer have been added. To add new handlers to the front, return
// a new handler that is chained to the given one, otherwise just reutrn the
// given handler.
virtual ResourceHandler* RequestBeginning(
ResourceHandler* handler,
net::URLRequest* request,
const content::ResourceContext& resource_context,
bool is_subresource,
int child_id,
int route_id) = 0;
// Allows an embedder to add additional resource handlers for a download.
// |is_new_request| is true if this is a request that is just starting, i.e.
// the content layer has just added its own resource handlers; it's false if
// this was originally a non-download request that had some resource handlers
// applied already and now we found out it's a download.
// |in_complete| is true if this is invoked from |OnResponseCompleted|.
virtual ResourceHandler* DownloadStarting(
ResourceHandler* handler,
const content::ResourceContext& resource_context,
net::URLRequest* request,
int child_id,
int route_id,
int request_id,
bool is_new_request,
bool in_complete) = 0;
// Called to determine whether a request's start should be deferred. This
// is only called if the ResourceHandler associated with the request does
// not ask for a deferral. A return value of true will defer the start of
// the request, false will continue the request.
virtual bool ShouldDeferStart(
net::URLRequest* request,
const content::ResourceContext& resource_context) = 0;
// Called when an SSL Client Certificate is requested. If false is returned,
// the request is canceled. Otherwise, the certificate is chosen.
virtual bool AcceptSSLClientCertificateRequest(
net::URLRequest* request,
net::SSLCertRequestInfo* cert_request_info) = 0;
// Called when authentication is required and credentials are needed. If
// false is returned, CancelAuth() is called on the URLRequest and the error
// page is shown. If true is returned, the user will be prompted for
// authentication credentials.
virtual bool AcceptAuthRequest(net::URLRequest* request,
net::AuthChallengeInfo* auth_info) = 0;
// Creates a ResourceDispatcherHostLoginDelegate that asks the user for a
// username and password.
virtual ResourceDispatcherHostLoginDelegate* CreateLoginDelegate(
net::AuthChallengeInfo* auth_info, net::URLRequest* request) = 0;
// Launches the url for the given tab.
virtual void HandleExternalProtocol(const GURL& url,
int child_id,
int route_id) = 0;
// Returns true if we should force the given resource to be downloaded.
// Otherwise, the content layer decides.
virtual bool ShouldForceDownloadResource(
const GURL& url, const std::string& mime_type) = 0;
// Informs the delegate that a response has started.
virtual void OnResponseStarted(
net::URLRequest* request,
ResourceResponse* response,
ResourceMessageFilter* filter) = 0;
// Informs the delegate that a request has been redirected.
virtual void OnRequestRedirected(
net::URLRequest* request,
ResourceResponse* response,
ResourceMessageFilter* filter) = 0;
protected:
ResourceDispatcherHostDelegate() {}
virtual ~ResourceDispatcherHostDelegate() {}
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_DELEGATE_H_
|
