| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef SERVICES_SHELL_PUBLIC_CPP_APPLICATION_RUNNER_H_ | 5 #ifndef SERVICES_SHELL_PUBLIC_CPP_SERVICE_RUNNER_H_ |
| 6 #define SERVICES_SHELL_PUBLIC_CPP_APPLICATION_RUNNER_H_ | 6 #define SERVICES_SHELL_PUBLIC_CPP_SERVICE_RUNNER_H_ |
| 7 | 7 |
| 8 #include <memory> | 8 #include <memory> |
| 9 | 9 |
| 10 #include "base/message_loop/message_loop.h" | 10 #include "base/message_loop/message_loop.h" |
| 11 #include "mojo/public/cpp/system/core.h" | 11 #include "mojo/public/cpp/system/core.h" |
| 12 | 12 |
| 13 namespace shell { | 13 namespace shell { |
| 14 | 14 |
| 15 class Service; | 15 class Service; |
| 16 class ServiceContext; | 16 class ServiceContext; |
| 17 | 17 |
| 18 // A utility for running a chromium based mojo Application. The typical use | 18 // A utility for running a chromium based mojo Service. The typical use |
| 19 // case is to use when writing your MojoMain: | 19 // case is to use when writing your MojoMain: |
| 20 // | 20 // |
| 21 // MojoResult MojoMain(MojoHandle shell_handle) { | 21 // MojoResult MojoMain(MojoHandle shell_handle) { |
| 22 // shell::ApplicationRunner runner(new MyDelegate()); | 22 // shell::ServiceRunner runner(new MyService); |
| 23 // return runner.Run(shell_handle); | 23 // return runner.Run(shell_handle); |
| 24 // } | 24 // } |
| 25 // | 25 // |
| 26 // ApplicationRunner takes care of chromium environment initialization and | 26 // ServiceRunner takes care of chromium environment initialization and |
| 27 // shutdown, and starting a MessageLoop from which your application can run and | 27 // shutdown, and starting a MessageLoop from which your service can run and |
| 28 // ultimately Quit(). | 28 // ultimately Quit(). |
| 29 class ApplicationRunner { | 29 class ServiceRunner { |
| 30 public: | 30 public: |
| 31 // Takes ownership of |client|. | 31 // Takes ownership of |service|. |
| 32 explicit ApplicationRunner(Service* client); | 32 explicit ServiceRunner(Service* service); |
| 33 ~ApplicationRunner(); | 33 ~ServiceRunner(); |
| 34 | 34 |
| 35 static void InitBaseCommandLine(); | 35 static void InitBaseCommandLine(); |
| 36 | 36 |
| 37 void set_message_loop_type(base::MessageLoop::Type type); | 37 void set_message_loop_type(base::MessageLoop::Type type); |
| 38 | 38 |
| 39 // Once the various parameters have been set above, use Run to initialize an | 39 // Once the various parameters have been set above, use Run to initialize an |
| 40 // ServiceContext wired to the provided delegate, and run a MessageLoop until | 40 // ServiceContext wired to the provided delegate, and run a MessageLoop until |
| 41 // the application exits. | 41 // the service exits. |
| 42 // | 42 // |
| 43 // Iff |init_base| is true, the runner will perform some initialization of | 43 // Iff |init_base| is true, the runner will perform some initialization of |
| 44 // base globals (e.g. CommandLine and AtExitManager) before starting the | 44 // base globals (e.g. CommandLine and AtExitManager) before starting the |
| 45 // application. | 45 // service. |
| 46 MojoResult Run(MojoHandle shell_handle, bool init_base); | 46 MojoResult Run(MojoHandle shell_handle, bool init_base); |
| 47 | 47 |
| 48 // Calls Run above with |init_base| set to |true|. | 48 // Calls Run above with |init_base| set to |true|. |
| 49 MojoResult Run(MojoHandle shell_handle); | 49 MojoResult Run(MojoHandle shell_handle); |
| 50 | 50 |
| 51 // Allows the caller to shut down the connection with the Service Manager. | 51 // Allows the caller to shut down the connection with the Service Manager. |
| 52 // After the Service Manager notices the pipe has closed, it will no longer | 52 // After the Service Manager notices the pipe has closed, it will no longer |
| 53 // track an instance of this service, though this service may continue to run | 53 // track an instance of this service, though this service may continue to run |
| 54 // and handle requests from others. | 54 // and handle requests from others. |
| 55 void DestroyServiceContext(); | 55 void DestroyServiceContext(); |
| 56 | 56 |
| 57 // Allows the caller to explicitly quit the application. Must be called from | 57 // Allows the caller to explicitly quit the service. Must be called from |
| 58 // the thread which created the ApplicationRunner. | 58 // the thread which created the ServiceRunner. |
| 59 void Quit(); | 59 void Quit(); |
| 60 | 60 |
| 61 private: | 61 private: |
| 62 std::unique_ptr<ServiceContext> context_; | 62 std::unique_ptr<ServiceContext> context_; |
| 63 std::unique_ptr<Service> client_; | 63 std::unique_ptr<Service> service_; |
| 64 | 64 |
| 65 // MessageLoop type. TYPE_CUSTOM is default (MessagePumpMojo will be used as | 65 // MessageLoop type. TYPE_CUSTOM is default (MessagePumpMojo will be used as |
| 66 // the underlying message pump). | 66 // the underlying message pump). |
| 67 base::MessageLoop::Type message_loop_type_; | 67 base::MessageLoop::Type message_loop_type_; |
| 68 // Whether Run() has been called. | 68 // Whether Run() has been called. |
| 69 bool has_run_; | 69 bool has_run_; |
| 70 | 70 |
| 71 DISALLOW_COPY_AND_ASSIGN(ApplicationRunner); | 71 DISALLOW_COPY_AND_ASSIGN(ServiceRunner); |
| 72 }; | 72 }; |
| 73 | 73 |
| 74 } // namespace shell | 74 } // namespace shell |
| 75 | 75 |
| 76 #endif // SERVICES_SHELL_PUBLIC_CPP_APPLICATION_RUNNER_H_ | 76 #endif // SERVICES_SHELL_PUBLIC_CPP_SERVICE_RUNNER_H_ |
| OLD | NEW |