| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 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 | 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_BROWSER_EXTENSIONS_USER_SCRIPT_LOADER_H_ | 5 #ifndef CHROME_BROWSER_EXTENSIONS_USER_SCRIPT_LOADER_H_ |
| 6 #define CHROME_BROWSER_EXTENSIONS_USER_SCRIPT_LOADER_H_ | 6 #define CHROME_BROWSER_EXTENSIONS_USER_SCRIPT_LOADER_H_ |
| 7 | 7 |
| 8 #include <map> | 8 #include <map> |
| 9 #include <set> | 9 #include <set> |
| 10 | 10 |
| 11 #include "base/compiler_specific.h" | 11 #include "base/compiler_specific.h" |
| 12 #include "base/memory/scoped_ptr.h" | 12 #include "base/memory/scoped_ptr.h" |
| 13 #include "base/memory/shared_memory.h" |
| 13 #include "base/memory/weak_ptr.h" | 14 #include "base/memory/weak_ptr.h" |
| 14 #include "base/scoped_observer.h" | 15 #include "base/scoped_observer.h" |
| 15 #include "content/public/browser/notification_observer.h" | 16 #include "content/public/browser/notification_observer.h" |
| 16 #include "content/public/browser/notification_registrar.h" | 17 #include "content/public/browser/notification_registrar.h" |
| 17 #include "extensions/browser/extension_registry_observer.h" | 18 #include "extensions/common/host_id.h" |
| 18 #include "extensions/common/extension.h" | |
| 19 #include "extensions/common/extension_set.h" | |
| 20 #include "extensions/common/user_script.h" | 19 #include "extensions/common/user_script.h" |
| 21 | 20 |
| 22 namespace base { | 21 namespace base { |
| 23 class SharedMemory; | 22 class SharedMemory; |
| 24 } | 23 } |
| 25 | 24 |
| 26 namespace content { | 25 namespace content { |
| 27 class BrowserContext; | 26 class BrowserContext; |
| 28 class RenderProcessHost; | 27 class RenderProcessHost; |
| 29 } | 28 } |
| 30 | 29 |
| 31 class Profile; | 30 class Profile; |
| 32 | 31 |
| 33 namespace extensions { | 32 namespace extensions { |
| 34 | 33 |
| 35 class ContentVerifier; | 34 class ContentVerifier; |
| 36 class ExtensionRegistry; | |
| 37 | |
| 38 typedef std::map<ExtensionId, ExtensionSet::ExtensionPathAndDefaultLocale> | |
| 39 ExtensionsInfo; | |
| 40 | 35 |
| 41 // Manages one "logical unit" of user scripts in shared memory by constructing a | 36 // Manages one "logical unit" of user scripts in shared memory by constructing a |
| 42 // new shared memory region when the set of scripts changes. Also notifies | 37 // new shared memory region when the set of scripts changes. Also notifies |
| 43 // renderers of new shared memory region when new renderers appear, or when | 38 // renderers of new shared memory region when new renderers appear, or when |
| 44 // script reloading completes. Script loading lives on the UI thread. Instances | 39 // script reloading completes. Script loading lives on the UI thread. Instances |
| 45 // of this class are embedded within classes with names ending in | 40 // of this class are embedded within classes with names ending in |
| 46 // UserScriptMaster. These "master" classes implement the strategy for which | 41 // UserScriptMaster. These "master" classes implement the strategy for which |
| 47 // scripts to load/unload on this logical unit of scripts. | 42 // scripts to load/unload on this logical unit of scripts. |
| 48 class UserScriptLoader : public content::NotificationObserver, | 43 class UserScriptLoader : public content::NotificationObserver { |
| 49 public ExtensionRegistryObserver { | |
| 50 public: | 44 public: |
| 45 using PathAndDefaultLocale = std::pair<base::FilePath, std::string>; |
| 46 using HostsInfo = std::map<HostID, PathAndDefaultLocale>; |
| 47 |
| 48 using SubstitutionMap = std::map<std::string, std::string>; |
| 49 using LoadUserScriptsContentFunction = |
| 50 base::Callback<bool(const HostID&, |
| 51 UserScript::File*, |
| 52 const SubstitutionMap*, |
| 53 const scoped_refptr<ContentVerifier>&)>; |
| 54 |
| 51 // Parses the includes out of |script| and returns them in |includes|. | 55 // Parses the includes out of |script| and returns them in |includes|. |
| 52 static bool ParseMetadataHeader(const base::StringPiece& script_text, | 56 static bool ParseMetadataHeader(const base::StringPiece& script_text, |
| 53 UserScript* script); | 57 UserScript* script); |
| 54 | 58 |
| 59 UserScriptLoader(Profile* profile, |
| 60 const HostID& host_id, |
| 61 const scoped_refptr<ContentVerifier>& content_verifier); |
| 62 ~UserScriptLoader() override; |
| 63 |
| 55 // A wrapper around the method to load user scripts, which is normally run on | 64 // A wrapper around the method to load user scripts, which is normally run on |
| 56 // the file thread. Exposed only for tests. | 65 // the file thread. Exposed only for tests. |
| 57 static void LoadScriptsForTest(UserScriptList* user_scripts); | 66 void LoadScriptsForTest(UserScriptList* user_scripts); |
| 58 | |
| 59 UserScriptLoader(Profile* profile, | |
| 60 const ExtensionId& owner_extension_id, | |
| 61 bool listen_for_extension_system_loaded); | |
| 62 ~UserScriptLoader() override; | |
| 63 | 67 |
| 64 // Add |scripts| to the set of scripts managed by this loader. | 68 // Add |scripts| to the set of scripts managed by this loader. |
| 65 void AddScripts(const std::set<UserScript>& scripts); | 69 void AddScripts(const std::set<UserScript>& scripts); |
| 66 | 70 |
| 67 // Remove |scripts| from the set of scripts managed by this loader. | 71 // Remove |scripts| from the set of scripts managed by this loader. |
| 68 void RemoveScripts(const std::set<UserScript>& scripts); | 72 void RemoveScripts(const std::set<UserScript>& scripts); |
| 69 | 73 |
| 70 // Clears the set of scripts managed by this loader. | 74 // Clears the set of scripts managed by this loader. |
| 71 void ClearScripts(); | 75 void ClearScripts(); |
| 72 | 76 |
| 73 // Initiates procedure to start loading scripts on the file thread. | 77 // Initiates procedure to start loading scripts on the file thread. |
| 74 void StartLoad(); | 78 void StartLoad(); |
| 75 | 79 |
| 76 // Return true if we have any scripts ready. | 80 // Returns true if we have any scripts ready. |
| 77 bool scripts_ready() const { return shared_memory_.get() != NULL; } | 81 bool scripts_ready() const { return shared_memory_.get() != NULL; } |
| 78 | 82 |
| 83 protected: |
| 84 // Updates |hosts_info_| to contain info for each element of |
| 85 // |changed_hosts_|. |
| 86 virtual void UpdateHostsInfo(const std::set<HostID>& changed_hosts) = 0; |
| 87 |
| 88 // Returns a function pointer of a static funcion to load user scripts. |
| 89 // Derived classes can specify their ways to load scripts in the static |
| 90 // function they return. |
| 91 // Note: It has to be safe to call multiple times. |
| 92 virtual LoadUserScriptsContentFunction GetLoadUserScriptsFunction() = 0; |
| 93 |
| 94 // Adds the |host_id, location| to the |hosts_info_| map. |
| 95 // Only inserts the entry to the map when the given host_id doesn't |
| 96 // exists. |
| 97 void AddHostInfo(const HostID& host_id, const PathAndDefaultLocale& location); |
| 98 |
| 99 // Removes the entries with the given host_id from the |hosts_info_| map. |
| 100 void RemoveHostInfo(const HostID& host_id); |
| 101 |
| 102 // Sets the flag if the initial set of hosts has finished loading; if it's |
| 103 // set to be true, calls AttempLoad() to bootstrap. |
| 104 void SetReady(bool ready); |
| 105 |
| 106 Profile* profile() const { return profile_; } |
| 107 const HostID& host_id() const { return host_id_; } |
| 108 |
| 79 private: | 109 private: |
| 80 // content::NotificationObserver implementation. | 110 // content::NotificationObserver implementation. |
| 81 void Observe(int type, | 111 void Observe(int type, |
| 82 const content::NotificationSource& source, | 112 const content::NotificationSource& source, |
| 83 const content::NotificationDetails& details) override; | 113 const content::NotificationDetails& details) override; |
| 84 | 114 |
| 85 // ExtensionRegistryObserver implementation. | |
| 86 void OnExtensionUnloaded(content::BrowserContext* browser_context, | |
| 87 const Extension* extension, | |
| 88 UnloadedExtensionInfo::Reason reason) override; | |
| 89 | |
| 90 // Initiates script load when we have been waiting for the extension system | |
| 91 // to be ready. | |
| 92 void OnExtensionSystemReady(); | |
| 93 | |
| 94 // Returns whether or not it is possible that calls to AddScripts(), | 115 // Returns whether or not it is possible that calls to AddScripts(), |
| 95 // RemoveScripts(), and/or ClearScripts() have caused any real change in the | 116 // RemoveScripts(), and/or ClearScripts() have caused any real change in the |
| 96 // set of scripts to be loaded. | 117 // set of scripts to be loaded. |
| 97 bool ScriptsMayHaveChanged() const; | 118 bool ScriptsMayHaveChanged() const; |
| 98 | 119 |
| 99 // Attempt to initiate a load. | 120 // Attempts to initiate a load. |
| 100 void AttemptLoad(); | 121 void AttemptLoad(); |
| 101 | 122 |
| 102 // Called once we have finished loading the scripts on the file thread. | 123 // Called once we have finished loading the scripts on the file thread. |
| 103 void OnScriptsLoaded(scoped_ptr<UserScriptList> user_scripts, | 124 void OnScriptsLoaded(scoped_ptr<UserScriptList> user_scripts, |
| 104 scoped_ptr<base::SharedMemory> shared_memory); | 125 scoped_ptr<base::SharedMemory> shared_memory); |
| 105 | 126 |
| 106 // Sends the renderer process a new set of user scripts. If | 127 // Sends the renderer process a new set of user scripts. If |
| 107 // |changed_extensions| is not empty, this signals that only the scripts from | 128 // |changed_hosts| is not empty, this signals that only the scripts from |
| 108 // those extensions should be updated. Otherwise, all extensions will be | 129 // those hosts should be updated. Otherwise, all hosts will be |
| 109 // updated. | 130 // updated. |
| 110 void SendUpdate(content::RenderProcessHost* process, | 131 void SendUpdate(content::RenderProcessHost* process, |
| 111 base::SharedMemory* shared_memory, | 132 base::SharedMemory* shared_memory, |
| 112 const std::set<ExtensionId>& changed_extensions); | 133 const std::set<HostID>& changed_hosts); |
| 113 | |
| 114 // Add to |changed_extensions_| those extensions referred to by |scripts|. | |
| 115 void ExpandChangedExtensions(const std::set<UserScript>& scripts); | |
| 116 | |
| 117 // Update |extensions_info_| to contain info for each element of | |
| 118 // |changed_extensions_|. | |
| 119 void UpdateExtensionsInfo(); | |
| 120 | 134 |
| 121 bool is_loading() const { | 135 bool is_loading() const { |
| 122 // Ownership of |user_scripts_| is passed to the file thread when loading. | 136 // Ownership of |user_scripts_| is passed to the file thread when loading. |
| 123 return user_scripts_.get() == NULL; | 137 return user_scripts_.get() == NULL; |
| 124 } | 138 } |
| 125 | 139 |
| 126 // Manages our notification registrations. | 140 // Manages our notification registrations. |
| 127 content::NotificationRegistrar registrar_; | 141 content::NotificationRegistrar registrar_; |
| 128 | 142 |
| 129 // Contains the scripts that were found the last time scripts were updated. | 143 // Contains the scripts that were found the last time scripts were updated. |
| 130 scoped_ptr<base::SharedMemory> shared_memory_; | 144 scoped_ptr<base::SharedMemory> shared_memory_; |
| 131 | 145 |
| 132 // List of scripts from currently-installed extensions we should load. | 146 // List of scripts from currently-installed extensions we should load. |
| 133 scoped_ptr<UserScriptList> user_scripts_; | 147 scoped_ptr<UserScriptList> user_scripts_; |
| 134 | 148 |
| 135 // Maps extension info needed for localization to an extension ID. | 149 // Maps host info needed for localization to a host ID. |
| 136 ExtensionsInfo extensions_info_; | 150 HostsInfo hosts_info_; |
| 137 | 151 |
| 138 // The mutually-exclusive sets of scripts that were added or removed since the | 152 // The mutually-exclusive sets of scripts that were added or removed since the |
| 139 // last script load. | 153 // last script load. |
| 140 std::set<UserScript> added_scripts_; | 154 std::set<UserScript> added_scripts_; |
| 141 std::set<UserScript> removed_scripts_; | 155 std::set<UserScript> removed_scripts_; |
| 142 | 156 |
| 143 // Indicates whether the the collection of scripts should be cleared before | 157 // Indicates whether the the collection of scripts should be cleared before |
| 144 // additions and removals on the next script load. | 158 // additions and removals on the next script load. |
| 145 bool clear_scripts_; | 159 bool clear_scripts_; |
| 146 | 160 |
| 147 // The IDs of the extensions which changed in the last update sent to the | 161 // The IDs of the extensions which changed in the last update sent to the |
| 148 // renderer. | 162 // renderer. |
| 149 ExtensionIdSet changed_extensions_; | 163 std::set<HostID> changed_hosts_; |
| 150 | 164 |
| 151 // If the extensions service has finished loading its initial set of | 165 // If the initial set of hosts has finished loading. |
| 152 // extensions. | 166 bool ready_; |
| 153 bool extension_system_ready_; | |
| 154 | 167 |
| 155 // If list of user scripts is modified while we're loading it, we note | 168 // If list of user scripts is modified while we're loading it, we note |
| 156 // that we're currently mid-load and then start over again once the load | 169 // that we're currently mid-load and then start over again once the load |
| 157 // finishes. This boolean tracks whether another load is pending. | 170 // finishes. This boolean tracks whether another load is pending. |
| 158 bool pending_load_; | 171 bool pending_load_; |
| 159 | 172 |
| 160 // Whether or not we are currently loading. | 173 // Whether or not we are currently loading. |
| 161 bool is_loading_; | 174 bool is_loading_; |
| 162 | 175 |
| 163 // The profile for which the scripts managed here are installed. | 176 // The profile for which the scripts managed here are installed. |
| 164 Profile* profile_; | 177 Profile* profile_; |
| 165 | 178 |
| 166 // ID of the extension that owns these scripts, if any. This is only set to a | 179 // ID of the host that owns these scripts, if any. This is only set to a |
| 167 // non-empty value for declarative user script shared memory regions. | 180 // non-empty value for declarative user script shared memory regions. |
| 168 ExtensionId owner_extension_id_; | 181 HostID host_id_; |
| 169 | 182 |
| 170 ScopedObserver<ExtensionRegistry, ExtensionRegistryObserver> | 183 // Manages content verification of the loaded user scripts. |
| 171 extension_registry_observer_; | 184 scoped_refptr<ContentVerifier> content_verifier_; |
| 172 | 185 |
| 173 base::WeakPtrFactory<UserScriptLoader> weak_factory_; | 186 base::WeakPtrFactory<UserScriptLoader> weak_factory_; |
| 174 | 187 |
| 175 DISALLOW_COPY_AND_ASSIGN(UserScriptLoader); | 188 DISALLOW_COPY_AND_ASSIGN(UserScriptLoader); |
| 176 }; | 189 }; |
| 177 | 190 |
| 178 } // namespace extensions | 191 } // namespace extensions |
| 179 | 192 |
| 180 #endif // CHROME_BROWSER_EXTENSIONS_USER_SCRIPT_LOADER_H_ | 193 #endif // CHROME_BROWSER_EXTENSIONS_USER_SCRIPT_LOADER_H_ |
| OLD | NEW |