OLD | NEW |
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 Loading... |
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_ |
OLD | NEW |