Index: chrome/browser/policy/configuration_policy_provider.h |
diff --git a/chrome/browser/policy/configuration_policy_provider.h b/chrome/browser/policy/configuration_policy_provider.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..926fd75e2c1fa32ca3adde49f17ce4e042557602 |
--- /dev/null |
+++ b/chrome/browser/policy/configuration_policy_provider.h |
@@ -0,0 +1,101 @@ |
+// 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_CONFIGURATION_POLICY_PROVIDER_H_ |
+#define CHROME_BROWSER_POLICY_CONFIGURATION_POLICY_PROVIDER_H_ |
+ |
+#include "base/basictypes.h" |
+#include "base/memory/ref_counted.h" |
+#include "base/memory/scoped_ptr.h" |
+#include "base/observer_list.h" |
+#include "components/policy/core/common/policy_bundle.h" |
+#include "components/policy/core/common/policy_namespace.h" |
+#include "components/policy/core/common/schema_registry.h" |
+ |
+namespace policy { |
+ |
+// A mostly-abstract super class for platform-specific policy providers. |
+// Platform-specific policy providers (Windows Group Policy, gconf, |
+// etc.) should implement a subclass of this class. |
+class ConfigurationPolicyProvider : public SchemaRegistry::Observer { |
+ public: |
+ class Observer { |
+ public: |
+ virtual ~Observer(); |
+ virtual void OnUpdatePolicy(ConfigurationPolicyProvider* provider) = 0; |
+ }; |
+ |
+ ConfigurationPolicyProvider(); |
+ |
+ // Policy providers can be deleted quite late during shutdown of the browser, |
+ // and it's not guaranteed that the message loops will still be running when |
+ // this is invoked. Override Shutdown() instead for cleanup code that needs |
+ // to post to the FILE thread, for example. |
+ virtual ~ConfigurationPolicyProvider(); |
+ |
+ // Invoked as soon as the main message loops are spinning. Policy providers |
+ // are created early during startup to provide the initial policies; the |
+ // Init() call allows them to perform initialization tasks that require |
+ // running message loops. |
+ // The policy provider will load policy for the components registered in |
+ // the |schema_registry| whose domain is supported by this provider. |
+ virtual void Init(SchemaRegistry* registry); |
+ |
+ // Must be invoked before deleting the provider. Implementations can override |
+ // this method to do appropriate cleanup while threads are still running, and |
+ // must also invoke ConfigurationPolicyProvider::Shutdown(). |
+ // The provider should keep providing the current policies after Shutdown() |
+ // is invoked, it only has to stop updating. |
+ virtual void Shutdown(); |
+ |
+ // Returns the current PolicyBundle. |
+ const PolicyBundle& policies() const { return policy_bundle_; } |
+ |
+ // Check whether this provider has completed initialization for the given |
+ // policy |domain|. This is used to detect whether initialization is done in |
+ // case implementations need to do asynchronous operations for initialization. |
+ virtual bool IsInitializationComplete(PolicyDomain domain) const; |
+ |
+ // Asks the provider to refresh its policies. All the updates caused by this |
+ // call will be visible on the next call of OnUpdatePolicy on the observers, |
+ // which are guaranteed to happen even if the refresh fails. |
+ // It is possible that Shutdown() is called first though, and |
+ // OnUpdatePolicy won't be called if that happens. |
+ virtual void RefreshPolicies() = 0; |
+ |
+ // Observers must detach themselves before the provider is deleted. |
+ virtual void AddObserver(Observer* observer); |
+ virtual void RemoveObserver(Observer* observer); |
+ |
+ // SchemaRegistry::Observer: |
+ virtual void OnSchemaRegistryUpdated(bool has_new_schemas) OVERRIDE; |
+ virtual void OnSchemaRegistryReady() OVERRIDE; |
+ |
+ protected: |
+ // Subclasses must invoke this to update the policies currently served by |
+ // this provider. UpdatePolicy() takes ownership of |policies|. |
+ // The observers are notified after the policies are updated. |
+ void UpdatePolicy(scoped_ptr<PolicyBundle> bundle); |
+ |
+ SchemaRegistry* schema_registry() const; |
+ |
+ const scoped_refptr<SchemaMap>& schema_map() const; |
+ |
+ private: |
+ // The policies currently configured at this provider. |
+ PolicyBundle policy_bundle_; |
+ |
+ // Whether Shutdown() has been invoked. |
+ bool did_shutdown_; |
+ |
+ SchemaRegistry* schema_registry_; |
+ |
+ ObserverList<Observer, true> observer_list_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(ConfigurationPolicyProvider); |
+}; |
+ |
+} // namespace policy |
+ |
+#endif // CHROME_BROWSER_POLICY_CONFIGURATION_POLICY_PROVIDER_H_ |