Create a broker interface for the new Mojo EDK so that the browser can create and duplicate messa...

mojo/edk/embedder/platform_channel_pair.h

 // 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_EMBEDDER_PLATFORM_CHANNEL_PAIR_H_
 #define MOJO_EDK_EMBEDDER_PLATFORM_CHANNEL_PAIR_H_
 
 #include "base/memory/scoped_ptr.h"
 #include "base/process/launch.h"
 #include "build/build_config.h"
@@ skipping 34 matching lines @@
 // Note: |PlatformChannelPair()|, |PassClientHandleFromParentProcess()| and
 // |PrepareToPassClientHandleToChildProcess()| have platform-specific
 // implementations.
 //
 // Note: On POSIX platforms, to write to the "pipe", use
 // |PlatformChannel{Write,Writev}()| (from platform_channel_utils_posix.h)
 // instead of |write()|, |writev()|, etc. Otherwise, you have to worry about
 // platform differences in suppressing |SIGPIPE|.
 class MOJO_SYSTEM_IMPL_EXPORT PlatformChannelPair {
  public:
-  PlatformChannelPair();
+  // If |client_is_blocking| is true, then the client handle only supports
+   // blocking reads and writes. The default is nonblocking.
+  PlatformChannelPair(bool client_is_blocking = false);
   ~PlatformChannelPair();
 
   ScopedPlatformHandle PassServerHandle();
 
   // For in-process use (e.g., in tests or to pass over another channel).
   ScopedPlatformHandle PassClientHandle();
 
   // To be called in the child process, after the parent process called
   // |PrepareToPassClientHandleToChildProcess()| and launched the child (using
   // the provided data), to create a client handle connected to the server
   // handle (in the parent process).
   static ScopedPlatformHandle PassClientHandleFromParentProcess(
       const base::CommandLine& command_line);
 
+  // Like above, but gets the handle from the passed in string.
+  static ScopedPlatformHandle PassClientHandleFromParentProcessFromString(
+      const std::string& value);
+
   // Prepares to pass the client channel to a new child process, to be launched
   // using |LaunchProcess()| (from base/launch.h). Modifies |*command_line| and
   // |*handle_passing_info| as needed.
   // Note: For Windows, this method only works on Vista and later.
   void PrepareToPassClientHandleToChildProcess(
       base::CommandLine* command_line,
       HandlePassingInformation* handle_passing_info) const;
 
+  // Like above, but returns a string instead of changing the command line.
+  std::string PrepareToPassClientHandleToChildProcessAsString(
+      HandlePassingInformation* handle_passing_info) const;
+
   // To be called once the child process has been successfully launched, to do
   // any cleanup necessary.
   void ChildProcessLaunched();
 
  private:
   static const char kMojoPlatformChannelHandleSwitch[];
 
   ScopedPlatformHandle server_handle_;
   ScopedPlatformHandle client_handle_;
 
   MOJO_DISALLOW_COPY_AND_ASSIGN(PlatformChannelPair);
 };
 
 }  // namespace edk
 }  // namespace mojo
 
 #endif  // MOJO_EDK_EMBEDDER_PLATFORM_CHANNEL_PAIR_H_