mdnsresolver.h

Go to the documentation of this file.

 
#pragma once
 
 
#include <promeki/config.h>
#if PROMEKI_ENABLE_MDNS
#include <cstdint>
#include <promeki/namespace.h>
#include <promeki/atomic.h>
#include <promeki/duration.h>
#include <promeki/error.h>
#include <promeki/mdnsserviceinstance.h>
#include <promeki/mdnsservicetype.h>
#include <promeki/objectbase.h>
#include <promeki/timerevent.h>
#include <promeki/string.h>
#include <promeki/uniqueptr.h>
 
PROMEKI_NAMESPACE_BEGIN
 
class MdnsBrowser;
class MdnsManager;
 
class MdnsResolver : public ObjectBase {
                PROMEKI_OBJECT(MdnsResolver, ObjectBase)
        public:
                static constexpr int64_t DefaultTimeoutMs = 3000;
 
                explicit MdnsResolver(const MdnsServiceInstance &target, ObjectBase *parent = nullptr);
 
                ~MdnsResolver() override;
 
                const MdnsServiceInstance &target() const { return _target; }
 
                void setManager(MdnsManager *manager);
 
                MdnsManager *manager() const;
 
                void setTimeout(const Duration &timeout);
 
                const Duration &timeout() const { return _timeout; }
 
                Error resolve();
 
                void stop();
 
                bool isActive() const { return _active.value(); }
 
                MdnsServiceInstance snapshot() const;
 
                PROMEKI_SIGNAL(resolved, MdnsServiceInstance);
 
                PROMEKI_SIGNAL(failed,   Error);
 
        protected:
                void timerEvent(TimerEvent *e) override;
 
        private:
                // Called by the internal browser's serviceFound /
                // serviceUpdated slots.
                void onBrowserFound(MdnsServiceInstance inst);
                void onBrowserUpdated(MdnsServiceInstance inst);
                void onBrowserLost(MdnsServiceInstance inst);
 
                // Returns @c true when the in-progress snapshot is
                // "complete enough" to fire @ref resolvedSignal.  The
                // criterion is: port + hostname known AND at least one
                // address (v4 or v6) recorded.
                static bool isComplete(const MdnsServiceInstance &inst);
 
                MdnsServiceInstance       _target;
                UniquePtr<MdnsBrowser>    _browser;
                MdnsServiceInstance       _snapshot;
                Duration                  _timeout;
                int                       _timerId = -1;
                Atomic<bool>              _active;
                Atomic<bool>              _emitted;
};
 
PROMEKI_NAMESPACE_END
 
#endif // PROMEKI_ENABLE_MDNS