/* * Copyright 2023 The WebRTC Project Authors. All rights reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #ifndef RTC_BASE_ASYNC_DNS_RESOLVER_H_ #define RTC_BASE_ASYNC_DNS_RESOLVER_H_ #include #include "api/async_dns_resolver.h" #include "api/sequence_checker.h" #include "api/task_queue/pending_task_safety_flag.h" #include "rtc_base/ref_counted_object.h" #include "rtc_base/system/rtc_export.h" #include "rtc_base/thread_annotations.h" namespace webrtc { // This file contains a default implementation of // webrtc::AsyncDnsResolverInterface, for use when there is no need for special // treatment. class AsyncDnsResolverResultImpl : public AsyncDnsResolverResult { public: bool GetResolvedAddress(int family, rtc::SocketAddress* addr) const override; // Returns error from resolver. int GetError() const override; private: friend class AsyncDnsResolver; RTC_NO_UNIQUE_ADDRESS webrtc::SequenceChecker sequence_checker_; rtc::SocketAddress addr_ RTC_GUARDED_BY(sequence_checker_); std::vector addresses_ RTC_GUARDED_BY(sequence_checker_); int error_ RTC_GUARDED_BY(sequence_checker_); }; class RTC_EXPORT AsyncDnsResolver : public AsyncDnsResolverInterface { public: AsyncDnsResolver(); ~AsyncDnsResolver(); // Start address resolution of the hostname in `addr`. void Start(const rtc::SocketAddress& addr, absl::AnyInvocable callback) override; // Start address resolution of the hostname in `addr` matching `family`. void Start(const rtc::SocketAddress& addr, int family, absl::AnyInvocable callback) override; const AsyncDnsResolverResult& result() const override; private: class State; ScopedTaskSafety safety_; // To check for client going away rtc::scoped_refptr state_; // To check for "this" going away AsyncDnsResolverResultImpl result_; absl::AnyInvocable callback_; }; } // namespace webrtc #endif // RTC_BASE_ASYNC_DNS_RESOLVER_H_