OLD | NEW |
1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 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 CHROME_COMMON_EXTENSIONS_MANIFEST_HANDLER_H_ | 5 #ifndef CHROME_COMMON_EXTENSIONS_MANIFEST_HANDLER_H_ |
6 #define CHROME_COMMON_EXTENSIONS_MANIFEST_HANDLER_H_ | 6 #define CHROME_COMMON_EXTENSIONS_MANIFEST_HANDLER_H_ |
7 | 7 |
| 8 #include <set> |
8 #include <string> | 9 #include <string> |
9 #include <vector> | |
10 | 10 |
11 #include "base/string16.h" | 11 #include "base/string16.h" |
12 | 12 #include "chrome/common/extensions/extension.h" |
13 namespace base { | |
14 class Value; | |
15 } | |
16 | 13 |
17 namespace extensions { | 14 namespace extensions { |
18 | 15 |
19 class Extension; | 16 class Manifest; |
20 | 17 |
21 class ManifestHandler { | 18 class ManifestHandler { |
22 public: | 19 public: |
23 ManifestHandler(); | 20 ManifestHandler(); |
24 virtual ~ManifestHandler(); | 21 virtual ~ManifestHandler(); |
25 | 22 |
26 // Attempts to parse the manifest value. | 23 // Attempts to parse the extension's manifest. |
27 // Returns true on success or false on failure; if false, |error| will | 24 // Returns true on success or false on failure; if false, |error| will |
28 // be set to a failure message. | 25 // be set to a failure message. |
29 virtual bool Parse(const base::Value* value, | 26 virtual bool Parse(Extension* extension, string16* error) = 0; |
30 Extension* extension, | |
31 string16* error) = 0; | |
32 | 27 |
33 // Perform any initialization which is necessary when the Handler's key is | 28 // If false (the default), only parse the manifest if a registered |
34 // not present in the manifest. | 29 // key is present in the manifest. If true, always attempt to parse |
35 // Returns true on success or false on failure; if false, |error| will | 30 // the manifest for this extension type, even if no registered keys |
36 // be set to a failure message. | 31 // are present. This allows specifying a default parsed value for |
37 virtual bool HasNoKey(Extension* extension, string16* error); | 32 // extensions that don't declare our key in the manifest. |
| 33 // TODO(yoz): Use Feature availability instead. |
| 34 virtual bool AlwaysParseForType(Extension::Type type); |
38 | 35 |
39 // Associate |handler| with |key| in the manifest. Takes ownership | 36 // Associate |handler| with |key| in the manifest. A handler can register |
40 // of |handler|. TODO(yoz): Decide how to handle dotted subkeys. | 37 // for multiple keys. The global registry takes ownership of |handler|; |
| 38 // if it has an existing handler for |key|, it replaces it with this one. |
| 39 // |
41 // WARNING: Manifest handlers registered only in the browser process | 40 // WARNING: Manifest handlers registered only in the browser process |
42 // are not available to renderers. | 41 // are not available to renderers or utility processes. |
43 static void Register(const std::string& key, ManifestHandler* handler); | 42 static void Register(const std::string& key, ManifestHandler* handler); |
44 | 43 |
45 // Get the manifest handler associated with |key|, or NULL | 44 // Call Parse on all registered manifest handlers that should parse |
46 // if there is none. | 45 // this extension. |
47 static ManifestHandler* Get(const std::string& key); | 46 static bool ParseExtension(Extension* extension, string16* error); |
48 | |
49 // If the handler is not handling most of the keys, it may be | |
50 // more efficient to have a list of keys to iterate over. | |
51 // TODO(yoz): this isn't the long-term solution. | |
52 static std::vector<std::string> GetKeys(); | |
53 }; | 47 }; |
54 | 48 |
55 | |
56 } // namespace extensions | 49 } // namespace extensions |
57 | 50 |
58 #endif // CHROME_COMMON_EXTENSIONS_MANIFEST_HANDLER_H_ | 51 #endif // CHROME_COMMON_EXTENSIONS_MANIFEST_HANDLER_H_ |
OLD | NEW |