gin/public/isolate_holder.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_PUBLIC_ISOLATE_HOLDER_H_
   6 #define GIN_PUBLIC_ISOLATE_HOLDER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/memory/scoped_ptr.h"
  10 #include "gin/gin_export.h"
  11 #include "v8/include/v8.h"
  12
  13 namespace gin {
  14
  15 class PerIsolateData;
  16
  17 // To embed Gin, first create an instance of IsolateHolder to hold the
  18 // v8::Isolate in which you will execute JavaScript. You might wish to subclass
  19 // IsolateHolder if you want to tie more state to the lifetime of the isolate.
  20 //
  21 // You can use gin in two modes: either gin manages V8, or the gin-embedder
  22 // manages gin. If gin manages V8, use the IsolateHolder constructor that does
  23 // not take an v8::Isolate parameter, otherwise, the gin-embedder needs to
  24 // create v8::Isolates and pass them to IsolateHolder.
  25 //
  26 // It is not possible to mix the two.
  27 class GIN_EXPORT IsolateHolder {
  28  public:
  29   // Controls whether or not V8 should only accept strict mode scripts.
  30   enum ScriptMode {
  31     kNonStrictMode,
  32     kStrictMode
  33   };
  34
  35   explicit IsolateHolder(ScriptMode mode);
  36   IsolateHolder(v8::Isolate* isolate, v8::ArrayBuffer::Allocator* allocator);
  37
  38   ~IsolateHolder();
  39
  40   v8::Isolate* isolate() { return isolate_; }
  41
  42  private:
  43   void Init(v8::ArrayBuffer::Allocator* allocator);
  44
  45   bool isolate_owner_;
  46   v8::Isolate* isolate_;
  47   scoped_ptr<PerIsolateData> isolate_data_;
  48
  49   DISALLOW_COPY_AND_ASSIGN(IsolateHolder);
  50 };
  51
  52 }  // namespace gin
  53
  54 #endif  // GIN_PUBLIC_ISOLATE_HOLDER_H_