OLD | NEW |
1 // Copyright (c) 2010 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2010 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 CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_ | 5 #ifndef CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_ |
6 #define CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_ | 6 #define CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/basictypes.h" | 10 #include "base/basictypes.h" |
11 #include "base/memory/weak_ptr.h" | |
12 #include "gin/interceptor.h" | |
13 #include "gin/wrappable.h" | |
14 #include "ppapi/c/pp_var.h" | |
15 | 11 |
| 12 struct PP_Var; |
16 struct PPP_Class_Deprecated; | 13 struct PPP_Class_Deprecated; |
17 | 14 typedef struct NPObject NPObject; |
18 namespace gin { | 15 typedef struct _NPVariant NPVariant; |
19 class Arguments; | |
20 } // namespace gin | |
21 | 16 |
22 namespace content { | 17 namespace content { |
23 | 18 |
24 class PepperPluginInstanceImpl; | 19 class PepperPluginInstanceImpl; |
25 | 20 |
26 // A PluginObject is a JS-accessible object implemented by the plugin. | 21 // A PluginObject is a JS-accessible object implemented by the plugin. |
27 // | 22 // |
28 // In contrast, a var of type PP_VARTYPE_OBJECT is a reference to a JS object, | 23 // In contrast, a var of type PP_VARTYPE_OBJECT is a reference to a JS object, |
29 // which might be implemented by the plugin (here) or by the JS engine. | 24 // which might be implemented by the plugin (here) or by the JS engine. |
30 class PluginObject : public gin::Wrappable<PluginObject>, | 25 class PluginObject { |
31 public gin::NamedPropertyInterceptor { | |
32 public: | 26 public: |
33 static gin::WrapperInfo kWrapperInfo; | |
34 | |
35 virtual ~PluginObject(); | 27 virtual ~PluginObject(); |
36 | 28 |
37 // Returns the PluginObject which is contained in the given v8 object, or NULL | |
38 // if the object isn't backed by a PluginObject. | |
39 static PluginObject* FromV8Object(v8::Isolate* isolate, | |
40 v8::Handle<v8::Object> v8_object); | |
41 | |
42 // Allocates a new PluginObject and returns it as a PP_Var with a | 29 // Allocates a new PluginObject and returns it as a PP_Var with a |
43 // refcount of 1. | 30 // refcount of 1. |
44 static PP_Var Create(PepperPluginInstanceImpl* instance, | 31 static PP_Var Create(PepperPluginInstanceImpl* instance, |
45 const PPP_Class_Deprecated* ppp_class, | 32 const PPP_Class_Deprecated* ppp_class, |
46 void* ppp_class_data); | 33 void* ppp_class_data); |
47 | 34 |
48 // gin::NamedPropertyInterceptor | 35 PepperPluginInstanceImpl* instance() const { return instance_; } |
49 virtual v8::Local<v8::Value> GetNamedProperty( | |
50 v8::Isolate* isolate, | |
51 const std::string& property) OVERRIDE; | |
52 virtual std::vector<std::string> EnumerateNamedProperties( | |
53 v8::Isolate* isolate) OVERRIDE; | |
54 | 36 |
55 const PPP_Class_Deprecated* ppp_class() { return ppp_class_; } | 37 const PPP_Class_Deprecated* ppp_class() { return ppp_class_; } |
56 void* ppp_class_data() { return ppp_class_data_; } | 38 void* ppp_class_data() { |
| 39 return ppp_class_data_; |
| 40 }; |
57 | 41 |
58 // Called when the instance is destroyed. | 42 NPObject* GetNPObject() const; |
59 void InstanceDeleted(); | 43 |
| 44 // Returns true if the given var is an object implemented by the same plugin |
| 45 // that owns the var object, and that the class matches. If it matches, |
| 46 // returns true and places the class data into |*ppp_class_data| (which can |
| 47 // optionally be NULL if no class data is desired). |
| 48 static bool IsInstanceOf(NPObject* np_object, |
| 49 const PPP_Class_Deprecated* ppp_class, |
| 50 void** ppp_class_data); |
| 51 |
| 52 // Converts the given NPObject to the corresponding ObjectVar. |
| 53 // |
| 54 // The given NPObject must be one corresponding to a PluginObject or this |
| 55 // will crash. If the object is a PluginObject but the plugin has gone |
| 56 // away (the object could still be alive because of a reference from JS), |
| 57 // then the return value will be NULL. |
| 58 static PluginObject* FromNPObject(NPObject* object); |
| 59 |
| 60 // Allocates a plugin wrapper object and returns it as an NPObject. This is |
| 61 // used internally only. |
| 62 static NPObject* AllocateObjectWrapper(); |
60 | 63 |
61 private: | 64 private: |
| 65 struct NPObjectWrapper; |
| 66 |
| 67 // This object must be created using the CreateObject function of the which |
| 68 // will set up the correct NPObject. |
| 69 // |
| 70 // The NPObjectWrapper (an NPObject) should already have the reference |
| 71 // incremented on it, and this class will take ownership of that reference. |
62 PluginObject(PepperPluginInstanceImpl* instance, | 72 PluginObject(PepperPluginInstanceImpl* instance, |
| 73 NPObjectWrapper* object_wrapper, |
63 const PPP_Class_Deprecated* ppp_class, | 74 const PPP_Class_Deprecated* ppp_class, |
64 void* ppp_class_data); | 75 void* ppp_class_data); |
65 | 76 |
66 // gin::Wrappable | 77 PepperPluginInstanceImpl* instance_; |
67 virtual gin::ObjectTemplateBuilder GetObjectTemplateBuilder( | |
68 v8::Isolate* isolate) OVERRIDE; | |
69 | 78 |
70 // Helper method to get named properties. | 79 // Holds a pointer to the NPObject wrapper backing the var. This class |
71 v8::Local<v8::Value> GetPropertyOrMethod(v8::Isolate* isolate, | 80 // derives from NPObject and we hold a reference to it, so it must be |
72 PP_Var identifier_var); | 81 // refcounted. When the type is not an object, this value will be NULL. |
73 | 82 // |
74 void Call(const std::string& identifier, gin::Arguments* args); | 83 // We don't actually own this pointer, it's the NPObject that actually |
75 | 84 // owns us. |
76 PepperPluginInstanceImpl* instance_; | 85 NPObjectWrapper* object_wrapper_; |
77 | 86 |
78 const PPP_Class_Deprecated* ppp_class_; | 87 const PPP_Class_Deprecated* ppp_class_; |
79 void* ppp_class_data_; | 88 void* ppp_class_data_; |
80 | 89 |
81 base::WeakPtrFactory<PluginObject> weak_factory_; | |
82 | |
83 DISALLOW_COPY_AND_ASSIGN(PluginObject); | 90 DISALLOW_COPY_AND_ASSIGN(PluginObject); |
84 }; | 91 }; |
85 | 92 |
86 } // namespace content | 93 } // namespace content |
87 | 94 |
88 #endif // CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_ | 95 #endif // CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_ |
OLD | NEW |