Home | History | Annotate | Download | only in messaging 
      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_
     82