1 // Copyright 2013 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 GIN_HANDLE_H_ 6 #define GIN_HANDLE_H_ 7 8 #include "gin/converter.h" 9 10 namespace gin { 11 12 // You can use gin::Handle on the stack to retain a gin::Wrappable object. 13 // Currently we don't have a mechanism for retaining a gin::Wrappable object 14 // in the C++ heap because strong references from C++ to V8 can cause memory 15 // leaks. 16 template<typename T> 17 class Handle { 18 public: 19 Handle() : object_(NULL) {} 20 21 Handle(v8::Handle<v8::Value> wrapper, T* object) 22 : wrapper_(wrapper), 23 object_(object) { 24 } 25 26 bool IsEmpty() const { return !object_; } 27 28 void Clear() { 29 wrapper_.Clear(); 30 object_ = NULL; 31 } 32 33 T* operator->() const { return object_; } 34 v8::Handle<v8::Value> ToV8() const { return wrapper_; } 35 T* get() const { return object_; } 36 37 private: 38 v8::Handle<v8::Value> wrapper_; 39 T* object_; 40 }; 41 42 template<typename T> 43 struct Converter<gin::Handle<T> > { 44 static v8::Handle<v8::Value> ToV8(v8::Isolate* isolate, 45 const gin::Handle<T>& val) { 46 return val.ToV8(); 47 } 48 static bool FromV8(v8::Isolate* isolate, v8::Handle<v8::Value> val, 49 gin::Handle<T>* out) { 50 T* object = NULL; 51 if (!Converter<T*>::FromV8(isolate, val, &object)) { 52 return false; 53 } 54 *out = gin::Handle<T>(val, object); 55 return true; 56 } 57 }; 58 59 // This function is a convenient way to create a handle from a raw pointer 60 // without having to write out the type of the object explicitly. 61 template<typename T> 62 gin::Handle<T> CreateHandle(v8::Isolate* isolate, T* object) { 63 return gin::Handle<T>(object->GetWrapper(isolate), object); 64 } 65 66 } // namespace gin 67 68 #endif // GIN_HANDLE_H_ 69