extension_system.h revision a1401311d1ab56c4ed0a474bd38c108f75cb0cd9 
1// Copyright 2014 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 EXTENSIONS_BROWSER_EXTENSION_SYSTEM_H_
6#define EXTENSIONS_BROWSER_EXTENSION_SYSTEM_H_
7
8#include <string>
9
10#include "base/memory/ref_counted.h"
11#include "components/keyed_service/core/keyed_service.h"
12#include "extensions/common/extension.h"
13
14class ExtensionService;
15
16#if defined(OS_CHROMEOS)
17namespace chromeos {
18class DeviceLocalAccountManagementPolicyProvider;
19}
20#endif  // defined(OS_CHROMEOS)
21
22namespace content {
23class BrowserContext;
24}
25
26namespace extensions {
27
28class Blacklist;
29class ErrorConsole;
30class EventRouter;
31class Extension;
32class ExtensionWarningService;
33class InfoMap;
34class InstallVerifier;
35class LazyBackgroundTaskQueue;
36class ManagementPolicy;
37class OneShotEvent;
38class ProcessManager;
39class QuotaService;
40class RuntimeData;
41class StateStore;
42class UserScriptMaster;
43
44// ExtensionSystem manages the lifetime of many of the services used by the
45// extensions and apps system, and it handles startup and shutdown as needed.
46// Eventually, we'd like to make more of these services into KeyedServices in
47// their own right.
48class ExtensionSystem : public KeyedService {
49 public:
50  ExtensionSystem();
51  virtual ~ExtensionSystem();
52
53  // Returns the instance for the given browser context, or NULL if none.
54  static ExtensionSystem* Get(content::BrowserContext* context);
55
56  // Initializes extensions machinery.
57  // Component extensions are always enabled, external and user extensions are
58  // controlled by |extensions_enabled|.
59  virtual void InitForRegularProfile(bool extensions_enabled) = 0;
60
61  // The ExtensionService is created at startup.
62  virtual ExtensionService* extension_service() = 0;
63
64  // Per-extension data that can change during the life of the process but
65  // does not persist across restarts. Lives on UI thread. Created at startup.
66  virtual RuntimeData* runtime_data() = 0;
67
68  // The class controlling whether users are permitted to perform certain
69  // actions on extensions (install, uninstall, disable, etc.).
70  // The ManagementPolicy is created at startup.
71  virtual ManagementPolicy* management_policy() = 0;
72
73  // The UserScriptMaster is created at startup.
74  virtual UserScriptMaster* user_script_master() = 0;
75
76  // The ProcessManager is created at startup.
77  virtual ProcessManager* process_manager() = 0;
78
79  // The StateStore is created at startup.
80  virtual StateStore* state_store() = 0;
81
82  // The rules store is created at startup.
83  virtual StateStore* rules_store() = 0;
84
85  // Returns the IO-thread-accessible extension data.
86  virtual InfoMap* info_map() = 0;
87
88  // The LazyBackgroundTaskQueue is created at startup.
89  virtual LazyBackgroundTaskQueue* lazy_background_task_queue() = 0;
90
91  // The EventRouter is created at startup.
92  virtual EventRouter* event_router() = 0;
93
94  // The ExtensionWarningService is created at startup.
95  virtual ExtensionWarningService* warning_service() = 0;
96
97  // The blacklist is created at startup.
98  virtual Blacklist* blacklist() = 0;
99
100  // The ErrorConsole is created at startup.
101  virtual ErrorConsole* error_console() = 0;
102
103  // The InstallVerifier is created at startup.
104  virtual InstallVerifier* install_verifier() = 0;
105
106  // Returns the QuotaService that limits calls to certain extension functions.
107  // Lives on the UI thread. Created at startup.
108  virtual QuotaService* quota_service() = 0;
109
110  // Called by the ExtensionService that lives in this system. Gives the
111  // info map a chance to react to the load event before the EXTENSION_LOADED
112  // notification has fired. The purpose for handling this event first is to
113  // avoid race conditions by making sure URLRequestContexts learn about new
114  // extensions before anything else needs them to know.
115  virtual void RegisterExtensionWithRequestContexts(
116      const Extension* extension) {}
117
118  // Called by the ExtensionService that lives in this system. Lets the
119  // info map clean up its RequestContexts once all the listeners to the
120  // EXTENSION_UNLOADED notification have finished running.
121  virtual void UnregisterExtensionWithRequestContexts(
122      const std::string& extension_id,
123      const UnloadedExtensionInfo::Reason reason) {}
124
125  // Signaled when the extension system has completed its startup tasks.
126  virtual const OneShotEvent& ready() const = 0;
127};
128
129}  // namespace extensions
130
131#endif  // EXTENSIONS_BROWSER_EXTENSION_SYSTEM_H_
132