developer.intra2net.com Git - pingcheck/blob - src/dns/resolverbase.h

   1 /*
   2  The software in this package is distributed under the GNU General
   3  Public License version 2 (with a special exception described below).
   4
   5  A copy of GNU General Public License (GPL) is included in this distribution,
   6  in the file COPYING.GPL.
   7
   8  As a special exception, if other files instantiate templates or use macros
   9  or inline functions from this file, or you compile this file and link it
  10  with other works to produce a work based on this file, this file
  11  does not by itself cause the resulting work to be covered
  12  by the GNU General Public License.
  13
  14  However the source code for this file must still be made available
  15  in accordance with section (3) of the GNU General Public License.
  16
  17  This exception does not invalidate any other reasons why a work based
  18  on this file might be covered by the GNU General Public License.
  19
  20  Christian Herdtweck, Intra2net AG 2015
  21  */
  22
  23 #ifndef RESOLVER_BASE_H
  24 #define RESOLVER_BASE_H
  25
  26 #include <boost/shared_ptr.hpp>
  27 #include <boost/function.hpp>
  28
  29 #include <queue>
  30 #include "host/pinger.h"
  31 #include "dns/hostaddress.h"
  32 #include "dns/dnscache.h"
  33
  34 typedef boost::function<void(const bool, const int)> callback_type;
  35 typedef std::queue<callback_type> callback_list_type;
  36
  37 class ResolverBase;
  38 typedef boost::shared_ptr<ResolverBase> ResolverItem;
  39
  40
  41 /**
  42  * @brief: abstract base class for DnsResolver and IpPseudoResolver
  43  */
  44 class ResolverBase
  45 {
  46 public:
  47     virtual ~ResolverBase();
  48
  49     /**
  50      * callbacks should be of type
  51      * void resolve_callback(const bool was_success,
  52      *                       const int recursion_count)
  53      */
  54     void async_resolve(const callback_type &callback,
  55                        const int recursion_count=0);
  56     virtual void cancel_resolve() = 0;
  57     virtual bool is_resolving() const = 0;
  58     virtual bool is_waiting_to_resolve() const = 0;
  59
  60     virtual HostAddress get_next_ip(const bool check_up_to_date=true) = 0;
  61     virtual bool have_up_to_date_ip() = 0;
  62     virtual int get_resolved_ip_count(const bool check_up_to_date=true) = 0;
  63
  64     std::string get_hostname() const;
  65
  66     std::string get_skip_cname() const;
  67
  68 protected:
  69     ResolverBase(const IoServiceItem &io_serv,
  70                  const std::string &hostname,
  71                  const DnsCacheItem &cache );
  72
  73 // variables
  74 protected:
  75     IoServiceItem IoService;
  76     const std::string Hostname;
  77     DnsCacheItem Cache;
  78     callback_list_type CallbackList;
  79
  80 // functions for subclasses
  81 protected:
  82     // recursion_count is guaranteed to be below
  83     // DnsMaster::get_max_recursion_count
  84     virtual void do_resolve(const int recursion_count) = 0;
  85
  86     // convenient forwards to DnsCache that just insert Hostname
  87     void update_cache( const HostAddressVec &new_ips ) const;
  88     void update_cache( const Cname &cname ) const;
  89     void update_cache( const std::string &hostname,
  90                        const HostAddressVec &new_ips ) const;
  91     void update_cache( const std::string &hostname,
  92                        const Cname &cname ) const;
  93
  94     HostAddressVec get_cached_ips_recursively(const std::string host="",
  95                                        const bool check_up_to_date=false) const;
  96
  97     void schedule_callbacks(const bool was_success,
  98                             const int recursion_count);
  99
 100 };
 101
 102 #endif
 103
 104 // (created using vim -- the world's best text editor)
 105