Home | History | Annotate | Download | only in gin 
      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_PER_CONTEXT_DATA_H_
      6 #define GIN_PER_CONTEXT_DATA_H_
      7 
      8 #include "base/basictypes.h"
      9 #include "base/memory/scoped_ptr.h"
     10 #include "base/memory/scoped_vector.h"
     11 #include "gin/gin_export.h"
     12 #include "v8/include/v8.h"
     13 
     14 namespace gin {
     15 
     16 class Runner;
     17 
     18 // Embedders can store additional per-context data by subclassing
     19 // ContextSupplement.
     20 class GIN_EXPORT ContextSupplement {
     21  public:
     22   ContextSupplement();
     23   virtual ~ContextSupplement();
     24 
     25   // Detach will be called before ContextHolder disposes the v8::Context.
     26   // Embedders should not interact with |context| after Detach has been called.
     27   virtual void Detach(v8::Handle<v8::Context> context) = 0;
     28 
     29  private:
     30   DISALLOW_COPY_AND_ASSIGN(ContextSupplement);
     31 };
     32 
     33 // There is one instance of PerContextData per v8::Context managed by Gin. This
     34 // class stores all the Gin-related data that varies per context.
     35 class GIN_EXPORT PerContextData {
     36  public:
     37   explicit PerContextData(v8::Handle<v8::Context> context);
     38   ~PerContextData();
     39 
     40   // Can return NULL after the ContextHolder has detached from context.
     41   static PerContextData* From(v8::Handle<v8::Context>);
     42   void Detach(v8::Handle<v8::Context> context);
     43 
     44   // The Runner associated with this context. To execute script in this context,
     45   // please use the appropriate API on Runner.
     46   Runner* runner() const { return runner_; }
     47   void set_runner(Runner* runner) { runner_ = runner; }
     48 
     49   void AddSupplement(scoped_ptr<ContextSupplement> supplement);
     50 
     51  private:
     52   typedef ScopedVector<ContextSupplement> SuplementVector;
     53 
     54   Runner* runner_;
     55   SuplementVector supplements_;
     56 
     57   DISALLOW_COPY_AND_ASSIGN(PerContextData);
     58 };
     59 
     60 }  // namespace gin
     61 
     62 #endif  // GIN_PER_CONTEXT_DATA_H_
     63