| 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 |