Added a PolicyDomainDescriptor.

chrome/browser/policy/policy_service.h

 // 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.
 
 #ifndef CHROME_BROWSER_POLICY_POLICY_SERVICE_H_
 #define CHROME_BROWSER_POLICY_POLICY_SERVICE_H_
 
 #include <map>
-#include <set>
 #include <string>
-#include <utility>
 
 #include "base/basictypes.h"
 #include "base/callback.h"
+#include "base/memory/ref_counted.h"
 #include "chrome/browser/policy/policy_map.h"
 
 namespace policy {
 
+class PolicyDomainDescriptor;
+
 // Policies are namespaced by a (PolicyDomain, ID) pair. The meaning of the ID
 // string depends on the domain; for example, if the PolicyDomain is
 // "extensions" then the ID identifies the extension that the policies control.
 enum PolicyDomain {
   // The component ID for chrome policies is always the empty string.
   POLICY_DOMAIN_CHROME,
 
   // The extensions policy domain is a work in progress. Included here for
   // tests.
   POLICY_DOMAIN_EXTENSIONS,
@@ skipping 49 matching lines @@
     virtual ~Observer() {}
   };
 
   virtual ~PolicyService() {}
 
   // Observes changes to all components of the given |domain|.
   virtual void AddObserver(PolicyDomain domain, Observer* observer) = 0;
 
   virtual void RemoveObserver(PolicyDomain domain, Observer* observer) = 0;
 
-  // Registers the current components of the given policy |domain|, signaling
-  // that there is interest in receiving policy for them.
-  // |component_ids| is the current set of components for that |domain|, and
-  // replaces any previously registered set.
-  // The policy providers will try to load policy for these components, and may
-  // flush cached data for components that aren't registered anymore.
+  // Registers the |descriptor| of a policy domain, indicated by
+  // |descriptor->domain()|. This overrides the descriptor previously set, if
+  // there was one.
+  // This registration signals that there is interest in receiving policy for
+  // the components listed in the descriptor. The policy providers will try to
+  // load policy for these components, and validate it against the descriptor.
+  // Cached data for components that aren't registered anymore may be dropped.
   virtual void RegisterPolicyDomain(
-      PolicyDomain domain,
-      const std::set<std::string>& component_ids) = 0;
+      scoped_refptr<const PolicyDomainDescriptor> descriptor) = 0;
 
   virtual const PolicyMap& GetPolicies(const PolicyNamespace& ns) const = 0;
 
   // The PolicyService loads policy from several sources, and some require
   // asynchronous loads. IsInitializationComplete() returns true once all
   // sources have loaded their policies for the given |domain|.
   // It is safe to read policy from the PolicyService even if
   // IsInitializationComplete() is false; there will be an OnPolicyUpdated()
   // notification once new policies become available.
   //
@@ skipping 42 matching lines @@
   PolicyService* policy_service_;
   PolicyNamespace ns_;
   CallbackMap callback_map_;
 
   DISALLOW_COPY_AND_ASSIGN(PolicyChangeRegistrar);
 };
 
 }  // namespace policy
 
 #endif  // CHROME_BROWSER_POLICY_POLICY_SERVICE_H_