blob: 1cbc848e998d6f48625c55470e9c206c625b7ac4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
// Copyright (c) 2011 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_
#pragma once
#include <map>
#include <string>
#include "base/basictypes.h"
#include "base/memory/scoped_ptr.h"
#include "base/values.h"
#include "chrome/browser/policy/configuration_policy_store_interface.h"
#include "policy/configuration_policy_type.h"
namespace policy {
class PolicyMap;
// 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:
class Observer {
public:
virtual ~Observer() {}
virtual void OnUpdatePolicy() = 0;
virtual void OnProviderGoingAway() = 0;
};
// Used for static arrays of policy values that is used to initialize an
// instance of the ConfigurationPolicyProvider.
struct PolicyDefinitionList {
struct Entry {
ConfigurationPolicyType policy_type;
Value::ValueType value_type;
const char* name;
};
const Entry* begin;
const Entry* end;
};
explicit ConfigurationPolicyProvider(const PolicyDefinitionList* policy_list);
virtual ~ConfigurationPolicyProvider();
// Must be implemented by provider subclasses to specify the provider-specific
// policy decisions. The preference service invokes this |Provide| method when
// it needs a policy provider to specify its policy choices. In |Provide|, the
// |ConfigurationPolicyProvider| must make calls to the |Apply| method of
// |store| to apply specific policies. Returns true if the policy could be
// provided, otherwise false.
virtual bool Provide(ConfigurationPolicyStoreInterface* store) = 0;
// Check whether this provider has completed initialization. This is used to
// detect whether initialization is done in case providers implementations
// need to do asynchronous operations for initialization.
virtual bool IsInitializationComplete() const;
protected:
// Decodes the value tree and writes the configuration to the given |store|.
void ApplyPolicyValueTree(const DictionaryValue* policies,
ConfigurationPolicyStoreInterface* store);
// Writes the configuration found in the already-decoded map |policies| to
// the given |store|.
void ApplyPolicyMap(const PolicyMap* policies,
ConfigurationPolicyStoreInterface* store);
const PolicyDefinitionList* policy_definition_list() const {
return policy_definition_list_;
}
private:
friend class ConfigurationPolicyObserverRegistrar;
// Temporarily needed for access to ApplyPolicyValueTree as long as we need
// to support old-style policy.
friend class UserPolicyCache;
virtual void AddObserver(ConfigurationPolicyProvider::Observer* observer) = 0;
virtual void RemoveObserver(
ConfigurationPolicyProvider::Observer* observer) = 0;
// Contains the default mapping from policy values to the actual names.
const ConfigurationPolicyProvider::PolicyDefinitionList*
policy_definition_list_;
private:
DISALLOW_COPY_AND_ASSIGN(ConfigurationPolicyProvider);
};
// Manages observers for a ConfigurationPolicyProvider. Is used to register
// observers, and automatically removes them upon destruction.
// Implementation detail: to avoid duplicate bookkeeping of registered
// observers, this registrar class acts as a proxy for notifications (since it
// needs to register itself anyway to get OnProviderGoingAway notifications).
class ConfigurationPolicyObserverRegistrar
: ConfigurationPolicyProvider::Observer {
public:
ConfigurationPolicyObserverRegistrar();
~ConfigurationPolicyObserverRegistrar();
void Init(ConfigurationPolicyProvider* provider,
ConfigurationPolicyProvider::Observer* observer);
// ConfigurationPolicyProvider::Observer implementation:
virtual void OnUpdatePolicy();
virtual void OnProviderGoingAway();
private:
ConfigurationPolicyProvider* provider_;
ConfigurationPolicyProvider::Observer* observer_;
DISALLOW_COPY_AND_ASSIGN(ConfigurationPolicyObserverRegistrar);
};
} // namespace policy
#endif // CHROME_BROWSER_POLICY_CONFIGURATION_POLICY_PROVIDER_H_
|
