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_RUNNER_H_ | 5 #ifndef GIN_RUNNER_H_ |
6 #define GIN_RUNNER_H_ | 6 #define GIN_RUNNER_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/memory/weak_ptr.h" | 10 #include "base/memory/weak_ptr.h" |
| 11 #include "gin/gin_export.h" |
11 #include "gin/public/context_holder.h" | 12 #include "gin/public/context_holder.h" |
12 | 13 |
13 namespace gin { | 14 namespace gin { |
14 | 15 |
15 class Runner; | 16 class Runner; |
16 class TryCatch; | 17 class TryCatch; |
17 | 18 |
18 // Subclass RunnerDelegate to customize the behavior of |Runner|. Typical | 19 // Subclass RunnerDelegate to customize the behavior of |Runner|. Typical |
19 // embedders will want to subclass one of the specialized RunnerDelegates, | 20 // embedders will want to subclass one of the specialized RunnerDelegates, |
20 // such as ModuleRunnerDelegate. | 21 // such as ModuleRunnerDelegate. |
21 class RunnerDelegate { | 22 class GIN_EXPORT RunnerDelegate { |
22 public: | 23 public: |
23 RunnerDelegate(); | 24 RunnerDelegate(); |
24 virtual ~RunnerDelegate(); | 25 virtual ~RunnerDelegate(); |
25 | 26 |
26 // Returns the template for the global object. | 27 // Returns the template for the global object. |
27 virtual v8::Handle<v8::ObjectTemplate> GetGlobalTemplate(Runner* runner); | 28 virtual v8::Handle<v8::ObjectTemplate> GetGlobalTemplate(Runner* runner); |
28 virtual void DidCreateContext(Runner* runner); | 29 virtual void DidCreateContext(Runner* runner); |
29 virtual void WillRunScript(Runner* runner); | 30 virtual void WillRunScript(Runner* runner); |
30 virtual void DidRunScript(Runner* runner); | 31 virtual void DidRunScript(Runner* runner); |
31 virtual void UnhandledException(Runner* runner, TryCatch& try_catch); | 32 virtual void UnhandledException(Runner* runner, TryCatch& try_catch); |
32 }; | 33 }; |
33 | 34 |
34 // Runner lets you run code in a v8::Context. Upon construction, Runner will | 35 // Runner lets you run code in a v8::Context. Upon construction, Runner will |
35 // create a v8::Context. Upon destruction, Runner will dispose the context. | 36 // create a v8::Context. Upon destruction, Runner will dispose the context. |
36 class Runner : public ContextHolder { | 37 class GIN_EXPORT Runner : public ContextHolder { |
37 public: | 38 public: |
38 Runner(RunnerDelegate* delegate, v8::Isolate* isolate); | 39 Runner(RunnerDelegate* delegate, v8::Isolate* isolate); |
39 ~Runner(); | 40 ~Runner(); |
40 | 41 |
41 // Before running script in this context, you'll need to enter the runner's | 42 // Before running script in this context, you'll need to enter the runner's |
42 // context by creating an instance of Runner::Scope on the stack. | 43 // context by creating an instance of Runner::Scope on the stack. |
43 void Run(const std::string& source, const std::string& resource_name); | 44 void Run(const std::string& source, const std::string& resource_name); |
44 void Run(v8::Handle<v8::Script> script); | 45 void Run(v8::Handle<v8::Script> script); |
45 | 46 |
46 v8::Handle<v8::Value> Call(v8::Handle<v8::Function> function, | 47 v8::Handle<v8::Value> Call(v8::Handle<v8::Function> function, |
47 v8::Handle<v8::Value> receiver, | 48 v8::Handle<v8::Value> receiver, |
48 int argc, | 49 int argc, |
49 v8::Handle<v8::Value> argv[]); | 50 v8::Handle<v8::Value> argv[]); |
50 | 51 |
51 v8::Handle<v8::Object> global() const { | 52 v8::Handle<v8::Object> global() const { |
52 return context()->Global(); | 53 return context()->Global(); |
53 } | 54 } |
54 | 55 |
55 // Useful for running script in this context asynchronously. Rather than | 56 // Useful for running script in this context asynchronously. Rather than |
56 // holding a raw pointer to the runner, consider holding a WeakPtr. | 57 // holding a raw pointer to the runner, consider holding a WeakPtr. |
57 base::WeakPtr<Runner> GetWeakPtr() { | 58 base::WeakPtr<Runner> GetWeakPtr() { |
58 return weak_factory_.GetWeakPtr(); | 59 return weak_factory_.GetWeakPtr(); |
59 } | 60 } |
60 | 61 |
61 class Scope { | 62 class GIN_EXPORT Scope { |
62 public: | 63 public: |
63 explicit Scope(Runner* runner); | 64 explicit Scope(Runner* runner); |
64 ~Scope(); | 65 ~Scope(); |
65 | 66 |
66 private: | 67 private: |
67 v8::Isolate::Scope isolate_scope_; | 68 v8::Isolate::Scope isolate_scope_; |
68 v8::HandleScope handle_scope_; | 69 v8::HandleScope handle_scope_; |
69 v8::Context::Scope scope_; | 70 v8::Context::Scope scope_; |
70 | 71 |
71 DISALLOW_COPY_AND_ASSIGN(Scope); | 72 DISALLOW_COPY_AND_ASSIGN(Scope); |
72 }; | 73 }; |
73 | 74 |
74 private: | 75 private: |
75 friend class Scope; | 76 friend class Scope; |
76 | 77 |
77 RunnerDelegate* delegate_; | 78 RunnerDelegate* delegate_; |
78 | 79 |
79 base::WeakPtrFactory<Runner> weak_factory_; | 80 base::WeakPtrFactory<Runner> weak_factory_; |
80 | 81 |
81 DISALLOW_COPY_AND_ASSIGN(Runner); | 82 DISALLOW_COPY_AND_ASSIGN(Runner); |
82 }; | 83 }; |
83 | 84 |
84 } // namespace gin | 85 } // namespace gin |
85 | 86 |
86 #endif // GIN_RUNNER_H_ | 87 #endif // GIN_RUNNER_H_ |
OLD | NEW |