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 MOJO_PUBLIC_CPP_ENVIRONMENT_ENVIRONMENT_H_ | 5 #ifndef MOJO_PUBLIC_CPP_ENVIRONMENT_ENVIRONMENT_H_ |
6 #define MOJO_PUBLIC_CPP_ENVIRONMENT_ENVIRONMENT_H_ | 6 #define MOJO_PUBLIC_CPP_ENVIRONMENT_ENVIRONMENT_H_ |
7 | 7 |
8 #include "mojo/public/cpp/system/macros.h" | 8 #include "mojo/public/cpp/system/macros.h" |
9 | 9 |
10 struct MojoAsyncWaiter; | 10 struct MojoAsyncWaiter; |
11 struct MojoLogger; | 11 struct MojoLogger; |
12 | 12 |
13 namespace mojo { | 13 namespace mojo { |
14 | 14 |
15 // Other parts of the Mojo C++ APIs use the *static* methods of this class. | 15 // This class just acts as a "namespace": it only has static methods (whose |
16 // | 16 // implementation may be varied). Note that some implementations may require |
17 // The "standalone" implementation of this class requires that this class (in | 17 // their own explicit initialization/shut down functions to be called. |
18 // the lib/ subdirectory) be instantiated (and remain so) while using the Mojo | |
19 // C++ APIs. I.e., the static methods depend on things set up by the constructor | |
20 // and torn down by the destructor. | |
21 // | |
22 // Other implementations may not have this requirement. | |
23 class Environment { | 18 class Environment { |
24 public: | 19 public: |
25 Environment(); | |
26 // This constructor allows the standard implementations to be overridden (set | |
27 // a parameter to null to get the standard implementation). | |
28 Environment(const MojoAsyncWaiter* default_async_waiter, | |
29 const MojoLogger* default_logger); | |
30 ~Environment(); | |
31 | |
32 static const MojoAsyncWaiter* GetDefaultAsyncWaiter(); | 20 static const MojoAsyncWaiter* GetDefaultAsyncWaiter(); |
| 21 // Setting the default async waiter to null will use the original default |
| 22 // implementation. |
| 23 static void SetDefaultAsyncWaiter(const MojoAsyncWaiter* async_waiter); |
33 | 24 |
34 static const MojoLogger* GetDefaultLogger(); | 25 static const MojoLogger* GetDefaultLogger(); |
35 // Setting the logger to null will use the standard implementation. | 26 // Setting the logger to null will use the will use the original default |
| 27 // implementation. |
36 static void SetDefaultLogger(const MojoLogger* logger); | 28 static void SetDefaultLogger(const MojoLogger* logger); |
37 | 29 |
38 // These instantiate and destroy an environment-specific run loop for the | 30 // These instantiate and destroy an environment-specific run loop for the |
39 // current thread, allowing |GetDefaultAsyncWaiter()| to be used. (The run | 31 // current thread, allowing |GetDefaultAsyncWaiter()| to be used. (The run |
40 // loop itself should be accessible via thread-local storage, using methods | 32 // loop itself should be accessible via thread-local storage, using methods |
41 // specific to the run loop implementation.) Creating and destroying nested | 33 // specific to the run loop implementation.) Creating and destroying nested |
42 // run loops is not supported. | 34 // run loops is not supported. |
43 static void InstantiateDefaultRunLoop(); | 35 static void InstantiateDefaultRunLoop(); |
44 static void DestroyDefaultRunLoop(); | 36 static void DestroyDefaultRunLoop(); |
45 | 37 |
46 private: | 38 private: |
47 MOJO_DISALLOW_COPY_AND_ASSIGN(Environment); | 39 Environment() = delete; |
| 40 ~Environment() = delete; |
48 }; | 41 }; |
49 | 42 |
50 } // namespace mojo | 43 } // namespace mojo |
51 | 44 |
52 #endif // MOJO_PUBLIC_CPP_ENVIRONMENT_ENVIRONMENT_H_ | 45 #endif // MOJO_PUBLIC_CPP_ENVIRONMENT_ENVIRONMENT_H_ |
OLD | NEW |