src/content/renderer/pepper/plugin_object.h

   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
   3 // found in the LICENSE file.
   4
   5 #ifndef CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_
   6 #define CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_
   7
   8 #include <string>
   9
  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
  16 struct PPP_Class_Deprecated;
  17
  18 namespace gin {
  19   class Arguments;
  20 }  // namespace gin
  21
  22 namespace content {
  23
  24 class PepperPluginInstanceImpl;
  25
  26 // A PluginObject is a JS-accessible object implemented by the plugin.
  27 //
  28 // 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.
  30 class PluginObject : public gin::Wrappable<PluginObject>,
  31                      public gin::NamedPropertyInterceptor {
  32  public:
  33   static gin::WrapperInfo kWrapperInfo;
  34
  35   ~PluginObject() override;
  36
  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
  43   // refcount of 1.
  44   static PP_Var Create(PepperPluginInstanceImpl* instance,
  45                        const PPP_Class_Deprecated* ppp_class,
  46                        void* ppp_class_data);
  47
  48   // gin::NamedPropertyInterceptor
  49   v8::Local<v8::Value> GetNamedProperty(v8::Isolate* isolate,
  50                                         const std::string& property) override;
  51   bool SetNamedProperty(v8::Isolate* isolate,
  52                         const std::string& property,
  53                         v8::Local<v8::Value> value) override;
  54   std::vector<std::string> EnumerateNamedProperties(
  55       v8::Isolate* isolate) override;
  56
  57   const PPP_Class_Deprecated* ppp_class() { return ppp_class_; }
  58   void* ppp_class_data() { return ppp_class_data_; }
  59
  60   // Called when the instance is destroyed.
  61   void InstanceDeleted();
  62
  63  private:
  64   PluginObject(PepperPluginInstanceImpl* instance,
  65                const PPP_Class_Deprecated* ppp_class,
  66                void* ppp_class_data);
  67
  68   // gin::Wrappable
  69   gin::ObjectTemplateBuilder GetObjectTemplateBuilder(
  70       v8::Isolate* isolate) override;
  71
  72   // Helper method to get named properties.
  73   v8::Local<v8::Value> GetPropertyOrMethod(v8::Isolate* isolate,
  74                                            PP_Var identifier_var);
  75
  76   void Call(const std::string& identifier, gin::Arguments* args);
  77
  78   PepperPluginInstanceImpl* instance_;
  79
  80   const PPP_Class_Deprecated* ppp_class_;
  81   void* ppp_class_data_;
  82
  83   base::WeakPtrFactory<PluginObject> weak_factory_;
  84
  85   DISALLOW_COPY_AND_ASSIGN(PluginObject);
  86 };
  87
  88 }  // namespace content
  89
  90 #endif  // CONTENT_RENDERER_PEPPER_PLUGIN_OBJECT_H_