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

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

Issue 38303002: Enable Mojo to download from file URLs (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: blah Created 7 years, 2 months 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 | Annotate | Revision Log
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 102 matching lines...) Expand 10 before | Expand all | Expand 10 after
113 113
114 // Called before a request is sent. Allows the delegate to rewrite the URL 114 // Called before a request is sent. Allows the delegate to rewrite the URL
115 // being fetched by modifying |new_url|. |callback| and |new_url| are valid 115 // being fetched by modifying |new_url|. |callback| and |new_url| are valid
116 // only until OnURLRequestDestroyed is called for this request. Returns a net 116 // only until OnURLRequestDestroyed is called for this request. Returns a net
117 // status code, generally either OK to continue with the request or 117 // status code, generally either OK to continue with the request or
118 // ERR_IO_PENDING if the result is not ready yet. A status code other than OK 118 // ERR_IO_PENDING if the result is not ready yet. A status code other than OK
119 // and ERR_IO_PENDING will cancel the request and report the status code as 119 // and ERR_IO_PENDING will cancel the request and report the status code as
120 // the reason. 120 // the reason.
121 virtual int OnBeforeURLRequest(URLRequest* request, 121 virtual int OnBeforeURLRequest(URLRequest* request,
122 const CompletionCallback& callback, 122 const CompletionCallback& callback,
123 GURL* new_url) = 0; 123 GURL* new_url);
124 124
125 // Called right before the HTTP headers are sent. Allows the delegate to 125 // Called right before the HTTP headers are sent. Allows the delegate to
126 // read/write |headers| before they get sent out. |callback| and |headers| are 126 // read/write |headers| before they get sent out. |callback| and |headers| are
127 // valid only until OnCompleted or OnURLRequestDestroyed is called for this 127 // valid only until OnCompleted or OnURLRequestDestroyed is called for this
128 // request. 128 // request.
129 // Returns a net status code. 129 // Returns a net status code.
130 virtual int OnBeforeSendHeaders(URLRequest* request, 130 virtual int OnBeforeSendHeaders(URLRequest* request,
131 const CompletionCallback& callback, 131 const CompletionCallback& callback,
132 HttpRequestHeaders* headers) = 0; 132 HttpRequestHeaders* headers);
133 133
134 // Called right before the HTTP request(s) are being sent to the network. 134 // Called right before the HTTP request(s) are being sent to the network.
135 // |headers| is only valid until OnCompleted or OnURLRequestDestroyed is 135 // |headers| is only valid until OnCompleted or OnURLRequestDestroyed is
136 // called for this request. 136 // called for this request.
137 virtual void OnSendHeaders(URLRequest* request, 137 virtual void OnSendHeaders(URLRequest* request,
138 const HttpRequestHeaders& headers) = 0; 138 const HttpRequestHeaders& headers);
139 139
140 // Called for HTTP requests when the headers have been received. Returns a net 140 // Called for HTTP requests when the headers have been received. Returns a net
141 // status code, generally either OK to continue with the request or 141 // status code, generally either OK to continue with the request or
142 // ERR_IO_PENDING if the result is not ready yet. A status code other than OK 142 // ERR_IO_PENDING if the result is not ready yet. A status code other than OK
143 // and ERR_IO_PENDING will cancel the request and report the status code as 143 // and ERR_IO_PENDING will cancel the request and report the status code as
144 // the reason. 144 // the reason.
145 // |original_response_headers| contains the headers as received over the 145 // |original_response_headers| contains the headers as received over the
146 // network, these must not be modified. |override_response_headers| can be set 146 // network, these must not be modified. |override_response_headers| can be set
147 // to new values, that should be considered as overriding 147 // to new values, that should be considered as overriding
148 // |original_response_headers|. 148 // |original_response_headers|.
149 // |callback|, |original_response_headers|, and |override_response_headers| 149 // |callback|, |original_response_headers|, and |override_response_headers|
150 // are only valid until OnURLRequestDestroyed is called for this request. 150 // are only valid until OnURLRequestDestroyed is called for this request.
151 virtual int OnHeadersReceived( 151 virtual int OnHeadersReceived(
152 URLRequest* request, 152 URLRequest* request,
153 const CompletionCallback& callback, 153 const CompletionCallback& callback,
154 const HttpResponseHeaders* original_response_headers, 154 const HttpResponseHeaders* original_response_headers,
155 scoped_refptr<HttpResponseHeaders>* override_response_headers) = 0; 155 scoped_refptr<HttpResponseHeaders>* override_response_headers);
156 156
157 // Called right after a redirect response code was received. 157 // Called right after a redirect response code was received.
158 // |new_location| is only valid until OnURLRequestDestroyed is called for this 158 // |new_location| is only valid until OnURLRequestDestroyed is called for this
159 // request. 159 // request.
160 virtual void OnBeforeRedirect(URLRequest* request, 160 virtual void OnBeforeRedirect(URLRequest* request,
161 const GURL& new_location) = 0; 161 const GURL& new_location);
162 162
163 // This corresponds to URLRequestDelegate::OnResponseStarted. 163 // This corresponds to URLRequestDelegate::OnResponseStarted.
164 virtual void OnResponseStarted(URLRequest* request) = 0; 164 virtual void OnResponseStarted(URLRequest* request);
165 165
166 // Called every time we read raw bytes. 166 // Called every time we read raw bytes.
167 virtual void OnRawBytesRead(const URLRequest& request, int bytes_read) = 0; 167 virtual void OnRawBytesRead(const URLRequest& request, int bytes_read);
168 168
169 // Indicates that the URL request has been completed or failed. 169 // Indicates that the URL request has been completed or failed.
170 // |started| indicates whether the request has been started. If false, 170 // |started| indicates whether the request has been started. If false,
171 // some information like the socket address is not available. 171 // some information like the socket address is not available.
172 virtual void OnCompleted(URLRequest* request, bool started) = 0; 172 virtual void OnCompleted(URLRequest* request, bool started);
173 173
174 // Called when an URLRequest is being destroyed. Note that the request is 174 // Called when an URLRequest is being destroyed. Note that the request is
175 // being deleted, so it's not safe to call any methods that may result in 175 // being deleted, so it's not safe to call any methods that may result in
176 // a virtual method call. 176 // a virtual method call.
177 virtual void OnURLRequestDestroyed(URLRequest* request) = 0; 177 virtual void OnURLRequestDestroyed(URLRequest* request);
178 178
179 // Corresponds to ProxyResolverJSBindings::OnError. 179 // Corresponds to ProxyResolverJSBindings::OnError.
180 virtual void OnPACScriptError(int line_number, 180 virtual void OnPACScriptError(int line_number,
181 const base::string16& error) = 0; 181 const base::string16& error);
182 182
183 // Called when a request receives an authentication challenge 183 // Called when a request receives an authentication challenge
184 // specified by |auth_info|, and is unable to respond using cached 184 // specified by |auth_info|, and is unable to respond using cached
185 // credentials. |callback| and |credentials| must be non-NULL, and must 185 // credentials. |callback| and |credentials| must be non-NULL, and must
186 // be valid until OnURLRequestDestroyed is called for |request|. 186 // be valid until OnURLRequestDestroyed is called for |request|.
187 // 187 //
188 // The following return values are allowed: 188 // The following return values are allowed:
189 // - AUTH_REQUIRED_RESPONSE_NO_ACTION: |auth_info| is observed, but 189 // - AUTH_REQUIRED_RESPONSE_NO_ACTION: |auth_info| is observed, but
190 // no action is being taken on it. 190 // no action is being taken on it.
191 // - AUTH_REQUIRED_RESPONSE_SET_AUTH: |credentials| is filled in with 191 // - AUTH_REQUIRED_RESPONSE_SET_AUTH: |credentials| is filled in with
192 // a username and password, which should be used in a response to 192 // a username and password, which should be used in a response to
193 // |auth_info|. 193 // |auth_info|.
194 // - AUTH_REQUIRED_RESPONSE_CANCEL_AUTH: The authentication challenge 194 // - AUTH_REQUIRED_RESPONSE_CANCEL_AUTH: The authentication challenge
195 // should not be attempted. 195 // should not be attempted.
196 // - AUTH_REQUIRED_RESPONSE_IO_PENDING: The action will be decided 196 // - AUTH_REQUIRED_RESPONSE_IO_PENDING: The action will be decided
197 // asynchronously. |callback| will be invoked when the decision is made, 197 // asynchronously. |callback| will be invoked when the decision is made,
198 // and one of the other AuthRequiredResponse values will be passed in with 198 // and one of the other AuthRequiredResponse values will be passed in with
199 // the same semantics as described above. 199 // the same semantics as described above.
200 virtual AuthRequiredResponse OnAuthRequired( 200 virtual AuthRequiredResponse OnAuthRequired(
201 URLRequest* request, 201 URLRequest* request,
202 const AuthChallengeInfo& auth_info, 202 const AuthChallengeInfo& auth_info,
203 const AuthCallback& callback, 203 const AuthCallback& callback,
204 AuthCredentials* credentials) = 0; 204 AuthCredentials* credentials);
205 205
206 // Called when reading cookies to allow the network delegate to block access 206 // Called when reading cookies to allow the network delegate to block access
207 // to the cookie. This method will never be invoked when 207 // to the cookie. This method will never be invoked when
208 // LOAD_DO_NOT_SEND_COOKIES is specified. 208 // LOAD_DO_NOT_SEND_COOKIES is specified.
209 virtual bool OnCanGetCookies(const URLRequest& request, 209 virtual bool OnCanGetCookies(const URLRequest& request,
210 const CookieList& cookie_list) = 0; 210 const CookieList& cookie_list);
211 211
212 // Called when a cookie is set to allow the network delegate to block access 212 // Called when a cookie is set to allow the network delegate to block access
213 // to the cookie. This method will never be invoked when 213 // to the cookie. This method will never be invoked when
214 // LOAD_DO_NOT_SAVE_COOKIES is specified. 214 // LOAD_DO_NOT_SAVE_COOKIES is specified.
215 virtual bool OnCanSetCookie(const URLRequest& request, 215 virtual bool OnCanSetCookie(const URLRequest& request,
216 const std::string& cookie_line, 216 const std::string& cookie_line,
217 CookieOptions* options) = 0; 217 CookieOptions* options);
218 218
219 // Called when a file access is attempted to allow the network delegate to 219 // Called when a file access is attempted to allow the network delegate to
220 // allow or block access to the given file path. Returns true if access is 220 // allow or block access to the given file path. Returns true if access is
221 // allowed. 221 // allowed.
222 virtual bool OnCanAccessFile(const URLRequest& request, 222 virtual bool OnCanAccessFile(const URLRequest& request,
223 const base::FilePath& path) const = 0; 223 const base::FilePath& path) const;
224 224
225 // Returns true if the given request may be rejected when the 225 // Returns true if the given request may be rejected when the
226 // URLRequestThrottlerManager believes the server servicing the 226 // URLRequestThrottlerManager believes the server servicing the
227 // request is overloaded or down. 227 // request is overloaded or down.
228 virtual bool OnCanThrottleRequest(const URLRequest& request) const = 0; 228 virtual bool OnCanThrottleRequest(const URLRequest& request) const;
229 229
230 // Returns true if the given |url| has to be requested over connection that 230 // Returns true if the given |url| has to be requested over connection that
231 // is not tracked by the server. Usually is false, unless user privacy 231 // is not tracked by the server. Usually is false, unless user privacy
232 // settings block cookies from being get or set. 232 // settings block cookies from being get or set.
233 virtual bool OnCanEnablePrivacyMode( 233 virtual bool OnCanEnablePrivacyMode(
234 const GURL& url, 234 const GURL& url,
235 const GURL& first_party_for_cookies) const; 235 const GURL& first_party_for_cookies) const;
236 236
237 // Called before a SocketStream tries to connect. 237 // Called before a SocketStream tries to connect.
238 virtual int OnBeforeSocketStreamConnect( 238 virtual int OnBeforeSocketStreamConnect(
239 SocketStream* socket, const CompletionCallback& callback) = 0; 239 SocketStream* socket, const CompletionCallback& callback);
240 240
241 // Called when the completion of a URLRequest is blocking on a cache 241 // Called when the completion of a URLRequest is blocking on a cache
242 // action or a network action, or when that is no longer the case. 242 // action or a network action, or when that is no longer the case.
243 // REQUEST_WAIT_STATE_RESET indicates for a given URLRequest 243 // REQUEST_WAIT_STATE_RESET indicates for a given URLRequest
244 // cancellation of any pending waits for this request. 244 // cancellation of any pending waits for this request.
245 virtual void OnRequestWaitStateChange(const URLRequest& request, 245 virtual void OnRequestWaitStateChange(const URLRequest& request,
246 RequestWaitState state) = 0; 246 RequestWaitState state);
247 }; 247 };
248 248
249 } // namespace net 249 } // namespace net
250 250
251 #endif // NET_BASE_NETWORK_DELEGATE_H_ 251 #endif // NET_BASE_NETWORK_DELEGATE_H_
OLDNEW
« no previous file with comments | « mojo/shell/shell.cc ('k') | net/base/network_delegate.cc » ('j') | net/base/network_delegate.cc » ('J')

Powered by Google App Engine
This is Rietveld 408576698