chrome/browser/extensions/api/messaging/native_process_launcher.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_EXTENSIONS_API_MESSAGING_NATIVE_PROCESS_LAUNCHER_H_
   6 #define CHROME_BROWSER_EXTENSIONS_API_MESSAGING_NATIVE_PROCESS_LAUNCHER_H_
   7
   8 #include "base/callback_forward.h"
   9 #include "base/files/file.h"
  10 #include "base/memory/scoped_ptr.h"
  11 #include "base/process/process.h"
  12 #include "ui/gfx/native_widget_types.h"
  13
  14 class GURL;
  15
  16 namespace base {
  17 class CommandLine;
  18 class FilePath;
  19 }
  20
  21 namespace extensions {
  22
  23 class NativeProcessLauncher {
  24  public:
  25   enum LaunchResult {
  26     RESULT_SUCCESS,
  27     RESULT_INVALID_NAME,
  28     RESULT_NOT_FOUND,
  29     RESULT_FORBIDDEN,
  30     RESULT_FAILED_TO_START,
  31   };
  32
  33   // Callback that's called after the process has been launched. |result| is set
  34   // to false in case of a failure. Handler must take ownership of the IO
  35   // handles.
  36   typedef base::Callback<void(LaunchResult result,
  37                               base::ProcessHandle process_handle,
  38                               base::File read_file,
  39                               base::File write_file)> LaunchedCallback;
  40
  41   static scoped_ptr<NativeProcessLauncher> CreateDefault(
  42       bool allow_user_level_hosts,
  43       gfx::NativeView native_view);
  44
  45   NativeProcessLauncher() {}
  46   virtual ~NativeProcessLauncher() {}
  47
  48   // Finds native messaging host with the specified name and launches it
  49   // asynchronously. Also checks that the specified |origin| is permitted to
  50   // access the host. |callback| is called after the process has been started.
  51   // If the launcher is destroyed before the callback is called then the call is
  52   // canceled and the process is stopped if it has been started already (by
  53   // closing IO pipes).
  54   virtual void Launch(const GURL& origin,
  55                       const std::string& native_host_name,
  56                       LaunchedCallback callback) const = 0;
  57
  58  protected:
  59   // The following two methods are platform specific and are implemented in
  60   // platform-specific .cc files.
  61
  62   // Finds manifest file for the native messaging host |native_host_name|.
  63   // |user_level| is set to true if the manifest is installed on user level.
  64   // Returns an empty path if the host with the specified name cannot be found.
  65   static base::FilePath FindManifest(const std::string& native_host_name,
  66                                      bool allow_user_level_hosts,
  67                                      std::string* error_message);
  68
  69   // Launches native messaging process.
  70   static bool LaunchNativeProcess(const base::CommandLine& command_line,
  71                                   base::ProcessHandle* process_handle,
  72                                   base::File* read_file,
  73                                   base::File* write_file);
  74
  75  private:
  76   DISALLOW_COPY_AND_ASSIGN(NativeProcessLauncher);
  77 };
  78
  79 }  // namespace extensions
  80
  81 #endif  // CHROME_BROWSER_EXTENSIONS_API_MESSAGING_NATIVE_PROCESS_LAUNCHER_H_