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 SHELL_CHILD_PROCESS_HOST_H_ | 5 #ifndef SHELL_CHILD_PROCESS_HOST_H_ |
6 #define SHELL_CHILD_PROCESS_HOST_H_ | 6 #define SHELL_CHILD_PROCESS_HOST_H_ |
7 | 7 |
8 #include "base/macros.h" | 8 #include "base/macros.h" |
9 #include "base/process/process.h" | 9 #include "base/process/process.h" |
10 #include "mojo/edk/embedder/platform_channel_pair.h" | 10 #include "mojo/edk/embedder/platform_channel_pair.h" |
11 #include "mojo/edk/embedder/scoped_platform_handle.h" | 11 #include "mojo/edk/embedder/scoped_platform_handle.h" |
12 #include "shell/child_process.h" // For |ChildProcess::Type|. | 12 #include "shell/child_process.h" // For |ChildProcess::Type|. |
13 | 13 |
14 namespace mojo { | 14 namespace mojo { |
15 namespace shell { | 15 namespace shell { |
16 | 16 |
17 class Context; | 17 class Context; |
18 | 18 |
19 // (Base) class for a "child process host". Handles launching and connecting a | 19 // (Base) class for a "child process host". Handles launching and connecting a |
20 // platform-specific "pipe" to the child, and supports joining the child | 20 // platform-specific "pipe" to the child, and supports joining the child |
21 // process. Intended for use as a base class, but may be used on its own in | 21 // process. |
22 // simple cases. | |
23 // | 22 // |
24 // This class is not thread-safe. It should be created/used/destroyed on a | 23 // This class is not thread-safe. It should be created/used/destroyed on a |
25 // single thread. | 24 // single thread. |
26 // | 25 // |
27 // Note: Does not currently work on Windows before Vista. | 26 // Note: Does not currently work on Windows before Vista. |
28 class ChildProcessHost { | 27 class ChildProcessHost { |
29 public: | 28 public: |
30 class Delegate { | 29 explicit ChildProcessHost(Context* context); |
31 public: | |
32 virtual void WillStart() = 0; | |
33 virtual void DidStart(bool success) = 0; | |
34 }; | |
35 | |
36 ChildProcessHost(Context* context, Delegate* delegate); | |
37 virtual ~ChildProcessHost(); | 30 virtual ~ChildProcessHost(); |
38 | 31 |
39 // |Start()|s the child process; calls the delegate's |DidStart()| (on the | 32 // |Start()|s the child process; calls |DidStart()| (on the thread on which |
40 // thread on which |Start()| was called) when the child has been started (or | 33 // |Start()| was called) when the child has been started (or failed to start). |
41 // failed to start). After calling |Start()|, this object must not be | 34 // After calling |Start()|, this object must not be destroyed until |
42 // destroyed until |DidStart()| has been called. | 35 // |DidStart()| has been called. |
43 // TODO(vtl): Consider using weak pointers and removing this requirement. | 36 // TODO(vtl): Consider using weak pointers and removing this requirement. |
44 void Start(); | 37 void Start(); |
45 | 38 |
46 // Waits for the child process to terminate, and returns its exit code. | 39 // Waits for the child process to terminate, and returns its exit code. |
47 // Note: If |Start()| has been called, this must not be called until the | 40 // Note: If |Start()| has been called, this must not be called until the |
48 // callback has been called. | 41 // callback has been called. |
49 int Join(); | 42 int Join(); |
50 | 43 |
51 embedder::ScopedPlatformHandle* platform_channel() { | 44 embedder::ScopedPlatformHandle* platform_channel() { |
52 return &platform_channel_; | 45 return &platform_channel_; |
53 } | 46 } |
54 | 47 |
| 48 virtual void WillStart() = 0; |
| 49 virtual void DidStart(bool success) = 0; |
| 50 |
55 protected: | 51 protected: |
56 Context* context() const { return context_; } | 52 Context* context() const { return context_; } |
57 | 53 |
58 private: | 54 private: |
59 bool DoLaunch(); | 55 bool DoLaunch(); |
60 void DidLaunch(bool success); | |
61 | 56 |
62 Context* const context_; | 57 Context* const context_; |
63 Delegate* const delegate_; | |
64 | 58 |
65 base::Process child_process_; | 59 base::Process child_process_; |
66 | 60 |
67 embedder::PlatformChannelPair platform_channel_pair_; | 61 embedder::PlatformChannelPair platform_channel_pair_; |
68 | 62 |
69 // Platform-specific "pipe" to the child process. Valid immediately after | 63 // Platform-specific "pipe" to the child process. Valid immediately after |
70 // creation. | 64 // creation. |
71 embedder::ScopedPlatformHandle platform_channel_; | 65 embedder::ScopedPlatformHandle platform_channel_; |
72 | 66 |
73 DISALLOW_COPY_AND_ASSIGN(ChildProcessHost); | 67 DISALLOW_COPY_AND_ASSIGN(ChildProcessHost); |
74 }; | 68 }; |
75 | 69 |
76 } // namespace shell | 70 } // namespace shell |
77 } // namespace mojo | 71 } // namespace mojo |
78 | 72 |
79 #endif // SHELL_CHILD_PROCESS_HOST_H_ | 73 #endif // SHELL_CHILD_PROCESS_HOST_H_ |
OLD | NEW |