blob: 5eec49725ad8e78c27b76957f6d2b0246b496303 (
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
|
// 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/observer_list.h"
#include "base/values.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;
base::Value::Type 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 ConfigurationPolicyPrefStore invokes this |Provide|
// method when it needs a policy provider to specify its policy choices. In
// |Provide|, the |ConfigurationPolicyProvider| fills the given |result| with
// policy values. Returns true if the policy could be provided and false
// otherwise.
virtual bool Provide(PolicyMap* result) = 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:
// Sends a policy update notification to observers.
void NotifyPolicyUpdated();
const PolicyDefinitionList* policy_definition_list() const {
return policy_definition_list_;
}
private:
friend class ConfigurationPolicyObserverRegistrar;
virtual void AddObserver(ConfigurationPolicyProvider::Observer* observer);
virtual void RemoveObserver(
ConfigurationPolicyProvider::Observer* observer);
// Contains the default mapping from policy values to the actual names.
const ConfigurationPolicyProvider::PolicyDefinitionList*
policy_definition_list_;
ObserverList<ConfigurationPolicyProvider::Observer, true> observer_list_;
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();
virtual ~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_
|
