summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/rtc_base/async_resolver_interface.h
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/libwebrtc/rtc_base/async_resolver_interface.h')
-rw-r--r--third_party/libwebrtc/rtc_base/async_resolver_interface.h58
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