Create a mechanism define declarative rules via the extension manifest.

extensions/browser/api/declarative/rules_registry.cc

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #include "extensions/browser/api/declarative/rules_registry.h"
 
 #include <utility>
 
 #include "base/bind.h"
 #include "base/logging.h"
 #include "base/message_loop/message_loop.h"
 #include "base/metrics/histogram.h"
 #include "base/stl_util.h"
 #include "base/strings/stringprintf.h"
 #include "base/time/time.h"
 #include "base/values.h"
 #include "content/public/browser/browser_thread.h"
 #include "content/public/browser/notification_details.h"
 #include "content/public/browser/notification_source.h"
 #include "extensions/browser/api/declarative/rules_cache_delegate.h"
 #include "extensions/browser/extension_prefs.h"
+#include "extensions/browser/extension_registry.h"
 #include "extensions/browser/extension_system.h"
 #include "extensions/browser/state_store.h"
 #include "extensions/common/extension.h"
+#include "extensions/common/manifest_constants.h"
+
+namespace extensions {
 
 namespace {
 
 const char kSuccess[] = "";
 const char kDuplicateRuleId[] = "Duplicate rule ID: %s";
+const char kErrorNonRemovableRules[] = "List contains non-removable rules";
 
 scoped_ptr<base::Value> RulesToValue(
-    const std::vector<linked_ptr<extensions::RulesRegistry::Rule> >& rules) {
+    const std::vector<linked_ptr<RulesRegistry::Rule>>& rules) {
   scoped_ptr<base::ListValue> list(new base::ListValue());
   for (size_t i = 0; i < rules.size(); ++i)
     list->Append(rules[i]->ToValue().release());
   return list.Pass();
 }
 
-std::vector<linked_ptr<extensions::RulesRegistry::Rule> > RulesFromValue(
+std::vector<linked_ptr<RulesRegistry::Rule>> RulesFromValue(
     const base::Value* value) {
-  std::vector<linked_ptr<extensions::RulesRegistry::Rule> > rules;
+  std::vector<linked_ptr<RulesRegistry::Rule>> rules;
 
   const base::ListValue* list = NULL;
   if (!value || !value->GetAsList(&list))
     return rules;
 
   rules.reserve(list->GetSize());
   for (size_t i = 0; i < list->GetSize(); ++i) {
     const base::DictionaryValue* dict = NULL;
     if (!list->GetDictionary(i, &dict))
       continue;
-    linked_ptr<extensions::RulesRegistry::Rule> rule(
-        new extensions::RulesRegistry::Rule());
-    if (extensions::RulesRegistry::Rule::Populate(*dict, rule.get()))
+    linked_ptr<RulesRegistry::Rule> rule(new RulesRegistry::Rule());
+    if (RulesRegistry::Rule::Populate(*dict, rule.get()))
       rules.push_back(rule);
   }
 
+  return rules;
+}
+
+scoped_ptr<base::ListValue> ConvertListFromManifest(
+    const base::ListValue* list) {
+  scoped_ptr<base::ListValue> result(new base::ListValue);
+  for (base::ListValue::const_iterator it = list->begin(); it != list->end();
+       ++it) {
+    base::DictionaryValue* dictionary = nullptr;
+    if (!(*it)->GetAsDictionary(&dictionary))
+      continue;
+    std::string type;
+    if (!dictionary->GetString("type", &type))
+      continue;
+    scoped_ptr<base::DictionaryValue> copy = dictionary->CreateDeepCopy();
+    copy->Remove("type", NULL);
+    copy->SetString("instanceType", type);
+    result->Append(copy.Pass());
+  }
+  return result.Pass();
+}
+
+std::vector<linked_ptr<RulesRegistry::Rule>> RulesFromManifest(
+    const base::Value* value,
+    const std::string& event_name) {
+  std::vector<linked_ptr<RulesRegistry::Rule>> rules;
+
+  const base::ListValue* list = nullptr;
+  if (!value || !value->GetAsList(&list))
+    return rules;
+
+  for (size_t i = 0; i < list->GetSize(); ++i) {
+    const base::DictionaryValue* dict = nullptr;
+    if (!list->GetDictionary(i, &dict))
+      continue;
+    std::string event;
+    if (!dict->GetString("event", &event))
+      continue;
+    if (event_name != event)
+      continue;
+    const base::ListValue* list;
+    if (!dict->GetList("conditions", &list) || !list->GetSize())
+      continue;
+    scoped_ptr<base::ListValue> conditions = ConvertListFromManifest(list);
+    if (!conditions->GetSize())
+      continue;
+    if (!dict->GetList("actions", &list) || !list->GetSize())
+      continue;
+    scoped_ptr<base::ListValue> actions = ConvertListFromManifest(list);
+    if (!actions->GetSize())
+      continue;
+    scoped_ptr<base::DictionaryValue> rule_dict(new base::DictionaryValue);
+    rule_dict->Set("conditions", conditions.Pass());
+    rule_dict->Set("actions", actions.Pass());
+    linked_ptr<RulesRegistry::Rule> rule(new RulesRegistry::Rule());
+    if (RulesRegistry::Rule::Populate(*rule_dict, rule.get()))
+      rules.push_back(rule);
+  }
+
   return rules;
 }
 
 std::string ToId(int identifier) {
   return base::StringPrintf("_%d_", identifier);
 }
 
 }  // namespace
 
 
-namespace extensions {
-
 // RulesRegistry
 
 RulesRegistry::RulesRegistry(content::BrowserContext* browser_context,
                              const std::string& event_name,
                              content::BrowserThread::ID owner_thread,
                              RulesCacheDelegate* cache_delegate,
                              int id)
     : browser_context_(browser_context),
       owner_thread_(owner_thread),
       event_name_(event_name),
       id_(id),
       ready_(/*signaled=*/!cache_delegate),  // Immediately ready if no cache
                                              // delegate to wait for.
       last_generated_rule_identifier_id_(0),
       weak_ptr_factory_(browser_context_ ? this : NULL) {
   if (cache_delegate) {
     cache_delegate_ = cache_delegate->GetWeakPtr();
     cache_delegate->Init(this);
   }
 }
 
 std::string RulesRegistry::AddRulesNoFill(
     const std::string& extension_id,
-    const std::vector<linked_ptr<Rule> >& rules) {
+    const std::vector<linked_ptr<Rule>>& rules,
+    bool from_manifest) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
   // Verify that all rule IDs are new.
   for (std::vector<linked_ptr<Rule> >::const_iterator i =
       rules.begin(); i != rules.end(); ++i) {
     const RuleId& rule_id = *((*i)->id);
     // Every rule should have a priority assigned.
     DCHECK((*i)->priority);
     RulesDictionaryKey key(extension_id, rule_id);
+    if (from_manifest)
+      manifest_rule_ids_.insert(key);
     if (rules_.find(key) != rules_.end())
       return base::StringPrintf(kDuplicateRuleId, rule_id.c_str());
   }
 
   std::string error = AddRulesImpl(extension_id, rules);
 
   if (!error.empty())
     return error;
 
   // Commit all rules into |rules_| on success.
   for (std::vector<linked_ptr<Rule> >::const_iterator i =
       rules.begin(); i != rules.end(); ++i) {
     const RuleId& rule_id = *((*i)->id);
     RulesDictionaryKey key(extension_id, rule_id);
     rules_[key] = *i;
   }
 
   MaybeProcessChangedRules(extension_id);
   return kSuccess;
 }
 
-std::string RulesRegistry::AddRules(
-    const std::string& extension_id,
-    const std::vector<linked_ptr<Rule> >& rules) {
+std::string RulesRegistry::AddRules(const std::string& extension_id,
+                                    const std::vector<linked_ptr<Rule>>& rules,
+                                    bool from_manifest) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
   std::string error = CheckAndFillInOptionalRules(extension_id, rules);
   if (!error.empty())
     return error;
   FillInOptionalPriorities(rules);
 
-  return AddRulesNoFill(extension_id, rules);
+  return AddRulesNoFill(extension_id, rules, from_manifest);
 }
 
 std::string RulesRegistry::RemoveRules(
     const std::string& extension_id,
     const std::vector<std::string>& rule_identifiers) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
+  // Check if any of the rules are non-removable.
+  for (RuleId rule_id : rule_identifiers) {
+    RulesDictionaryKey lookup_key(extension_id, rule_id);
+    RuleIdSet::iterator itr = manifest_rule_ids_.find(lookup_key);
+    if (itr != manifest_rule_ids_.end())
+      return kErrorNonRemovableRules;
+  }
+
   std::string error = RemoveRulesImpl(extension_id, rule_identifiers);
 
   if (!error.empty())
     return error;
 
   for (std::vector<std::string>::const_iterator i = rule_identifiers.begin();
        i != rule_identifiers.end();
        ++i) {
     RulesDictionaryKey lookup_key(extension_id, *i);
     rules_.erase(lookup_key);
@@ skipping 16 matching lines @@
 
   std::string error = RemoveAllRulesImpl(extension_id);
 
   if (!error.empty())
     return error;
 
   for (RulesDictionary::const_iterator i = rules_.begin();
       i != rules_.end();) {
     const RulesDictionaryKey& key = i->first;
     ++i;
-    if (key.first == extension_id)
+    if (key.first == extension_id) {
       rules_.erase(key);
+      manifest_rule_ids_.erase(key);
+    }
   }
 
   RemoveAllUsedRuleIdentifiers(extension_id);
   return kSuccess;
 }
 
 void RulesRegistry::GetRules(const std::string& extension_id,
                              const std::vector<std::string>& rule_identifiers,
                              std::vector<linked_ptr<Rule> >* out) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
   for (std::vector<std::string>::const_iterator i = rule_identifiers.begin();
       i != rule_identifiers.end(); ++i) {
     RulesDictionaryKey lookup_key(extension_id, *i);
     RulesDictionary::iterator entry = rules_.find(lookup_key);
     if (entry != rules_.end())
       out->push_back(entry->second);
   }
 }
 
 void RulesRegistry::GetAllRules(const std::string& extension_id,
                                 std::vector<linked_ptr<Rule> >* out) {
   DCHECK_CURRENTLY_ON(owner_thread());
   for (RulesDictionary::const_iterator i = rules_.begin();
       i != rules_.end(); ++i) {

[not at google - send to devlin, 2015/06/04 22:00:50]

here and in GetRules, augment the list you return with the manifest rules

[not at google - send to devlin, 2015/06/04 22:01:20]

where manifest rules are a different set of rules. don't put them through
AddRules.

[danduong, 2015/06/04 22:02:33]

They should already be in there. The manifest rules are still a part of |rules_|

[not at google - send to devlin, 2015/06/04 22:09:28]

yes. don't put them in rules.

[danduong, 2015/06/04 23:06:37]

Done.

     const RulesDictionaryKey& key = i->first;
     if (key.first == extension_id)
       out->push_back(i->second);
   }
 }
 
 void RulesRegistry::OnExtensionUnloaded(const std::string& extension_id) {
   DCHECK_CURRENTLY_ON(owner_thread());
   std::string error = RemoveAllRulesImpl(extension_id);
   if (!error.empty())
     LOG(ERROR) << error;
 }
 
 void RulesRegistry::OnExtensionUninstalled(const std::string& extension_id) {
   DCHECK_CURRENTLY_ON(owner_thread());
   std::string error = RemoveAllRulesNoStoreUpdate(extension_id);
   if (!error.empty())
     LOG(ERROR) << error;
 }
 
 void RulesRegistry::OnExtensionLoaded(const std::string& extension_id) {
   DCHECK_CURRENTLY_ON(owner_thread());
-  std::vector<linked_ptr<Rule> > rules;
+  const Extension* extension =
+      ExtensionRegistry::Get(browser_context())
+          ->GetExtensionById(extension_id, ExtensionRegistry::EVERYTHING);
+  const base::ListValue* value = NULL;
+  if (extension->manifest()->GetList(manifest_keys::kEventRules, &value)) {
+    std::string error =
+        AddRules(extension_id, RulesFromManifest(value, event_name_), true);
+    if (!error.empty())
+      LOG(ERROR) << error;
+  }
+  std::vector<linked_ptr<Rule>> rules;
   GetAllRules(extension_id, &rules);
   std::string error = AddRulesImpl(extension_id, rules);
   if (!error.empty())
     LOG(ERROR) << error;
 }
 
 size_t RulesRegistry::GetNumberOfUsedRuleIdentifiersForTesting() const {
   size_t entry_count = 0u;
   for (RuleIdentifiersMap::const_iterator extension =
            used_rule_identifiers_.begin();
        extension != used_rule_identifiers_.end();
        ++extension) {
     // Each extension is counted as 1 just for being there. Otherwise we miss
     // keys with empty values.
     entry_count += 1u + extension->second.size();
   }
   return entry_count;
 }
 
 void RulesRegistry::DeserializeAndAddRules(
     const std::string& extension_id,
     scoped_ptr<base::Value> rules) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
-  AddRulesNoFill(extension_id, RulesFromValue(rules.get()));
+  AddRulesNoFill(extension_id, RulesFromValue(rules.get()), false);
 }
 
 RulesRegistry::~RulesRegistry() {
 }
 
 void RulesRegistry::MarkReady(base::Time storage_init_time) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
   if (!storage_init_time.is_null()) {
     UMA_HISTOGRAM_TIMES("Extensions.DeclarativeRulesStorageInitialization",
                         base::Time::Now() - storage_init_time);
   }
 
   ready_.Signal();
 }
 
 void RulesRegistry::ProcessChangedRules(const std::string& extension_id) {
   DCHECK_CURRENTLY_ON(owner_thread());
 
   DCHECK(ContainsKey(process_changed_rules_requested_, extension_id));
   process_changed_rules_requested_[extension_id] = NOT_SCHEDULED_FOR_PROCESSING;
 
   std::vector<linked_ptr<Rule> > new_rules;
   GetAllRules(extension_id, &new_rules);
+  std::vector<linked_ptr<Rule>> rules_to_write;
+  for (auto rule : new_rules) {
+    const RuleId& rule_id = *(rule->id);
+    RulesDictionaryKey key(extension_id, rule_id);
+    // Only write rules that were added programmatically.
+    if (manifest_rule_ids_.find(key) == manifest_rule_ids_.end())
+      rules_to_write.push_back(rule);
+  }
   content::BrowserThread::PostTask(
-      content::BrowserThread::UI,
-      FROM_HERE,
-      base::Bind(&RulesCacheDelegate::WriteToStorage,
-                 cache_delegate_,
-                 extension_id,
-                 base::Passed(RulesToValue(new_rules))));
+      content::BrowserThread::UI, FROM_HERE,
+      base::Bind(&RulesCacheDelegate::WriteToStorage, cache_delegate_,
+                 extension_id, base::Passed(RulesToValue(rules_to_write))));
 }
 
 void RulesRegistry::MaybeProcessChangedRules(const std::string& extension_id) {
   // Read and initialize |process_changed_rules_requested_[extension_id]| if
   // necessary. (Note that the insertion below will not overwrite
   // |process_changed_rules_requested_[extension_id]| if that already exists.
   std::pair<ProcessStateMap::iterator, bool> insertion =
       process_changed_rules_requested_.insert(std::make_pair(
           extension_id,
           browser_context_ ? NOT_SCHEDULED_FOR_PROCESSING : NEVER_PROCESS));
@@ skipping 73 matching lines @@
   for (i = identifiers.begin(); i != identifiers.end(); ++i)
     used_rule_identifiers_[extension_id].erase(*i);
 }
 
 void RulesRegistry::RemoveAllUsedRuleIdentifiers(
     const std::string& extension_id) {
   used_rule_identifiers_.erase(extension_id);
 }
 
 }  // namespace extensions