application_runner.h revision 03b57e008b61dfcb1fbad3aea950ae0e001748b0 
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_PUBLIC_APPLICATION_APPLICATION_RUNNER_H_
6#define MOJO_PUBLIC_APPLICATION_APPLICATION_RUNNER_H_
7
8#include "mojo/public/cpp/system/core.h"
9
10namespace mojo {
11
12class ApplicationDelegate;
13
14// A utility for running an Application. The typical use case is to use
15// when writing your MojoMain:
16//
17//  MojoResult MojoMain(MojoHandle shell_handle) {
18//    mojo::ApplicationRunner runner(new MyApplicationDelegate());
19//    return runner.Run(shell_handle);
20//  }
21//
22// ApplicationRunner takes care of mojo environment initialization and
23// shutdown, and starting a RunLoop from which your application can run and
24// ultimately Quit().
25class ApplicationRunner {
26 public:
27  // Takes ownership of |delegate|.
28  explicit ApplicationRunner(ApplicationDelegate* delegate);
29  ~ApplicationRunner();
30
31  // Once the various parameters have been set above, use Run to initialize an
32  // ApplicationImpl wired to the provided delegate, and run a RunLoop until
33  // the application exits.
34  MojoResult Run(MojoHandle shell_handle);
35
36 private:
37  ApplicationDelegate* delegate_;
38
39  MOJO_DISALLOW_COPY_AND_ASSIGN(ApplicationRunner);
40};
41
42}  // namespace mojo
43
44#endif  // MOJO_PUBLIC_APPLICATION_APPLICATION_RUNNER_H_
45