Reland: Plugin Placeholders: Refactor for platforms that don't support plugins

gin/wrappable.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef GIN_WRAPPABLE_H_
 #define GIN_WRAPPABLE_H_
 
+#include "base/logging.h"
 #include "base/template_util.h"
 #include "gin/converter.h"
 #include "gin/gin_export.h"
 #include "gin/public/wrapper_info.h"
 
 namespace gin {
 
-namespace internal {
-
-GIN_EXPORT void* FromV8Impl(v8::Isolate* isolate,
-                            v8::Local<v8::Value> val,
-                            WrapperInfo* info);
-
-}  // namespace internal
-
-
 // Wrappable is a base class for C++ objects that have corresponding v8 wrapper
 // objects. To retain a Wrappable object on the stack, use a gin::Handle.
 //
 // USAGE:
 // // my_class.h
 // class MyClass : Wrappable<MyClass> {
 //  public:
 //   static WrapperInfo kWrapperInfo;
 //
 //   // Optional, only required if non-empty template should be used.
@@ skipping 10 matching lines @@
 //   return Wrappable<MyClass>::GetObjectTemplateBuilder(isolate)
 //       .SetValue("foobar", 42);
 // }
 //
 // Subclasses should also typically have private constructors and expose a
 // static Create function that returns a gin::Handle. Forcing creators through
 // this static Create function will enforce that clients actually create a
 // wrapper for the object. If clients fail to create a wrapper for a wrappable
 // object, the object will leak because we use the weak callback from the
 // wrapper as the signal to delete the wrapped object.
-template<typename T>
-class Wrappable;
 
 class ObjectTemplateBuilder;
 
 // Non-template base class to share code between templates instances.
 class GIN_EXPORT WrappableBase {
  protected:
   WrappableBase();
   virtual ~WrappableBase();
 
   virtual ObjectTemplateBuilder GetObjectTemplateBuilder(v8::Isolate* isolate);
 
   v8::Local<v8::Object> GetWrapperImpl(v8::Isolate* isolate,
-                                        WrapperInfo* wrapper_info);
+                                       WrapperInfo* wrapper_info);
 
  private:
   static void FirstWeakCallback(
       const v8::WeakCallbackInfo<WrappableBase>& data);
   static void SecondWeakCallback(
       const v8::WeakCallbackInfo<WrappableBase>& data);
 
   v8::Global<v8::Object> wrapper_;  // Weak
 
   DISALLOW_COPY_AND_ASSIGN(WrappableBase);
 };
 
 
 template<typename T>
 class Wrappable : public WrappableBase {
  public:
+  // Subclasses derived from T that override GetObjectTemplateBuilder must
+  // also override this method. Otherwise, they will have the same WrapperInfo
+  // as T, and share a cached v8::ObjectTemplate. That will lead to crashes.
+  virtual WrapperInfo* GetWrapperInfo() { return &T::kWrapperInfo; }
+
   // Retrieve (or create) the v8 wrapper object cooresponding to this object.
   // To customize the wrapper created for a subclass, override GetWrapperInfo()
   // instead of overriding this function.
   v8::Local<v8::Object> GetWrapper(v8::Isolate* isolate) {
-    return GetWrapperImpl(isolate, &T::kWrapperInfo);
+    return GetWrapperImpl(isolate, GetWrapperInfo());
   }
 
  protected:
   Wrappable() {}
   virtual ~Wrappable() {}
 
  private:
   DISALLOW_COPY_AND_ASSIGN(Wrappable);
 };
 
-
 // This converter handles any subclass of Wrappable.
 template<typename T>
 struct Converter<T*, typename base::enable_if<
                        base::is_convertible<T*, WrappableBase*>::value>::type> {
   static v8::Local<v8::Value> ToV8(v8::Isolate* isolate, T* val) {
     return val->GetWrapper(isolate);
   }
 
   static bool FromV8(v8::Isolate* isolate, v8::Local<v8::Value> val, T** out) {

[tommycli, 2015/06/02 22:01:23]

These changes are inspired by reverting some changes of a year ago:
https://codereview.chromium.org/105743007/diff/100001/gin/wrappable.h

-    *out = static_cast<T*>(static_cast<WrappableBase*>(
-        internal::FromV8Impl(isolate, val, &T::kWrapperInfo)));
-    return *out != NULL;
+    if (!val->IsObject())
+      return false;
+    v8::Local<v8::Object> obj = v8::Local<v8::Object>::Cast(val);
+    WrapperInfo* info = WrapperInfo::From(obj);
+
+    // If this fails, the object is not managed by Gin. It is either a normal JS
+    // object that's not wrapping any external C++ object, or it is wrapping
+    // some C++ object, but that object isn't managed by Gin (maybe Blink).
+    if (!info)
+      return false;
+
+    // The stored pointer points to the WrappableBase portion of the object,
+    // so we must convert to WrappableBase first, then downcast, to correctly
+    // adjust the pointer to point to the the T object.
+    WrappableBase* pointer = static_cast<WrappableBase*>(
+        obj->GetAlignedPointerFromInternalField(kEncodedValueIndex));
+
+    // There is no way to detect if pointer is really of type T without RTTI.
+    // We cannot compare to &T::kWrapperInfo, as subclasses of T can override
+    // GetWrapperInfo(). This is unfortunate, but needed to support subclasses.

[tommycli, 2015/06/02 22:01:23]

I tried various methods for hours, but my conclusion is: We cannot
simultaneously support subclassing T and also be able to detect if the stored
pointer is really an object that derives from T, since GetWrapperInfo() can be
overridden.

This is lame, but I think most calls into this function are created via the
ObjectTemplateBuilder, which won't make this mistake...

+    *out = static_cast<T*>(pointer);
+    return true;
   }
 };
 
 }  // namespace gin
 
 #endif  // GIN_WRAPPABLE_H_