Chromium Code Reviews| 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 #ifdef V8_USE_EXTERNAL_STARTUP_DATA | |
| 14 #include "base/files/memory_mapped_file.h" | |
|
rmcilroy
2014/10/07 16:16:11
Do you need this include in the header?
baixo
2014/10/08 11:28:55
No. But I need base/files/file_path.h :).
| |
| 15 #endif | |
| 16 | |
| 13 namespace gin { | 17 namespace gin { |
| 14 | 18 |
| 15 class PerIsolateData; | 19 class PerIsolateData; |
| 16 class RunMicrotasksObserver; | 20 class RunMicrotasksObserver; |
| 17 | 21 |
| 18 // To embed Gin, first initialize gin using IsolateHolder::Initialize and then | 22 // To embed Gin, first initialize gin using IsolateHolder::Initialize and then |
| 19 // create an instance of IsolateHolder to hold the v8::Isolate in which you | 23 // create an instance of IsolateHolder to hold the v8::Isolate in which you |
| 20 // will execute JavaScript. You might wish to subclass IsolateHolder if you | 24 // will execute JavaScript. You might wish to subclass IsolateHolder if you |
| 21 // want to tie more state to the lifetime of the isolate. | 25 // want to tie more state to the lifetime of the isolate. |
| 22 class GIN_EXPORT IsolateHolder { | 26 class GIN_EXPORT IsolateHolder { |
| 23 public: | 27 public: |
| 24 // Controls whether or not V8 should only accept strict mode scripts. | 28 // Controls whether or not V8 should only accept strict mode scripts. |
| 25 enum ScriptMode { | 29 enum ScriptMode { |
| 26 kNonStrictMode, | 30 kNonStrictMode, |
| 27 kStrictMode | 31 kStrictMode |
| 28 }; | 32 }; |
| 29 | 33 |
| 30 IsolateHolder(); | 34 IsolateHolder(); |
| 31 ~IsolateHolder(); | 35 ~IsolateHolder(); |
| 32 | 36 |
| 33 // Should be invoked once before creating IsolateHolder instances to | 37 // Should be invoked once before creating IsolateHolder instances to |
| 34 // initialize V8 and Gin. | 38 // initialize V8 and Gin. |
|
rmcilroy
2014/10/07 16:16:11
Please add a comment here that if V8_USE_EXTERNAL_
baixo
2014/10/08 11:28:55
Done.
| |
| 35 static void Initialize(ScriptMode mode, | 39 static void Initialize(ScriptMode mode, |
| 36 v8::ArrayBuffer::Allocator* allocator); | 40 v8::ArrayBuffer::Allocator* allocator); |
| 37 | 41 |
| 38 v8::Isolate* isolate() { return isolate_; } | 42 v8::Isolate* isolate() { return isolate_; } |
| 39 | 43 |
| 40 // The implementations of Object.observe() and Promise enqueue v8 Microtasks | 44 // The implementations of Object.observe() and Promise enqueue v8 Microtasks |
| 41 // that should be executed just before control is returned to the message | 45 // that should be executed just before control is returned to the message |
| 42 // loop. This method adds a MessageLoop TaskObserver which runs any pending | 46 // loop. This method adds a MessageLoop TaskObserver which runs any pending |
| 43 // Microtasks each time a Task is completed. This method should be called | 47 // Microtasks each time a Task is completed. This method should be called |
| 44 // once, when a MessageLoop is created and it should be called on the | 48 // once, when a MessageLoop is created and it should be called on the |
| 45 // MessageLoop's thread. | 49 // MessageLoop's thread. |
| 46 void AddRunMicrotasksObserver(); | 50 void AddRunMicrotasksObserver(); |
| 47 | 51 |
| 48 // This method should also only be called once, and on the MessageLoop's | 52 // This method should also only be called once, and on the MessageLoop's |
| 49 // thread. | 53 // thread. |
| 50 void RemoveRunMicrotasksObserver(); | 54 void RemoveRunMicrotasksObserver(); |
| 51 | 55 |
| 56 #ifdef V8_USE_EXTERNAL_STARTUP_DATA | |
| 57 #ifdef OS_ANDROID | |
| 58 static bool LoadV8SnapshotFD(int natives_fd, int snapshot_fd); | |
| 59 #endif | |
| 60 static bool LoadV8Snapshot(); | |
| 61 #endif // V8_USE_EXTERNAL_STARTUP_DATA | |
| 62 | |
| 52 private: | 63 private: |
| 53 v8::Isolate* isolate_; | 64 v8::Isolate* isolate_; |
| 54 scoped_ptr<PerIsolateData> isolate_data_; | 65 scoped_ptr<PerIsolateData> isolate_data_; |
| 55 scoped_ptr<RunMicrotasksObserver> task_observer_; | 66 scoped_ptr<RunMicrotasksObserver> task_observer_; |
| 56 | 67 |
| 68 #ifdef V8_USE_EXTERNAL_STARTUP_DATA | |
| 69 | |
| 70 static bool MapV8Files( | |
| 71 base::FilePath* natives_path, base::FilePath* snapshot_path, | |
| 72 int natives = -1, int snapshot = -1); | |
| 73 | |
| 74 #endif // V8_USE_EXTERNAL_STARTUP_DATA | |
| 75 | |
| 57 DISALLOW_COPY_AND_ASSIGN(IsolateHolder); | 76 DISALLOW_COPY_AND_ASSIGN(IsolateHolder); |
| 58 }; | 77 }; |
| 59 | 78 |
| 60 } // namespace gin | 79 } // namespace gin |
| 61 | 80 |
| 62 #endif // GIN_PUBLIC_ISOLATE_HOLDER_H_ | 81 #endif // GIN_PUBLIC_ISOLATE_HOLDER_H_ |
| OLD | NEW |