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_BASE_SINGLE_REQUEST_HOST_RESOLVER_H_ | |
6 #define NET_BASE_SINGLE_REQUEST_HOST_RESOLVER_H_ | |
7 | |
8 #include "net/base/host_resolver.h" | |
9 | |
10 namespace net { | |
11 | |
12 // This class represents the task of resolving a hostname (or IP address | |
13 // literal) to an AddressList object. It wraps HostResolver to resolve only a | |
14 // single hostname at a time and cancels this request when going out of scope. | |
15 class NET_EXPORT SingleRequestHostResolver { | |
16 public: | |
17 // |resolver| must remain valid for the lifetime of |this|. | |
18 explicit SingleRequestHostResolver(HostResolver* resolver); | |
19 | |
20 // If a completion callback is pending when the resolver is destroyed, the | |
21 // host resolution is cancelled, and the completion callback will not be | |
22 // called. | |
23 ~SingleRequestHostResolver(); | |
24 | |
25 // Resolves the given hostname (or IP address literal), filling out the | |
26 // |addresses| object upon success. See HostResolver::Resolve() for details. | |
27 int Resolve(const HostResolver::RequestInfo& info, | |
28 AddressList* addresses, | |
29 const CompletionCallback& callback, | |
30 const BoundNetLog& net_log); | |
31 | |
32 // Cancels the in-progress request, if any. This prevents the callback | |
33 // from being invoked. Resolve() can be called again after cancelling. | |
34 void Cancel(); | |
35 | |
36 private: | |
37 // Callback for when the request to |resolver_| completes, so we dispatch | |
38 // to the user's callback. | |
39 void OnResolveCompletion(int result); | |
40 | |
41 // The actual host resolver that will handle the request. | |
42 HostResolver* const resolver_; | |
43 | |
44 // The current request (if any). | |
45 HostResolver::RequestHandle cur_request_; | |
46 CompletionCallback cur_request_callback_; | |
47 | |
48 // Completion callback for when request to |resolver_| completes. | |
49 CompletionCallback callback_; | |
50 | |
51 DISALLOW_COPY_AND_ASSIGN(SingleRequestHostResolver); | |
52 }; | |
53 | |
54 } // namespace net | |
55 | |
56 #endif // NET_BASE_SINGLE_REQUEST_HOST_RESOLVER_H_ | |
OLD | NEW |