1 /* 2 * Copyright 2013 The WebRTC Project Authors. All rights reserved. 3 * 4 * Use of this source code is governed by a BSD-style license 5 * that can be found in the LICENSE file in the root of the source 6 * tree. An additional intellectual property rights grant can be found 7 * in the file PATENTS. All contributing project authors may 8 * be found in the AUTHORS file in the root of the source tree. 9 */ 10 11 #ifndef RTC_BASE_ASYNC_RESOLVER_INTERFACE_H_ 12 #define RTC_BASE_ASYNC_RESOLVER_INTERFACE_H_ 13 14 #include "rtc_base/socket_address.h" 15 #include "rtc_base/system/rtc_export.h" 16 #include "rtc_base/third_party/sigslot/sigslot.h" 17 18 namespace rtc { 19 20 // This interface defines the methods to resolve the address asynchronously. 21 class RTC_EXPORT AsyncResolverInterface { 22 public: 23 AsyncResolverInterface(); 24 virtual ~AsyncResolverInterface(); 25 26 // Start address resolution of the hostname in |addr|. 27 virtual void Start(const SocketAddress& addr) = 0; 28 // Returns true iff the address from |Start| was successfully resolved. 29 // If the address was successfully resolved, sets |addr| to a copy of the 30 // address from |Start| with the IP address set to the top most resolved 31 // address of |family| (|addr| will have both hostname and the resolved ip). 32 virtual bool GetResolvedAddress(int family, SocketAddress* addr) const = 0; 33 // Returns error from resolver. 34 virtual int GetError() const = 0; 35 // Delete the resolver. 36 virtual void Destroy(bool wait) = 0; 37 // Returns top most resolved IPv4 address if address is resolved successfully. 38 // Otherwise returns address set in SetAddress. address()39 SocketAddress address() const { 40 SocketAddress addr; 41 GetResolvedAddress(AF_INET, &addr); 42 return addr; 43 } 44 45 // This signal is fired when address resolve process is completed. 46 sigslot::signal1<AsyncResolverInterface*> SignalDone; 47 }; 48 49 } // namespace rtc 50 51 #endif 52