diff options
Diffstat (limited to 'third_party/libwebrtc/rtc_base/async_resolver_interface.h')
-rw-r--r-- | third_party/libwebrtc/rtc_base/async_resolver_interface.h | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/third_party/libwebrtc/rtc_base/async_resolver_interface.h b/third_party/libwebrtc/rtc_base/async_resolver_interface.h new file mode 100644 index 0000000000..998ebd800d --- /dev/null +++ b/third_party/libwebrtc/rtc_base/async_resolver_interface.h @@ -0,0 +1,58 @@ +/* + * Copyright 2013 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_RESOLVER_INTERFACE_H_ +#define RTC_BASE_ASYNC_RESOLVER_INTERFACE_H_ + +#include "rtc_base/checks.h" +#include "rtc_base/socket_address.h" +#include "rtc_base/system/rtc_export.h" +#include "rtc_base/third_party/sigslot/sigslot.h" + +namespace rtc { + +// This interface defines the methods to resolve the address asynchronously. +class RTC_EXPORT AsyncResolverInterface { + public: + AsyncResolverInterface(); + virtual ~AsyncResolverInterface(); + + // Start address resolution of the hostname in `addr`. + virtual void Start(const SocketAddress& addr) = 0; + // Start address resolution of the hostname in `addr` matching `family`. + virtual void Start(const SocketAddress& addr, int family) { + // TODO(webrtc:14319) make pure virtual when all subclasses have been + // updated. + RTC_DCHECK_NOTREACHED(); + } + // Returns true iff the address from `Start` was successfully resolved. + // If the address was successfully resolved, sets `addr` to a copy of the + // address from `Start` with the IP address set to the top most resolved + // address of `family` (`addr` will have both hostname and the resolved ip). + virtual bool GetResolvedAddress(int family, SocketAddress* addr) const = 0; + // Returns error from resolver. + virtual int GetError() const = 0; + // Delete the resolver. + virtual void Destroy(bool wait) = 0; + // Returns top most resolved IPv4 address if address is resolved successfully. + // Otherwise returns address set in SetAddress. + SocketAddress address() const { + SocketAddress addr; + GetResolvedAddress(AF_INET, &addr); + return addr; + } + + // This signal is fired when address resolve process is completed. + sigslot::signal1<AsyncResolverInterface*> SignalDone; +}; + +} // namespace rtc + +#endif |