net/dns/dns_client.h

   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
   3 // found in the LICENSE file.
   4
   5 #ifndef NET_DNS_DNS_CLIENT_H_
   6 #define NET_DNS_DNS_CLIENT_H_
   7
   8 #include "base/memory/scoped_ptr.h"
   9 #include "net/base/net_export.h"
  10
  11 namespace net {
  12
  13 class AddressSorter;
  14 struct DnsConfig;
  15 class DnsTransactionFactory;
  16 class NetLog;
  17
  18 // Convenience wrapper which allows easy injection of DnsTransaction into
  19 // HostResolverImpl. Pointers returned by the Get* methods are only guaranteed
  20 // to remain valid until next time SetConfig is called.
  21 class NET_EXPORT DnsClient {
  22  public:
  23   virtual ~DnsClient() {}
  24
  25   // Creates a new DnsTransactionFactory according to the new |config|.
  26   virtual void SetConfig(const DnsConfig& config) = 0;
  27
  28   // Returns NULL if the current config is not valid.
  29   virtual const DnsConfig* GetConfig() const = 0;
  30
  31   // Returns NULL if the current config is not valid.
  32   virtual DnsTransactionFactory* GetTransactionFactory() = 0;
  33
  34   // Returns NULL if the current config is not valid.
  35   virtual AddressSorter* GetAddressSorter() = 0;
  36
  37   // Creates default client.
  38   static scoped_ptr<DnsClient> CreateClient(NetLog* net_log);
  39 };
  40
  41 }  // namespace net
  42
  43 #endif  // NET_DNS_DNS_CLIENT_H_
  44