OLD | NEW |
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef GIN_PUBLIC_ISOLATE_HOLDER_H_ | 5 #ifndef GIN_PUBLIC_ISOLATE_HOLDER_H_ |
6 #define GIN_PUBLIC_ISOLATE_HOLDER_H_ | 6 #define GIN_PUBLIC_ISOLATE_HOLDER_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
9 #include "base/memory/scoped_ptr.h" | 9 #include "base/memory/scoped_ptr.h" |
10 #include "gin/gin_export.h" | 10 #include "gin/gin_export.h" |
11 #include "v8/include/v8.h" | 11 #include "v8/include/v8.h" |
12 | 12 |
13 namespace gin { | 13 namespace gin { |
14 | 14 |
15 class PerIsolateData; | 15 class PerIsolateData; |
16 | 16 |
17 // To embed Gin, first create an instance of IsolateHolder to hold the | 17 // To embed Gin, first initialize gin using IsolateHolder::Initialize and then |
18 // v8::Isolate in which you will execute JavaScript. You might wish to subclass | 18 // create an instance of IsolateHolder to hold the v8::Isolate in which you |
19 // IsolateHolder if you want to tie more state to the lifetime of the isolate. | 19 // will execute JavaScript. You might wish to subclass IsolateHolder if you |
20 // | 20 // want to tie more state to the lifetime of the isolate. |
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 { | 21 class GIN_EXPORT IsolateHolder { |
28 public: | 22 public: |
29 // Controls whether or not V8 should only accept strict mode scripts. | 23 // Controls whether or not V8 should only accept strict mode scripts. |
30 enum ScriptMode { | 24 enum ScriptMode { |
31 kNonStrictMode, | 25 kNonStrictMode, |
32 kStrictMode | 26 kStrictMode |
33 }; | 27 }; |
34 | 28 |
35 IsolateHolder(); | 29 IsolateHolder(); |
36 // Deprecated. | |
37 IsolateHolder(v8::Isolate* isolate, v8::ArrayBuffer::Allocator* allocator); | |
38 | |
39 ~IsolateHolder(); | 30 ~IsolateHolder(); |
40 | 31 |
41 // Should be invoked once before creating IsolateHolder instances to | 32 // Should be invoked once before creating IsolateHolder instances to |
42 // initialize V8 and Gin. | 33 // initialize V8 and Gin. |
43 static void Initialize(ScriptMode mode, | 34 static void Initialize(ScriptMode mode, |
44 v8::ArrayBuffer::Allocator* allocator); | 35 v8::ArrayBuffer::Allocator* allocator); |
45 | 36 |
46 v8::Isolate* isolate() { return isolate_; } | 37 v8::Isolate* isolate() { return isolate_; } |
47 | 38 |
48 private: | 39 private: |
49 void Init(v8::ArrayBuffer::Allocator* allocator); | |
50 | |
51 bool isolate_owner_; | |
52 v8::Isolate* isolate_; | 40 v8::Isolate* isolate_; |
53 scoped_ptr<PerIsolateData> isolate_data_; | 41 scoped_ptr<PerIsolateData> isolate_data_; |
54 | 42 |
55 DISALLOW_COPY_AND_ASSIGN(IsolateHolder); | 43 DISALLOW_COPY_AND_ASSIGN(IsolateHolder); |
56 }; | 44 }; |
57 | 45 |
58 } // namespace gin | 46 } // namespace gin |
59 | 47 |
60 #endif // GIN_PUBLIC_ISOLATE_HOLDER_H_ | 48 #endif // GIN_PUBLIC_ISOLATE_HOLDER_H_ |
OLD | NEW |