Index: mojo/edk/system/channel_manager.h |
diff --git a/mojo/edk/system/channel_manager.h b/mojo/edk/system/channel_manager.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..60a3048dc3d80aa609190628a1ddd93c96c2a020 |
--- /dev/null |
+++ b/mojo/edk/system/channel_manager.h |
@@ -0,0 +1,83 @@ |
+// Copyright 2014 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_EDK_SYSTEM_CHANNEL_MANAGER_H_ |
+#define MOJO_EDK_SYSTEM_CHANNEL_MANAGER_H_ |
+ |
+#include <stdint.h> |
+ |
+#include "base/containers/hash_tables.h" |
+#include "base/macros.h" |
+#include "base/memory/ref_counted.h" |
+#include "base/synchronization/lock.h" |
+#include "base/task_runner.h" |
+#include "mojo/edk/system/channel.h" |
+#include "mojo/edk/system/channel_info.h" |
+ |
+namespace mojo { |
+namespace system { |
+ |
+// IDs for |Channel|s managed by a |ChannelManager|. (IDs should be thought of |
+// as specific to a given |ChannelManager|.) 0 is never a valid ID. |
+// |
+// Note: We currently just use the pointer of the |Channel| casted to a |
+// |uintptr_t|, but we reserve the right to change this. |
+typedef uintptr_t ChannelId; |
+ |
+// This class manages and "owns" |Channel|s (which typically connect to other |
+// processes) for a given process. This class is thread-safe. |
+class MOJO_SYSTEM_IMPL_EXPORT ChannelManager { |
+ public: |
+ ChannelManager(); |
+ ~ChannelManager(); |
+ |
+ // Gets the ID for a given channel. |
+ // |
+ // Note: This is currently a static method and thus may be called under |
+ // |lock_|. If this is ever made non-static (i.e., made specific to a given |
+ // |ChannelManager|), those call sites may have to changed. |
+ static ChannelId GetChannelId(const Channel* channel) { |
+ return reinterpret_cast<ChannelId>(channel); |
+ } |
+ |
+ // Adds |channel| to the set of |Channel|s managed by this |ChannelManager|; |
+ // |channel_thread_task_runner| should be the task runner for |channel|'s |
+ // creation (a.k.a. I/O) thread. |channel| should either already be |
+ // initialized. It should not be managed by any |ChannelManager| yet. Returns |
+ // the ID for the added channel. |
+ ChannelId AddChannel( |
+ scoped_refptr<Channel> channel, |
+ scoped_refptr<base::TaskRunner> channel_thread_task_runner); |
+ |
+ // Informs the channel manager (and thus channel) that it will be shutdown |
+ // soon (by calling |ShutdownChannel()|). Calling this is optional (and may in |
+ // fact be called multiple times) but it will suppress certain warnings (e.g., |
+ // for the channel being broken) and enable others (if messages are written to |
+ // the channel). |
+ void WillShutdownChannel(ChannelId channel_id); |
+ |
+ // Shuts down the channel specified by the given ID. It is up to the caller to |
+ // guarantee that this is only called once per channel (that was added using |
+ // |AddChannel()|). If called from the chanel's creation thread (i.e., |
+ // |base::MessageLoopProxy::current()| is the channel thread's |TaskRunner|), |
+ // this will complete synchronously. |
+ void ShutdownChannel(ChannelId channel_id); |
+ |
+ private: |
+ // Gets the |ChannelInfo| for the channel specified by the given ID. (This |
+ // should *not* be called under lock.) |
+ ChannelInfo GetChannelInfo(ChannelId channel_id); |
+ |
+ // Note: |Channel| methods should not be called under |lock_|. |
+ base::Lock lock_; // Protects the members below. |
+ |
+ base::hash_map<ChannelId, ChannelInfo> channel_infos_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(ChannelManager); |
+}; |
+ |
+} // namespace system |
+} // namespace mojo |
+ |
+#endif // MOJO_EDK_SYSTEM_CHANNEL_MANAGER_H_ |