1 // Copyright 2013 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.
5 #ifndef COMPONENTS_POLICY_CORE_COMMON_CONFIGURATION_POLICY_PROVIDER_H_
6 #define COMPONENTS_POLICY_CORE_COMMON_CONFIGURATION_POLICY_PROVIDER_H_
8 #include "base/basictypes.h"
9 #include "base/memory/ref_counted.h"
10 #include "base/memory/scoped_ptr.h"
11 #include "base/observer_list.h"
12 #include "components/policy/core/common/policy_bundle.h"
13 #include "components/policy/core/common/policy_namespace.h"
14 #include "components/policy/core/common/schema_registry.h"
15 #include "components/policy/policy_export.h"
19 // A mostly-abstract super class for platform-specific policy providers.
20 // Platform-specific policy providers (Windows Group Policy, gconf,
21 // etc.) should implement a subclass of this class.
22 class POLICY_EXPORT ConfigurationPolicyProvider
23 : public SchemaRegistry::Observer
{
25 class POLICY_EXPORT Observer
{
28 virtual void OnUpdatePolicy(ConfigurationPolicyProvider
* provider
) = 0;
31 ConfigurationPolicyProvider();
33 // Policy providers can be deleted quite late during shutdown of the browser,
34 // and it's not guaranteed that the message loops will still be running when
35 // this is invoked. Override Shutdown() instead for cleanup code that needs
36 // to post to the FILE thread, for example.
37 ~ConfigurationPolicyProvider() override
;
39 // Invoked as soon as the main message loops are spinning. Policy providers
40 // are created early during startup to provide the initial policies; the
41 // Init() call allows them to perform initialization tasks that require
42 // running message loops.
43 // The policy provider will load policy for the components registered in
44 // the |schema_registry| whose domain is supported by this provider.
45 virtual void Init(SchemaRegistry
* registry
);
47 // Must be invoked before deleting the provider. Implementations can override
48 // this method to do appropriate cleanup while threads are still running, and
49 // must also invoke ConfigurationPolicyProvider::Shutdown().
50 // The provider should keep providing the current policies after Shutdown()
51 // is invoked, it only has to stop updating.
52 virtual void Shutdown();
54 // Returns the current PolicyBundle.
55 const PolicyBundle
& policies() const { return policy_bundle_
; }
57 // Check whether this provider has completed initialization for the given
58 // policy |domain|. This is used to detect whether initialization is done in
59 // case implementations need to do asynchronous operations for initialization.
60 virtual bool IsInitializationComplete(PolicyDomain domain
) const;
62 // Asks the provider to refresh its policies. All the updates caused by this
63 // call will be visible on the next call of OnUpdatePolicy on the observers,
64 // which are guaranteed to happen even if the refresh fails.
65 // It is possible that Shutdown() is called first though, and
66 // OnUpdatePolicy won't be called if that happens.
67 virtual void RefreshPolicies() = 0;
69 // Observers must detach themselves before the provider is deleted.
70 virtual void AddObserver(Observer
* observer
);
71 virtual void RemoveObserver(Observer
* observer
);
73 // SchemaRegistry::Observer:
74 void OnSchemaRegistryUpdated(bool has_new_schemas
) override
;
75 void OnSchemaRegistryReady() override
;
78 // Subclasses must invoke this to update the policies currently served by
79 // this provider. UpdatePolicy() takes ownership of |policies|.
80 // The observers are notified after the policies are updated.
81 void UpdatePolicy(scoped_ptr
<PolicyBundle
> bundle
);
83 SchemaRegistry
* schema_registry() const;
85 const scoped_refptr
<SchemaMap
>& schema_map() const;
88 // The policies currently configured at this provider.
89 PolicyBundle policy_bundle_
;
91 // Used to validate proper Init() and Shutdown() nesting. This flag is set by
92 // Init() and cleared by Shutdown() and needs to be false in the destructor.
95 SchemaRegistry
* schema_registry_
;
97 ObserverList
<Observer
, true> observer_list_
;
99 DISALLOW_COPY_AND_ASSIGN(ConfigurationPolicyProvider
);
102 } // namespace policy
104 #endif // COMPONENTS_POLICY_CORE_COMMON_CONFIGURATION_POLICY_PROVIDER_H_