nearby: snapshot of cl/304428753

Signed-off-by: Alexey Polyudov <apolyudov@google.com>
Change-Id: I0023ac6e40456fc4a8169c3173bcbff3b5ccc476

cpp/platform/api/wifi_lan.h

@@ -0,0 +1,94 @@
+#ifndef PLATFORM_API_WIFI_LAN_H_
+#define PLATFORM_API_WIFI_LAN_H_
+
+#include "platform/api/input_stream.h"
+#include "platform/api/output_stream.h"
+#include "platform/byte_array.h"
+#include "platform/exception.h"
+#include "platform/port/string.h"
+#include "platform/ptr.h"
+
+namespace location {
+namespace nearby {
+
+// Opaque wrapper over a WifiLan service which contains encoded service name.
+class WifiLanService {
+ public:
+  virtual ~WifiLanService() = default;
+
+  virtual std::string GetName() = 0;
+};
+
+class WifiLanSocket {
+ public:
+  virtual ~WifiLanSocket() = default;
+
+  // Returns the InputStream of the WifiLanSocket, or a null Ptr<InputStream>
+  // on error.
+  //
+  // The returned Ptr is not owned by the caller, and can be invalidated once
+  // the WifiLanSocket object is destroyed.
+  virtual Ptr<InputStream> GetInputStream() = 0;
+
+  // Returns the OutputStream of the WifiLanSocket, or a null
+  // Ptr<OutputStream> on error.
+  //
+  // The returned Ptr is not owned by the caller, and can be invalidated once
+  // the WifiLanSocket object is destroyed.
+  virtual Ptr<OutputStream> GetOutputStream() = 0;
+
+  // Returns Exception::IO on error, Exception::NONE otherwise.
+  virtual Exception::Value Close() = 0;
+
+  // The returned Ptr is not owned by the caller, and can be invalidated once
+  // the WifiLanSocket object is destroyed.
+  virtual Ptr<WifiLanService> GetRemoteWifiLanService() = 0;
+};
+
+// Container of operations that can be performed over the WifiLan medium.
+class WifiLanMedium {
+ public:
+  virtual ~WifiLanMedium() = default;
+
+  virtual bool StartAdvertising(const std::string& service_id,
+                                const string& wifi_lan_service_info_name) = 0;
+  virtual void StopAdvertising(const std::string& service_id) = 0;
+
+  // Callback for WifiLan discover results.
+  class DiscoveredServiceCallback {
+   public:
+    virtual ~DiscoveredServiceCallback() = default;
+
+    virtual void OnServiceDiscovered(Ptr<WifiLanService> wifi_lan_service) = 0;
+    virtual void OnServiceLost(Ptr<WifiLanService> wifi_lan_service) = 0;
+  };
+
+  virtual bool StartDiscovery(
+      const std::string& service_id,
+      Ptr<DiscoveredServiceCallback> discovered_service_callback) = 0;
+  virtual void StopDiscovery(const std::string& service_id) = 0;
+
+  class AcceptedConnectionCallback {
+   public:
+    virtual ~AcceptedConnectionCallback() = default;
+
+    // The Ptr provided in this callback method will be owned (and
+    // destroyed) by the recipient of the callback methods (i.e. the creator of
+    // the concrete AcceptedConnectionCallback object).
+    virtual void OnConnectionAccepted(Ptr<WifiLanSocket> socket,
+                                      const string& service_id) = 0;
+  };
+
+  virtual bool StartAcceptingConnections(
+      const std::string& service_id,
+      Ptr<AcceptedConnectionCallback> accepted_connection_callback) = 0;
+  virtual void StopAcceptingConnections(const std::string& service_id) = 0;
+
+  virtual Ptr<WifiLanSocket> Connect(Ptr<WifiLanService> wifi_lan_service,
+                                     const std::string& service_id) = 0;
+};
+
+}  // namespace nearby
+}  // namespace location
+
+#endif  // PLATFORM_API_WIFI_LAN_H_