QUIC - wait for disk cache to load server config if the server is among
[chromium-blink-merge.git] / net / proxy / proxy_resolver.h
blobb303e2b1491556e165683305265594757630d540
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.
5 #ifndef NET_PROXY_PROXY_RESOLVER_H_
6 #define NET_PROXY_PROXY_RESOLVER_H_
8 #include "base/callback_forward.h"
9 #include "base/logging.h"
10 #include "base/memory/ref_counted.h"
11 #include "base/strings/string16.h"
12 #include "net/base/completion_callback.h"
13 #include "net/base/load_states.h"
14 #include "net/base/net_export.h"
15 #include "net/proxy/proxy_resolver_script_data.h"
16 #include "url/gurl.h"
18 namespace net {
20 class BoundNetLog;
21 class ProxyInfo;
23 // Interface for "proxy resolvers". A ProxyResolver fills in a list of proxies
24 // to use for a particular URL. Generally the backend for a ProxyResolver is
25 // a PAC script, but it doesn't need to be. ProxyResolver can service multiple
26 // requests at a time.
27 class NET_EXPORT_PRIVATE ProxyResolver {
28 public:
29 // Opaque pointer type, to return a handle to cancel outstanding requests.
30 typedef void* RequestHandle;
32 ProxyResolver() {}
34 virtual ~ProxyResolver() {}
36 // Gets a list of proxy servers to use for |url|. If the request will
37 // complete asynchronously returns ERR_IO_PENDING and notifies the result
38 // by running |callback|. If the result code is OK then
39 // the request was successful and |results| contains the proxy
40 // resolution information. In the case of asynchronous completion
41 // |*request| is written to, and can be passed to CancelRequest().
42 virtual int GetProxyForURL(const GURL& url,
43 ProxyInfo* results,
44 const CompletionCallback& callback,
45 RequestHandle* request,
46 const BoundNetLog& net_log) = 0;
48 // Cancels |request|.
49 virtual void CancelRequest(RequestHandle request) = 0;
51 // Gets the LoadState for |request|.
52 virtual LoadState GetLoadState(RequestHandle request) const = 0;
54 private:
55 DISALLOW_COPY_AND_ASSIGN(ProxyResolver);
58 } // namespace net
60 #endif // NET_PROXY_PROXY_RESOLVER_H_