| 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 |