| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef NET_PROXY_PROXY_RESOLVER_H_ | |
| 6 #define NET_PROXY_PROXY_RESOLVER_H_ | |
| 7 | |
| 8 #include "base/logging.h" | |
| 9 #include "base/memory/ref_counted.h" | |
| 10 #include "base/strings/string16.h" | |
| 11 #include "net/base/completion_callback.h" | |
| 12 #include "net/base/load_states.h" | |
| 13 #include "net/base/net_export.h" | |
| 14 #include "net/proxy/proxy_resolver_script_data.h" | |
| 15 #include "url/gurl.h" | |
| 16 | |
| 17 namespace net { | |
| 18 | |
| 19 class BoundNetLog; | |
| 20 class ProxyInfo; | |
| 21 | |
| 22 // Interface for "proxy resolvers". A ProxyResolver fills in a list of proxies | |
| 23 // to use for a particular URL. Generally the backend for a ProxyResolver is | |
| 24 // a PAC script, but it doesn't need to be. ProxyResolver can service multiple | |
| 25 // requests at a time. | |
| 26 class NET_EXPORT_PRIVATE ProxyResolver { | |
| 27 public: | |
| 28 // Opaque pointer type, to return a handle to cancel outstanding requests. | |
| 29 typedef void* RequestHandle; | |
| 30 | |
| 31 // See |expects_pac_bytes()| for the meaning of |expects_pac_bytes|. | |
| 32 explicit ProxyResolver(bool expects_pac_bytes) | |
| 33 : expects_pac_bytes_(expects_pac_bytes) {} | |
| 34 | |
| 35 virtual ~ProxyResolver() {} | |
| 36 | |
| 37 // Gets a list of proxy servers to use for |url|. If the request will | |
| 38 // complete asynchronously returns ERR_IO_PENDING and notifies the result | |
| 39 // by running |callback|. If the result code is OK then | |
| 40 // the request was successful and |results| contains the proxy | |
| 41 // resolution information. In the case of asynchronous completion | |
| 42 // |*request| is written to, and can be passed to CancelRequest(). | |
| 43 virtual int GetProxyForURL(const GURL& url, | |
| 44 ProxyInfo* results, | |
| 45 const net::CompletionCallback& callback, | |
| 46 RequestHandle* request, | |
| 47 const BoundNetLog& net_log) = 0; | |
| 48 | |
| 49 // Cancels |request|. | |
| 50 virtual void CancelRequest(RequestHandle request) = 0; | |
| 51 | |
| 52 // Gets the LoadState for |request|. | |
| 53 virtual LoadState GetLoadState(RequestHandle request) const = 0; | |
| 54 | |
| 55 // The PAC script backend can be specified to the ProxyResolver either via | |
| 56 // URL, or via the javascript text itself. If |expects_pac_bytes| is true, | |
| 57 // then the ProxyResolverScriptData passed to SetPacScript() should | |
| 58 // contain the actual script bytes rather than just the URL. | |
| 59 bool expects_pac_bytes() const { return expects_pac_bytes_; } | |
| 60 | |
| 61 virtual void CancelSetPacScript() = 0; | |
| 62 | |
| 63 // Called to set the PAC script backend to use. | |
| 64 // Returns ERR_IO_PENDING in the case of asynchronous completion, and notifies | |
| 65 // the result through |callback|. | |
| 66 virtual int SetPacScript( | |
| 67 const scoped_refptr<ProxyResolverScriptData>& pac_script, | |
| 68 const net::CompletionCallback& callback) = 0; | |
| 69 | |
| 70 private: | |
| 71 const bool expects_pac_bytes_; | |
| 72 | |
| 73 DISALLOW_COPY_AND_ASSIGN(ProxyResolver); | |
| 74 }; | |
| 75 | |
| 76 } // namespace net | |
| 77 | |
| 78 #endif // NET_PROXY_PROXY_RESOLVER_H_ | |
| OLD | NEW |