bindings: Adds virtual ScriptWrappable::wrap method.

Source/bindings/core/v8/ScriptWrappable.h

 /*
  * Copyright (C) 2010 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 130 matching lines @@
     // adopted and so forth. The overloaded initializeScriptWrappableForInterface()
     // functions are implemented by the generated V8 bindings code. Declaring the
     // extern function in the template avoids making a centralized header of all
     // the bindings in the universe. C++11's extern template feature may provide
     // a cleaner solution someday.
     template <class C> static void init(C* object)
     {
         initializeScriptWrappableHelper(object);
     }
 
+    // Returns the WrapperTypeInfo of the instance.
+    //
+    // This method must be overridden by using DEFINE_WRAPPERTYPEINFO macro.

[haraken, 2014/08/29 05:24:04]

by using => by

[Yuki, 2014/09/01 06:06:39]

Done.

[Yuki, 2014/09/01 06:06:39]

Done.

+    virtual const WrapperTypeInfo* wrapperTypeInfo() const = 0;
+
+    // Creates and returns a new wrapper object.
+    virtual v8::Handle<v8::Object> wrap(v8::Handle<v8::Object> creationContext, v8::Isolate*);
+
     void setWrapper(v8::Handle<v8::Object> wrapper, v8::Isolate* isolate, const WrapperConfiguration& configuration)
     {
         ASSERT(!containsWrapper());
         if (!*wrapper) {
             m_wrapperOrTypeInfo = 0;
             return;
         }
         v8::Persistent<v8::Object> persistent(isolate, wrapper);
         configuration.configureWrapper(&persistent);
         persistent.SetWeak(this, &setWeakCallback);
@@ skipping 170 matching lines @@
         ASSERT(persistent == data.GetValue());
         data.GetParameter()->disposeWrapper(data.GetValue());
 
         // FIXME: I noticed that 50%~ of minor GC cycle times can be consumed
         // inside data.GetParameter()->deref(), which causes Node destructions. We should
         // make Node destructions incremental.
         releaseObject(data.GetValue());
     }
 };
 
+// Defines 'wrapperTypeInfo' virtual method which returns the WrapperTypeInfo of
+// the instance. Also declares a static member of type WrapperTypeInfo, of which
+// the definition is given by the IDL code generator.
+//
+// All the derived classes of ScriptWrappable, regardless of directly or
+// indirectly, must write this macro in the class definition except for the case
+// that the class is NoInterfaceObject.

[haraken, 2014/08/29 05:24:04]

Help me understand: What's the relationship between [NoInterfaceObject] and
DEFINE_WRAPPERTYPEINFO() ?

[Yuki, 2014/09/01 06:06:39]

Added more comment.

+#define DEFINE_WRAPPERTYPEINFO() \
+public: \
+    virtual const WrapperTypeInfo* wrapperTypeInfo() const OVERRIDE \
+    { \
+        return &s_wrapperTypeInfo; \
+    } \
+private: \
+    static const WrapperTypeInfo& s_wrapperTypeInfo
+
 } // namespace blink
 
 #endif // ScriptWrappable_h