• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 // Copyright (c) 2012 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 CHROME_RENDERER_EXTENSIONS_V8_SCHEMA_REGISTRY_H_
6 #define CHROME_RENDERER_EXTENSIONS_V8_SCHEMA_REGISTRY_H_
7 
8 #include <map>
9 #include <string>
10 #include <vector>
11 
12 #include "base/basictypes.h"
13 #include "base/memory/scoped_ptr.h"
14 #include "chrome/renderer/extensions/scoped_persistent.h"
15 #include "chrome/renderer/extensions/unsafe_persistent.h"
16 #include "v8/include/v8.h"
17 
18 namespace extensions {
19 class NativeHandler;
20 
21 // A registry for the v8::Value representations of extension API schemas.
22 // In a way, the v8 counterpart to ExtensionAPI.
23 class V8SchemaRegistry {
24  public:
25   V8SchemaRegistry();
26   ~V8SchemaRegistry();
27 
28   // Creates a NativeHandler wrapper |this|. Supports GetSchema.
29   scoped_ptr<NativeHandler> AsNativeHandler();
30 
31   // Returns a v8::Array with all the schemas for the APIs in |apis|.
32   v8::Handle<v8::Array> GetSchemas(const std::vector<std::string>& apis);
33 
34   // Returns a v8::Object for the schema for |api|, possibly from the cache.
35   v8::Handle<v8::Object> GetSchema(const std::string& api);
36 
37  private:
38   // Gets the separate context that backs the registry, creating a new one if
39   // if necessary.
40   v8::Handle<v8::Context> GetOrCreateContext(v8::Isolate* isolate);
41 
42   // Cache of schemas.
43   //
44   // Storing UnsafePersistents is safe here, because the corresponding
45   // Persistent handle is created in GetSchema(), and it keeps the data pointed
46   // by the UnsafePersistent alive. It's not made weak or disposed, and nobody
47   // else has access to it. The Persistent is then disposed in the dtor.
48   typedef std::map<std::string, UnsafePersistent<v8::Object> > SchemaCache;
49   SchemaCache schema_cache_;
50 
51   // Single per-instance v8::Context to create v8::Values.
52   // Created lazily via GetOrCreateContext.
53   ScopedPersistent<v8::Context> context_;
54 
55   DISALLOW_COPY_AND_ASSIGN(V8SchemaRegistry);
56 };
57 
58 }  // namespace extensions
59 
60 #endif  // CHROME_RENDERER_EXTENSIONS_V8_SCHEMA_REGISTRY_H_
61