mojo/application/public/cpp/application_runner.h

   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
   3 // found in the LICENSE file.
   4
   5 #ifndef MOJO_APPLICATION_PUBLIC_CPP_APPLICATION_RUNNER_H_
   6 #define MOJO_APPLICATION_PUBLIC_CPP_APPLICATION_RUNNER_H_
   7
   8 #include "base/memory/scoped_ptr.h"
   9 #include "base/message_loop/message_loop.h"
  10 #include "third_party/mojo/src/mojo/public/cpp/system/core.h"
  11
  12 namespace mojo {
  13
  14 class ApplicationDelegate;
  15
  16 // A utility for running a chromium based mojo Application. The typical use
  17 // case is to use when writing your MojoMain:
  18 //
  19 //  MojoResult MojoMain(MojoHandle shell_handle) {
  20 //    mojo::ApplicationRunner runner(new MyDelegate());
  21 //    return runner.Run(shell_handle);
  22 //  }
  23 //
  24 // ApplicationRunner takes care of chromium environment initialization and
  25 // shutdown, and starting a MessageLoop from which your application can run and
  26 // ultimately Quit().
  27 class ApplicationRunner {
  28  public:
  29   // Takes ownership of |delegate|.
  30   explicit ApplicationRunner(ApplicationDelegate* delegate);
  31   ~ApplicationRunner();
  32
  33   static void InitBaseCommandLine();
  34
  35   void set_message_loop_type(base::MessageLoop::Type type);
  36
  37   // Once the various parameters have been set above, use Run to initialize an
  38   // ApplicationImpl wired to the provided delegate, and run a MessageLoop until
  39   // the application exits.
  40   //
  41   // Iff |init_base| is true, the runner will perform some initialization of
  42   // base globals (e.g. CommandLine and AtExitManager) before starting the
  43   // application.
  44   MojoResult Run(MojoHandle shell_handle, bool init_base);
  45
  46   // Calls Run above with |init_base| set to |true|.
  47   MojoResult Run(MojoHandle shell_handle);
  48
  49  private:
  50   scoped_ptr<ApplicationDelegate> delegate_;
  51
  52   // MessageLoop type. TYPE_CUSTOM is default (MessagePumpMojo will be used as
  53   // the underlying message pump).
  54   base::MessageLoop::Type message_loop_type_;
  55   // Whether Run() has been called.
  56   bool has_run_;
  57
  58   MOJO_DISALLOW_COPY_AND_ASSIGN(ApplicationRunner);
  59 };
  60
  61 }  // namespace mojo
  62
  63 #endif  // MOJO_APPLICATION_PUBLIC_CPP_APPLICATION_RUNNER_H_