gin/per_isolate_data.h

   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_PER_ISOLATE_DATA_H_
   6 #define GIN_PER_ISOLATE_DATA_H_
   7
   8 #include <map>
   9
  10 #include "base/basictypes.h"
  11 #include "gin/gin_export.h"
  12 #include "gin/public/wrapper_info.h"
  13 #include "v8/include/v8.h"
  14
  15 namespace gin {
  16
  17 class IndexedPropertyInterceptor;
  18 class NamedPropertyInterceptor;
  19 class WrappableBase;
  20
  21 // There is one instance of PerIsolateData per v8::Isolate managed by Gin. This
  22 // class stores all the Gin-related data that varies per isolate.
  23 class GIN_EXPORT PerIsolateData {
  24  public:
  25   PerIsolateData(v8::Isolate* isolate, v8::ArrayBuffer::Allocator* allocator);
  26   ~PerIsolateData();
  27
  28   static PerIsolateData* From(v8::Isolate* isolate);
  29
  30   // Each isolate is associated with a collection of v8::ObjectTemplates and
  31   // v8::FunctionTemplates. Typically these template objects are created
  32   // lazily.
  33   void SetObjectTemplate(WrapperInfo* info,
  34                          v8::Local<v8::ObjectTemplate> object_template);
  35   void SetFunctionTemplate(WrapperInfo* info,
  36                            v8::Local<v8::FunctionTemplate> function_template);
  37
  38   // These are low-level functions for retrieving object or function templates
  39   // stored in this object. Because these templates are often created lazily,
  40   // most clients should call higher-level functions that know how to populate
  41   // these templates if they haven't already been created.
  42   v8::Local<v8::ObjectTemplate> GetObjectTemplate(WrapperInfo* info);
  43   v8::Local<v8::FunctionTemplate> GetFunctionTemplate(WrapperInfo* info);
  44
  45   // We maintain a map from Wrappable objects that derive from one of the
  46   // interceptor interfaces to the interceptor interface pointers.
  47   void SetIndexedPropertyInterceptor(WrappableBase* base,
  48                                      IndexedPropertyInterceptor* interceptor);
  49   void SetNamedPropertyInterceptor(WrappableBase* base,
  50                                    NamedPropertyInterceptor* interceptor);
  51
  52   void ClearIndexedPropertyInterceptor(WrappableBase* base,
  53                                        IndexedPropertyInterceptor* interceptor);
  54   void ClearNamedPropertyInterceptor(WrappableBase* base,
  55                                      NamedPropertyInterceptor* interceptor);
  56
  57   IndexedPropertyInterceptor* GetIndexedPropertyInterceptor(
  58       WrappableBase* base);
  59   NamedPropertyInterceptor* GetNamedPropertyInterceptor(WrappableBase* base);
  60
  61   v8::Isolate* isolate() { return isolate_; }
  62   v8::ArrayBuffer::Allocator* allocator() { return allocator_; }
  63
  64  private:
  65   typedef std::map<
  66       WrapperInfo*, v8::Eternal<v8::ObjectTemplate> > ObjectTemplateMap;
  67   typedef std::map<
  68       WrapperInfo*, v8::Eternal<v8::FunctionTemplate> > FunctionTemplateMap;
  69   typedef std::map<WrappableBase*, IndexedPropertyInterceptor*>
  70       IndexedPropertyInterceptorMap;
  71   typedef std::map<WrappableBase*, NamedPropertyInterceptor*>
  72       NamedPropertyInterceptorMap;
  73
  74   // PerIsolateData doesn't actually own |isolate_|. Instead, the isolate is
  75   // owned by the IsolateHolder, which also owns the PerIsolateData.
  76   v8::Isolate* isolate_;
  77   v8::ArrayBuffer::Allocator* allocator_;
  78   ObjectTemplateMap object_templates_;
  79   FunctionTemplateMap function_templates_;
  80   IndexedPropertyInterceptorMap indexed_interceptors_;
  81   NamedPropertyInterceptorMap named_interceptors_;
  82
  83   DISALLOW_COPY_AND_ASSIGN(PerIsolateData);
  84 };
  85
  86 }  // namespace gin
  87
  88 #endif  // GIN_PER_ISOLATE_DATA_H_