OLD | NEW |
| (Empty) |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #ifndef CONTENT_RENDERER_PEPPER_NPOBJECT_VAR_H_ | |
6 #define CONTENT_RENDERER_PEPPER_NPOBJECT_VAR_H_ | |
7 | |
8 #include <string> | |
9 | |
10 #include "base/compiler_specific.h" | |
11 #include "ppapi/c/pp_instance.h" | |
12 #include "ppapi/shared_impl/var.h" | |
13 #include "content/common/content_export.h" | |
14 | |
15 typedef struct NPObject NPObject; | |
16 typedef struct _NPVariant NPVariant; | |
17 typedef void* NPIdentifier; | |
18 | |
19 namespace ppapi { | |
20 | |
21 // NPObjectVar ----------------------------------------------------------------- | |
22 | |
23 // Represents a JavaScript object Var. By itself, this represents random | |
24 // NPObjects that a given plugin (identified by the resource's module) wants to | |
25 // reference. If two different modules reference the same NPObject (like the | |
26 // "window" object), then there will be different NPObjectVar's (and hence | |
27 // PP_Var IDs) for each module. This allows us to track all references owned by | |
28 // a given module and free them when the plugin exits independently of other | |
29 // plugins that may be running at the same time. | |
30 class NPObjectVar : public Var { | |
31 public: | |
32 // You should always use FromNPObject to create an NPObjectVar. This function | |
33 // guarantees that we maintain the 1:1 mapping between NPObject and | |
34 // NPObjectVar. | |
35 NPObjectVar(PP_Instance instance, NPObject* np_object); | |
36 | |
37 // Var overrides. | |
38 virtual NPObjectVar* AsNPObjectVar() OVERRIDE; | |
39 virtual PP_VarType GetType() const OVERRIDE; | |
40 | |
41 // Returns the underlying NPObject corresponding to this NPObjectVar. | |
42 // Guaranteed non-NULL. | |
43 NPObject* np_object() const { return np_object_; } | |
44 | |
45 // Notification that the instance was deleted, the internal reference will be | |
46 // zeroed out. | |
47 void InstanceDeleted(); | |
48 | |
49 // Possibly 0 if the object has outlived its instance. | |
50 PP_Instance pp_instance() const { return pp_instance_; } | |
51 | |
52 // Helper function that converts a PP_Var to an object. This will return NULL | |
53 // if the PP_Var is not of object type or the object is invalid. | |
54 CONTENT_EXPORT static scoped_refptr<NPObjectVar> FromPPVar(PP_Var var); | |
55 | |
56 private: | |
57 virtual ~NPObjectVar(); | |
58 | |
59 // Possibly 0 if the object has outlived its instance. | |
60 PP_Instance pp_instance_; | |
61 | |
62 // Guaranteed non-NULL, this is the underlying object used by WebKit. We | |
63 // hold a reference to this object. | |
64 NPObject* np_object_; | |
65 | |
66 DISALLOW_COPY_AND_ASSIGN(NPObjectVar); | |
67 }; | |
68 | |
69 } // ppapi | |
70 | |
71 #endif // CONTENT_RENDERER_PEPPER_NPOBJECT_VAR_H_ | |
OLD | NEW |