Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(125)

Side by Side Diff: net/base/network_delegate.h

Issue 734263003: Move data reduction proxy logic out of chrome and android webview network delegate (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Adding inits to DRPNetworkDelegate Created 6 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 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 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 #ifndef NET_BASE_NETWORK_DELEGATE_H_ 5 #ifndef NET_BASE_NETWORK_DELEGATE_H_
6 #define NET_BASE_NETWORK_DELEGATE_H_ 6 #define NET_BASE_NETWORK_DELEGATE_H_
7 7
8 #include <string> 8 #include <string>
9 9
10 #include "base/callback.h" 10 #include "base/callback.h"
(...skipping 110 matching lines...) Expand 10 before | Expand all | Expand 10 after
121 // desired. 121 // desired.
122 // |callback| and |new_url| are valid only until OnURLRequestDestroyed is 122 // |callback| and |new_url| are valid only until OnURLRequestDestroyed is
123 // called for this request. Returns a net status code, generally either OK to 123 // called for this request. Returns a net status code, generally either OK to
124 // continue with the request or ERR_IO_PENDING if the result is not ready yet. 124 // continue with the request or ERR_IO_PENDING if the result is not ready yet.
125 // A status code other than OK and ERR_IO_PENDING will cancel the request and 125 // A status code other than OK and ERR_IO_PENDING will cancel the request and
126 // report the status code as the reason. 126 // report the status code as the reason.
127 // 127 //
128 // The default implementation returns OK (continue with request). 128 // The default implementation returns OK (continue with request).
129 virtual int OnBeforeURLRequest(URLRequest* request, 129 virtual int OnBeforeURLRequest(URLRequest* request,
130 const CompletionCallback& callback, 130 const CompletionCallback& callback,
131 GURL* new_url); 131 GURL* new_url) = 0;
132 132
133 // Called as the proxy is being resolved for |url|. Allows the delegate to 133 // Called as the proxy is being resolved for |url|. Allows the delegate to
134 // override the proxy resolution decision made by ProxyService. The delegate 134 // override the proxy resolution decision made by ProxyService. The delegate
135 // may override the decision by modifying the ProxyInfo |result|. 135 // may override the decision by modifying the ProxyInfo |result|.
136 virtual void OnResolveProxy(const GURL& url, 136 virtual void OnResolveProxy(const GURL& url,
137 int load_flags, 137 int load_flags,
138 const ProxyService& proxy_service, 138 const ProxyService& proxy_service,
139 ProxyInfo* result); 139 ProxyInfo* result) = 0;
140 140
141 // Called when use of |bad_proxy| fails due to |net_error|. |net_error| is 141 // Called when use of |bad_proxy| fails due to |net_error|. |net_error| is
142 // the network error encountered, if any, and OK if the fallback was 142 // the network error encountered, if any, and OK if the fallback was
143 // for a reason other than a network error (e.g. the proxy service was 143 // for a reason other than a network error (e.g. the proxy service was
144 // explicitly directed to skip a proxy). 144 // explicitly directed to skip a proxy).
145 virtual void OnProxyFallback(const ProxyServer& bad_proxy, 145 virtual void OnProxyFallback(const ProxyServer& bad_proxy,
146 int net_error); 146 int net_error) = 0;
147 147
148 // Called right before the HTTP headers are sent. Allows the delegate to 148 // Called right before the HTTP headers are sent. Allows the delegate to
149 // read/write |headers| before they get sent out. |callback| and |headers| are 149 // read/write |headers| before they get sent out. |callback| and |headers| are
150 // valid only until OnCompleted or OnURLRequestDestroyed is called for this 150 // valid only until OnCompleted or OnURLRequestDestroyed is called for this
151 // request. 151 // request.
152 // See OnBeforeURLRequest for return value description. Returns OK by default. 152 // See OnBeforeURLRequest for return value description. Returns OK by default.
153 virtual int OnBeforeSendHeaders(URLRequest* request, 153 virtual int OnBeforeSendHeaders(URLRequest* request,
154 const CompletionCallback& callback, 154 const CompletionCallback& callback,
155 HttpRequestHeaders* headers); 155 HttpRequestHeaders* headers) = 0;
156 156
157 // Called after a proxy connection. Allows the delegate to read/write 157 // Called after a proxy connection. Allows the delegate to read/write
158 // |headers| before they get sent out. |headers| is valid only until 158 // |headers| before they get sent out. |headers| is valid only until
159 // OnCompleted or OnURLRequestDestroyed is called for this request. 159 // OnCompleted or OnURLRequestDestroyed is called for this request.
160 virtual void OnBeforeSendProxyHeaders(URLRequest* request, 160 virtual void OnBeforeSendProxyHeaders(URLRequest* request,
161 const ProxyInfo& proxy_info, 161 const ProxyInfo& proxy_info,
162 HttpRequestHeaders* headers); 162 HttpRequestHeaders* headers) = 0;
163 163
164 // Called right before the HTTP request(s) are being sent to the network. 164 // Called right before the HTTP request(s) are being sent to the network.
165 // |headers| is only valid until OnCompleted or OnURLRequestDestroyed is 165 // |headers| is only valid until OnCompleted or OnURLRequestDestroyed is
166 // called for this request. 166 // called for this request.
167 virtual void OnSendHeaders(URLRequest* request, 167 virtual void OnSendHeaders(URLRequest* request,
168 const HttpRequestHeaders& headers); 168 const HttpRequestHeaders& headers) = 0;
169 169
170 // Called for HTTP requests when the headers have been received. 170 // Called for HTTP requests when the headers have been received.
171 // |original_response_headers| contains the headers as received over the 171 // |original_response_headers| contains the headers as received over the
172 // network, these must not be modified. |override_response_headers| can be set 172 // network, these must not be modified. |override_response_headers| can be set
173 // to new values, that should be considered as overriding 173 // to new values, that should be considered as overriding
174 // |original_response_headers|. 174 // |original_response_headers|.
175 // If the response is a redirect, and the Location response header value is 175 // If the response is a redirect, and the Location response header value is
176 // identical to |allowed_unsafe_redirect_url|, then the redirect is never 176 // identical to |allowed_unsafe_redirect_url|, then the redirect is never
177 // blocked and the reference fragment is not copied from the original URL 177 // blocked and the reference fragment is not copied from the original URL
178 // to the redirection target. 178 // to the redirection target.
179 // 179 //
180 // |callback|, |original_response_headers|, and |override_response_headers| 180 // |callback|, |original_response_headers|, and |override_response_headers|
181 // are only valid until OnURLRequestDestroyed is called for this request. 181 // are only valid until OnURLRequestDestroyed is called for this request.
182 // See OnBeforeURLRequest for return value description. Returns OK by default. 182 // See OnBeforeURLRequest for return value description. Returns OK by default.
183 virtual int OnHeadersReceived( 183 virtual int OnHeadersReceived(
184 URLRequest* request, 184 URLRequest* request,
185 const CompletionCallback& callback, 185 const CompletionCallback& callback,
186 const HttpResponseHeaders* original_response_headers, 186 const HttpResponseHeaders* original_response_headers,
187 scoped_refptr<HttpResponseHeaders>* override_response_headers, 187 scoped_refptr<HttpResponseHeaders>* override_response_headers,
188 GURL* allowed_unsafe_redirect_url); 188 GURL* allowed_unsafe_redirect_url) = 0;
189 189
190 // Called right after a redirect response code was received. 190 // Called right after a redirect response code was received.
191 // |new_location| is only valid until OnURLRequestDestroyed is called for this 191 // |new_location| is only valid until OnURLRequestDestroyed is called for this
192 // request. 192 // request.
193 virtual void OnBeforeRedirect(URLRequest* request, 193 virtual void OnBeforeRedirect(URLRequest* request,
194 const GURL& new_location); 194 const GURL& new_location) = 0;
195 195
196 // This corresponds to URLRequestDelegate::OnResponseStarted. 196 // This corresponds to URLRequestDelegate::OnResponseStarted.
197 virtual void OnResponseStarted(URLRequest* request); 197 virtual void OnResponseStarted(URLRequest* request) = 0;
198 198
199 // Called every time we read raw bytes. 199 // Called every time we read raw bytes.
200 virtual void OnRawBytesRead(const URLRequest& request, int bytes_read); 200 virtual void OnRawBytesRead(const URLRequest& request, int bytes_read) = 0;
201 201
202 // Indicates that the URL request has been completed or failed. 202 // Indicates that the URL request has been completed or failed.
203 // |started| indicates whether the request has been started. If false, 203 // |started| indicates whether the request has been started. If false,
204 // some information like the socket address is not available. 204 // some information like the socket address is not available.
205 virtual void OnCompleted(URLRequest* request, bool started); 205 virtual void OnCompleted(URLRequest* request, bool started) = 0;
206 206
207 // Called when an URLRequest is being destroyed. Note that the request is 207 // Called when an URLRequest is being destroyed. Note that the request is
208 // being deleted, so it's not safe to call any methods that may result in 208 // being deleted, so it's not safe to call any methods that may result in
209 // a virtual method call. 209 // a virtual method call.
210 virtual void OnURLRequestDestroyed(URLRequest* request); 210 virtual void OnURLRequestDestroyed(URLRequest* request) = 0;
211 211
212 // Corresponds to ProxyResolverJSBindings::OnError. 212 // Corresponds to ProxyResolverJSBindings::OnError.
213 virtual void OnPACScriptError(int line_number, 213 virtual void OnPACScriptError(int line_number,
214 const base::string16& error); 214 const base::string16& error) = 0;
215 215
216 // Called when a request receives an authentication challenge 216 // Called when a request receives an authentication challenge
217 // specified by |auth_info|, and is unable to respond using cached 217 // specified by |auth_info|, and is unable to respond using cached
218 // credentials. |callback| and |credentials| must be non-NULL, and must 218 // credentials. |callback| and |credentials| must be non-NULL, and must
219 // be valid until OnURLRequestDestroyed is called for |request|. 219 // be valid until OnURLRequestDestroyed is called for |request|.
220 // 220 //
221 // The following return values are allowed: 221 // The following return values are allowed:
222 // - AUTH_REQUIRED_RESPONSE_NO_ACTION: |auth_info| is observed, but 222 // - AUTH_REQUIRED_RESPONSE_NO_ACTION: |auth_info| is observed, but
223 // no action is being taken on it. 223 // no action is being taken on it.
224 // - AUTH_REQUIRED_RESPONSE_SET_AUTH: |credentials| is filled in with 224 // - AUTH_REQUIRED_RESPONSE_SET_AUTH: |credentials| is filled in with
225 // a username and password, which should be used in a response to 225 // a username and password, which should be used in a response to
226 // |auth_info|. 226 // |auth_info|.
227 // - AUTH_REQUIRED_RESPONSE_CANCEL_AUTH: The authentication challenge 227 // - AUTH_REQUIRED_RESPONSE_CANCEL_AUTH: The authentication challenge
228 // should not be attempted. 228 // should not be attempted.
229 // - AUTH_REQUIRED_RESPONSE_IO_PENDING: The action will be decided 229 // - AUTH_REQUIRED_RESPONSE_IO_PENDING: The action will be decided
230 // asynchronously. |callback| will be invoked when the decision is made, 230 // asynchronously. |callback| will be invoked when the decision is made,
231 // and one of the other AuthRequiredResponse values will be passed in with 231 // and one of the other AuthRequiredResponse values will be passed in with
232 // the same semantics as described above. 232 // the same semantics as described above.
233 virtual AuthRequiredResponse OnAuthRequired( 233 virtual AuthRequiredResponse OnAuthRequired(
234 URLRequest* request, 234 URLRequest* request,
235 const AuthChallengeInfo& auth_info, 235 const AuthChallengeInfo& auth_info,
236 const AuthCallback& callback, 236 const AuthCallback& callback,
237 AuthCredentials* credentials); 237 AuthCredentials* credentials) = 0;
238 238
239 // Called when reading cookies to allow the network delegate to block access 239 // Called when reading cookies to allow the network delegate to block access
240 // to the cookie. This method will never be invoked when 240 // to the cookie. This method will never be invoked when
241 // LOAD_DO_NOT_SEND_COOKIES is specified. 241 // LOAD_DO_NOT_SEND_COOKIES is specified.
242 virtual bool OnCanGetCookies(const URLRequest& request, 242 virtual bool OnCanGetCookies(const URLRequest& request,
243 const CookieList& cookie_list); 243 const CookieList& cookie_list) = 0;
244 244
245 // Called when a cookie is set to allow the network delegate to block access 245 // Called when a cookie is set to allow the network delegate to block access
246 // to the cookie. This method will never be invoked when 246 // to the cookie. This method will never be invoked when
247 // LOAD_DO_NOT_SAVE_COOKIES is specified. 247 // LOAD_DO_NOT_SAVE_COOKIES is specified.
248 virtual bool OnCanSetCookie(const URLRequest& request, 248 virtual bool OnCanSetCookie(const URLRequest& request,
249 const std::string& cookie_line, 249 const std::string& cookie_line,
250 CookieOptions* options); 250 CookieOptions* options) = 0;
251 251
252 // Called when a file access is attempted to allow the network delegate to 252 // Called when a file access is attempted to allow the network delegate to
253 // allow or block access to the given file path. Returns true if access is 253 // allow or block access to the given file path. Returns true if access is
254 // allowed. 254 // allowed.
255 virtual bool OnCanAccessFile(const URLRequest& request, 255 virtual bool OnCanAccessFile(const URLRequest& request,
256 const base::FilePath& path) const; 256 const base::FilePath& path) const = 0;
257 257
258 // Returns true if the given request may be rejected when the 258 // Returns true if the given request may be rejected when the
259 // URLRequestThrottlerManager believes the server servicing the 259 // URLRequestThrottlerManager believes the server servicing the
260 // request is overloaded or down. 260 // request is overloaded or down.
261 virtual bool OnCanThrottleRequest(const URLRequest& request) const; 261 virtual bool OnCanThrottleRequest(const URLRequest& request) const = 0;
262 262
263 // Returns true if the given |url| has to be requested over connection that 263 // Returns true if the given |url| has to be requested over connection that
264 // is not tracked by the server. Usually is false, unless user privacy 264 // is not tracked by the server. Usually is false, unless user privacy
265 // settings block cookies from being get or set. 265 // settings block cookies from being get or set.
266 virtual bool OnCanEnablePrivacyMode( 266 virtual bool OnCanEnablePrivacyMode(
267 const GURL& url, 267 const GURL& url,
268 const GURL& first_party_for_cookies) const; 268 const GURL& first_party_for_cookies) const = 0;
269 269
270 // Called when the |referrer_url| for requesting |target_url| during handling 270 // Called when the |referrer_url| for requesting |target_url| during handling
271 // of the |request| is does not comply with the referrer policy (e.g. a 271 // of the |request| is does not comply with the referrer policy (e.g. a
272 // secure referrer for an insecure initial target). 272 // secure referrer for an insecure initial target).
273 // Returns true if the request should be cancelled. Otherwise, the referrer 273 // Returns true if the request should be cancelled. Otherwise, the referrer
274 // header is stripped from the request. 274 // header is stripped from the request.
275 virtual bool OnCancelURLRequestWithPolicyViolatingReferrerHeader( 275 virtual bool OnCancelURLRequestWithPolicyViolatingReferrerHeader(
276 const URLRequest& request, 276 const URLRequest& request,
277 const GURL& target_url, 277 const GURL& target_url,
278 const GURL& referrer_url) const; 278 const GURL& referrer_url) const = 0;
279 }; 279 };
280 280
281 } // namespace net 281 } // namespace net
282 282
283 #endif // NET_BASE_NETWORK_DELEGATE_H_ 283 #endif // NET_BASE_NETWORK_DELEGATE_H_
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698