| // Copyright 2013 The Chromium Authors. All rights reserved. | |
| // Use of this source code is governed by a BSD-style license that can be | |
| // found in the LICENSE file. | |
| #ifndef GIN_RUNNER_H_ | |
| #define GIN_RUNNER_H_ | |
| #include <string> | |
| #include "base/macros.h" | |
| #include "base/memory/weak_ptr.h" | |
| #include "gin/gin_export.h" | |
| #include "gin/public/context_holder.h" | |
| #include "v8/include/v8.h" | |
| namespace gin { | |
| // Runner is responsible for running code in a v8::Context. | |
| class GIN_EXPORT Runner { | |
| public: | |
| Runner(); | |
| virtual ~Runner(); | |
| // Before running script in this context, you'll need to enter the runner's | |
| // context by creating an instance of Runner::Scope on the stack. | |
| virtual void Run(const std::string& source, | |
| const std::string& resource_name) = 0; | |
| virtual v8::Local<v8::Value> Call(v8::Local<v8::Function> function, | |
| v8::Local<v8::Value> receiver, | |
| int argc, | |
| v8::Local<v8::Value> argv[]) = 0; | |
| virtual ContextHolder* GetContextHolder() = 0; | |
| v8::Local<v8::Object> global() { | |
| return GetContextHolder()->context()->Global(); | |
| } | |
| // Useful for running script in this context asynchronously. Rather than | |
| // holding a raw pointer to the runner, consider holding a WeakPtr. | |
| base::WeakPtr<Runner> GetWeakPtr() { | |
| return weak_factory_.GetWeakPtr(); | |
| } | |
| class GIN_EXPORT Scope { | |
| public: | |
| explicit Scope(Runner* runner); | |
| ~Scope(); | |
| private: | |
| v8::Isolate::Scope isolate_scope_; | |
| v8::HandleScope handle_scope_; | |
| v8::Context::Scope scope_; | |
| DISALLOW_COPY_AND_ASSIGN(Scope); | |
| }; | |
| private: | |
| friend class Scope; | |
| base::WeakPtrFactory<Runner> weak_factory_; | |
| DISALLOW_COPY_AND_ASSIGN(Runner); | |
| }; | |
| } // namespace gin | |
| #endif // GIN_RUNNER_H_ |