Mojo C++ bindings: introduce MultiplexRouter and related classes.

mojo/public/cpp/bindings/lib/scoped_interface_endpoint_handle.h

+// Copyright 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef MOJO_PUBLIC_CPP_BINDINGS_LIB_SCOPED_INTERFACE_ENDPOINT_HANDLE_H_
+#define MOJO_PUBLIC_CPP_BINDINGS_LIB_SCOPED_INTERFACE_ENDPOINT_HANDLE_H_
+
+#include "base/macros.h"
+#include "base/memory/ref_counted.h"
+#include "mojo/public/cpp/bindings/lib/interface_id.h"
+
+namespace mojo {
+namespace internal {
+
+class MultiplexRouter;
+
+// ScopedInterfaceEndpointHandle refers to one end of an interface, either the
+// implementation side or the client side.
+class ScopedInterfaceEndpointHandle {
+  MOVE_ONLY_TYPE_WITH_MOVE_CONSTRUCTOR_FOR_CPP_03(
+      ScopedInterfaceEndpointHandle);
+
+ public:
+  // Creates an invalid endpoint handle.
+  ScopedInterfaceEndpointHandle();
+
+  // This is supposed to be used by MultiplexRouter only.
+  // |id| is the corresponding interface ID.
+  // If |is_local| is false, this handle is meant to be passed over |router| to
+  // the remote side.
+  ScopedInterfaceEndpointHandle(InterfaceId id,
+                                bool is_local,
+                                scoped_refptr<MultiplexRouter> router);
+
+  ScopedInterfaceEndpointHandle(ScopedInterfaceEndpointHandle&& other);
+
+  ~ScopedInterfaceEndpointHandle();
+
+  ScopedInterfaceEndpointHandle& operator=(
+      ScopedInterfaceEndpointHandle&& other);
+
+  bool is_valid() const { return IsValidInterfaceId(id_); }
+
+  InterfaceId id() const { return id_; }
+  bool is_local() const { return is_local_; }
+  MultiplexRouter* router() const { return router_.get(); }
+
+  void reset();
+  void swap(ScopedInterfaceEndpointHandle& other);
+
+  // Releases the handle without closing it.
+  InterfaceId release();
+
+ private:
+  InterfaceId id_;
+  bool is_local_;
+  scoped_refptr<MultiplexRouter> router_;
+};
+
+}  // namespace internal
+}  // namespace mojo
+
+#endif  // MOJO_PUBLIC_CPP_BINDINGS_LIB_SCOPED_INTERFACE_ENDPOINT_HANDLE_H_