OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 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 PPAPI_SHARED_IMPL_PPAPI_GLOBALS_H_ | 5 #ifndef PPAPI_SHARED_IMPL_PPAPI_GLOBALS_H_ |
6 #define PPAPI_SHARED_IMPL_PPAPI_GLOBALS_H_ | 6 #define PPAPI_SHARED_IMPL_PPAPI_GLOBALS_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
9 #include "base/threading/thread_local.h" // For testing purposes only. | |
10 #include "ppapi/c/pp_instance.h" | 9 #include "ppapi/c/pp_instance.h" |
11 #include "ppapi/c/pp_module.h" | 10 #include "ppapi/c/pp_module.h" |
12 #include "ppapi/shared_impl/api_id.h" | 11 #include "ppapi/shared_impl/api_id.h" |
13 #include "ppapi/shared_impl/ppapi_shared_export.h" | 12 #include "ppapi/shared_impl/ppapi_shared_export.h" |
14 | 13 |
15 namespace base { | |
16 class Lock; | |
17 } | |
18 | |
19 namespace ppapi { | 14 namespace ppapi { |
20 | 15 |
21 class CallbackTracker; | 16 class CallbackTracker; |
22 class FunctionGroupBase; | 17 class FunctionGroupBase; |
23 class ResourceTracker; | 18 class ResourceTracker; |
24 class VarTracker; | 19 class VarTracker; |
25 | 20 |
26 // Abstract base class | 21 // Abstract base class |
27 class PPAPI_SHARED_EXPORT PpapiGlobals { | 22 class PPAPI_SHARED_EXPORT PpapiGlobals { |
28 public: | 23 public: |
29 PpapiGlobals(); | 24 PpapiGlobals(); |
30 | |
31 // This constructor is to be used only for making a PpapiGlobal for testing | |
32 // purposes. This avoids setting the global static ppapi_globals_. For unit | |
33 // tests that use this feature, the "test" PpapiGlobals should be constructed | |
34 // using this method. See SetPpapiGlobalsOnThreadForTest for more information. | |
35 struct ForTest {}; | |
36 PpapiGlobals(ForTest); | |
37 | |
38 virtual ~PpapiGlobals(); | 25 virtual ~PpapiGlobals(); |
39 | 26 |
40 // Getter for the global singleton. | 27 // Getter for the global singleton. |
41 inline static PpapiGlobals* Get() { | 28 inline static PpapiGlobals* Get() { return ppapi_globals_; } |
42 if (ppapi_globals_) | |
43 return ppapi_globals_; | |
44 // In unit tests, the following might be valid (see | |
45 // SetPpapiGlobalsOnThreadForTest). Normally, this will just return NULL. | |
46 return GetThreadLocalPointer(); | |
47 } | |
48 | |
49 // This allows us to set a given PpapiGlobals object as the PpapiGlobals for | |
50 // a given thread. After setting the PpapiGlobals for a thread, Get() will | |
51 // return that PpapiGlobals when Get() is called on that thread. Other threads | |
52 // are unaffected. This allows us to have tests which use >1 PpapiGlobals in | |
53 // the same process, e.g. for having 1 thread emulate the "host" and 1 thread | |
54 // emulate the "plugin". | |
55 // | |
56 // PpapiGlobals object must have been constructed using the "ForTest" | |
57 // parameter. | |
58 static void SetPpapiGlobalsOnThreadForTest(PpapiGlobals* ptr); | |
59 | 29 |
60 // Retrieves the corresponding tracker. | 30 // Retrieves the corresponding tracker. |
61 virtual ResourceTracker* GetResourceTracker() = 0; | 31 virtual ResourceTracker* GetResourceTracker() = 0; |
62 virtual VarTracker* GetVarTracker() = 0; | 32 virtual VarTracker* GetVarTracker() = 0; |
63 virtual CallbackTracker* GetCallbackTrackerForInstance( | 33 virtual CallbackTracker* GetCallbackTrackerForInstance( |
64 PP_Instance instance) = 0; | 34 PP_Instance instance) = 0; |
65 virtual base::Lock* GetProxyLock() = 0; | |
66 | 35 |
67 // Returns the function object corresponding to the given ID, or NULL if | 36 // Returns the function object corresponding to the given ID, or NULL if |
68 // there isn't one. | 37 // there isn't one. |
69 virtual FunctionGroupBase* GetFunctionAPI(PP_Instance inst, ApiID id) = 0; | 38 virtual FunctionGroupBase* GetFunctionAPI(PP_Instance inst, ApiID id) = 0; |
70 | 39 |
71 // Returns the PP_Module associated with the given PP_Instance, or 0 on | 40 // Returns the PP_Module associated with the given PP_Instance, or 0 on |
72 // failure. | 41 // failure. |
73 virtual PP_Module GetModuleForInstance(PP_Instance instance) = 0; | 42 virtual PP_Module GetModuleForInstance(PP_Instance instance) = 0; |
74 | 43 |
75 virtual bool IsHostGlobals() const; | |
76 virtual bool IsPluginGlobals() const; | |
77 | |
78 private: | 44 private: |
79 // Return the thread-local pointer which is used only for unit testing. It | |
80 // should always be NULL when running in production. It allows separate | |
81 // threads to have distinct "globals". | |
82 static PpapiGlobals* GetThreadLocalPointer(); | |
83 | |
84 static PpapiGlobals* ppapi_globals_; | 45 static PpapiGlobals* ppapi_globals_; |
85 | 46 |
86 DISALLOW_COPY_AND_ASSIGN(PpapiGlobals); | 47 DISALLOW_COPY_AND_ASSIGN(PpapiGlobals); |
87 }; | 48 }; |
88 | 49 |
89 } // namespace ppapi | 50 } // namespace ppapi |
90 | 51 |
91 #endif // PPAPI_SHARED_IMPL_PPAPI_GLOBALS_H_ | 52 #endif // PPAPI_SHARED_IMPL_PPAPI_GLOBALS_H_ |
OLD | NEW |