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_RUNNER_H_
6#define GIN_RUNNER_H_
7
8#include <string>
9
10#include "base/memory/weak_ptr.h"
11#include "gin/gin_export.h"
12#include "gin/public/context_holder.h"
13#include "v8/include/v8.h"
14
15namespace gin {
16
17// Runner is responsible for running code in a v8::Context.
18class GIN_EXPORT Runner {
19 public:
20  Runner();
21  virtual ~Runner();
22
23  // Before running script in this context, you'll need to enter the runner's
24  // context by creating an instance of Runner::Scope on the stack.
25  virtual void Run(const std::string& source,
26                   const std::string& resource_name) = 0;
27  virtual v8::Handle<v8::Value> Call(v8::Handle<v8::Function> function,
28                                     v8::Handle<v8::Value> receiver,
29                                     int argc,
30                                     v8::Handle<v8::Value> argv[]) = 0;
31  virtual ContextHolder* GetContextHolder() = 0;
32
33  v8::Handle<v8::Object> global() {
34    return GetContextHolder()->context()->Global();
35  }
36
37  // Useful for running script in this context asynchronously. Rather than
38  // holding a raw pointer to the runner, consider holding a WeakPtr.
39  base::WeakPtr<Runner> GetWeakPtr() {
40    return weak_factory_.GetWeakPtr();
41  }
42
43  class GIN_EXPORT Scope {
44   public:
45    explicit Scope(Runner* runner);
46    ~Scope();
47
48   private:
49    v8::Isolate::Scope isolate_scope_;
50    v8::HandleScope handle_scope_;
51    v8::Context::Scope scope_;
52
53    DISALLOW_COPY_AND_ASSIGN(Scope);
54  };
55
56 private:
57  friend class Scope;
58
59  base::WeakPtrFactory<Runner> weak_factory_;
60
61  DISALLOW_COPY_AND_ASSIGN(Runner);
62};
63
64}  // namespace gin
65
66#endif  // GIN_RUNNER_H_
67