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_DNS_DNS_TRANSACTION_H_ | 5 #ifndef NET_DNS_DNS_TRANSACTION_H_ |
6 #define NET_DNS_DNS_TRANSACTION_H_ | 6 #define NET_DNS_DNS_TRANSACTION_H_ |
7 | 7 |
| 8 #include <stdint.h> |
| 9 |
8 #include <string> | 10 #include <string> |
9 | 11 |
10 #include "base/basictypes.h" | |
11 #include "base/callback_forward.h" | 12 #include "base/callback_forward.h" |
12 #include "base/memory/scoped_ptr.h" | 13 #include "base/memory/scoped_ptr.h" |
13 #include "net/base/net_export.h" | 14 #include "net/base/net_export.h" |
14 | 15 |
15 namespace net { | 16 namespace net { |
16 | 17 |
17 class BoundNetLog; | 18 class BoundNetLog; |
18 class DnsResponse; | 19 class DnsResponse; |
19 class DnsSession; | 20 class DnsSession; |
20 | 21 |
21 // DnsTransaction implements a stub DNS resolver as defined in RFC 1034. | 22 // DnsTransaction implements a stub DNS resolver as defined in RFC 1034. |
22 // The DnsTransaction takes care of retransmissions, name server fallback (or | 23 // The DnsTransaction takes care of retransmissions, name server fallback (or |
23 // round-robin), suffix search, and simple response validation ("does it match | 24 // round-robin), suffix search, and simple response validation ("does it match |
24 // the query") to fight poisoning. | 25 // the query") to fight poisoning. |
25 // | 26 // |
26 // Destroying DnsTransaction cancels the underlying network effort. | 27 // Destroying DnsTransaction cancels the underlying network effort. |
27 class NET_EXPORT_PRIVATE DnsTransaction { | 28 class NET_EXPORT_PRIVATE DnsTransaction { |
28 public: | 29 public: |
29 virtual ~DnsTransaction() {} | 30 virtual ~DnsTransaction() {} |
30 | 31 |
31 // Returns the original |hostname|. | 32 // Returns the original |hostname|. |
32 virtual const std::string& GetHostname() const = 0; | 33 virtual const std::string& GetHostname() const = 0; |
33 | 34 |
34 // Returns the |qtype|. | 35 // Returns the |qtype|. |
35 virtual uint16 GetType() const = 0; | 36 virtual uint16_t GetType() const = 0; |
36 | 37 |
37 // Starts the transaction. Always completes asynchronously. | 38 // Starts the transaction. Always completes asynchronously. |
38 virtual void Start() = 0; | 39 virtual void Start() = 0; |
39 }; | 40 }; |
40 | 41 |
41 // Creates DnsTransaction which performs asynchronous DNS search. | 42 // Creates DnsTransaction which performs asynchronous DNS search. |
42 // It does NOT perform caching, aggregation or prioritization of transactions. | 43 // It does NOT perform caching, aggregation or prioritization of transactions. |
43 // | 44 // |
44 // Destroying the factory does NOT affect any already created DnsTransactions. | 45 // Destroying the factory does NOT affect any already created DnsTransactions. |
45 class NET_EXPORT_PRIVATE DnsTransactionFactory { | 46 class NET_EXPORT_PRIVATE DnsTransactionFactory { |
46 public: | 47 public: |
47 // Called with the response or NULL if no matching response was received. | 48 // Called with the response or NULL if no matching response was received. |
48 // Note that the |GetDottedName()| of the response may be different than the | 49 // Note that the |GetDottedName()| of the response may be different than the |
49 // original |hostname| as a result of suffix search. | 50 // original |hostname| as a result of suffix search. |
50 typedef base::Callback<void(DnsTransaction* transaction, | 51 typedef base::Callback<void(DnsTransaction* transaction, |
51 int neterror, | 52 int neterror, |
52 const DnsResponse* response)> CallbackType; | 53 const DnsResponse* response)> CallbackType; |
53 | 54 |
54 virtual ~DnsTransactionFactory() {} | 55 virtual ~DnsTransactionFactory() {} |
55 | 56 |
56 // Creates DnsTransaction for the given |hostname| and |qtype| (assuming | 57 // Creates DnsTransaction for the given |hostname| and |qtype| (assuming |
57 // QCLASS is IN). |hostname| should be in the dotted form. A dot at the end | 58 // QCLASS is IN). |hostname| should be in the dotted form. A dot at the end |
58 // implies the domain name is fully-qualified and will be exempt from suffix | 59 // implies the domain name is fully-qualified and will be exempt from suffix |
59 // search. |hostname| should not be an IP literal. | 60 // search. |hostname| should not be an IP literal. |
60 // | 61 // |
61 // The transaction will run |callback| upon asynchronous completion. | 62 // The transaction will run |callback| upon asynchronous completion. |
62 // The |net_log| is used as the parent log. | 63 // The |net_log| is used as the parent log. |
63 virtual scoped_ptr<DnsTransaction> CreateTransaction( | 64 virtual scoped_ptr<DnsTransaction> CreateTransaction( |
64 const std::string& hostname, | 65 const std::string& hostname, |
65 uint16 qtype, | 66 uint16_t qtype, |
66 const CallbackType& callback, | 67 const CallbackType& callback, |
67 const BoundNetLog& net_log) WARN_UNUSED_RESULT = 0; | 68 const BoundNetLog& net_log) WARN_UNUSED_RESULT = 0; |
68 | 69 |
69 // Creates a DnsTransactionFactory which creates DnsTransactionImpl using the | 70 // Creates a DnsTransactionFactory which creates DnsTransactionImpl using the |
70 // |session|. | 71 // |session|. |
71 static scoped_ptr<DnsTransactionFactory> CreateFactory( | 72 static scoped_ptr<DnsTransactionFactory> CreateFactory( |
72 DnsSession* session) WARN_UNUSED_RESULT; | 73 DnsSession* session) WARN_UNUSED_RESULT; |
73 }; | 74 }; |
74 | 75 |
75 } // namespace net | 76 } // namespace net |
76 | 77 |
77 #endif // NET_DNS_DNS_TRANSACTION_H_ | 78 #endif // NET_DNS_DNS_TRANSACTION_H_ |
78 | 79 |
OLD | NEW |