| OLD | NEW |
| (Empty) |
| 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. | |
| 4 | |
| 5 #ifndef CHROME_BROWSER_MANAGED_MODE_MANAGED_USER_SETTINGS_SERVICE_H_ | |
| 6 #define CHROME_BROWSER_MANAGED_MODE_MANAGED_USER_SETTINGS_SERVICE_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 #include <vector> | |
| 10 | |
| 11 #include "base/callback.h" | |
| 12 #include "base/memory/ref_counted.h" | |
| 13 #include "base/memory/scoped_ptr.h" | |
| 14 #include "base/prefs/pref_store.h" | |
| 15 #include "base/values.h" | |
| 16 #include "chrome/browser/managed_mode/managed_users.h" | |
| 17 #include "components/browser_context_keyed_service/browser_context_keyed_service
.h" | |
| 18 | |
| 19 class PersistentPrefStore; | |
| 20 class Profile; | |
| 21 | |
| 22 namespace base { | |
| 23 class FilePath; | |
| 24 class SequencedTaskRunner; | |
| 25 } | |
| 26 | |
| 27 // TODO(bauerb): This class is not yet fully functional. | |
| 28 // This class syncs managed user settings from a server, which are mapped to | |
| 29 // preferences. The downloaded settings are persisted in a PrefStore (which is | |
| 30 // not directly hooked up to the PrefService; it's just used internally). | |
| 31 // Settings are key-value pairs, where the key uniquely identifies the setting. | |
| 32 // The value is a string containing a JSON serialization of an arbitrary value, | |
| 33 // which is the value of the setting. | |
| 34 // | |
| 35 // There are two kinds of settings handled by this class: Atomic and split | |
| 36 // settings. | |
| 37 // Atomic settings consist of a single key (which will be mapped to a pref key) | |
| 38 // and a single (arbitrary) value. | |
| 39 // Split settings encode a dictionary value and are stored as multiple Sync | |
| 40 // items, one for each dictionary entry. The key for each of these Sync items | |
| 41 // is the key of the split setting, followed by a separator (':') and the key | |
| 42 // for the dictionary entry. The value of the Sync item is the value of the | |
| 43 // dictionary entry. | |
| 44 // | |
| 45 // As an example, a split setting with key "Moose" and value | |
| 46 // { | |
| 47 // "foo": "bar", | |
| 48 // "baz": "blurp" | |
| 49 // } | |
| 50 // would be encoded as two sync items, one with key "Moose:foo" and value "bar", | |
| 51 // and one with key "Moose:baz" and value "blurp". | |
| 52 class ManagedUserSettingsService : public BrowserContextKeyedService, | |
| 53 public PrefStore::Observer { | |
| 54 public: | |
| 55 // A callback whose first parameter is a dictionary containing all managed | |
| 56 // user settings. If the dictionary is NULL, it means that the service is | |
| 57 // inactive, i.e. the user is not managed. | |
| 58 typedef base::Callback<void(const base::DictionaryValue*)> SettingsCallback; | |
| 59 | |
| 60 ManagedUserSettingsService(); | |
| 61 virtual ~ManagedUserSettingsService(); | |
| 62 | |
| 63 // Initializes the service by loading its settings from the |pref_store|. | |
| 64 // Use this method in tests to inject a different PrefStore than the | |
| 65 // default one. | |
| 66 void Init(scoped_refptr<PersistentPrefStore> pref_store); | |
| 67 | |
| 68 // Adds a callback to be called when managed user settings are initially | |
| 69 // available, or when they change. | |
| 70 void Subscribe(const SettingsCallback& callback); | |
| 71 | |
| 72 // Activates the service. This happens when the user is managed. | |
| 73 void Activate(); | |
| 74 | |
| 75 // Whether managed user settings are available. | |
| 76 bool IsReady(); | |
| 77 | |
| 78 // Clears all managed user settings and items. | |
| 79 void Clear(); | |
| 80 | |
| 81 // Sets the setting with the given |key| to a copy of the given |value|. | |
| 82 void SetLocalSettingForTesting(const std::string& key, | |
| 83 scoped_ptr<base::Value> value); | |
| 84 | |
| 85 // BrowserContextKeyedService implementation: | |
| 86 virtual void Shutdown() OVERRIDE; | |
| 87 | |
| 88 // PrefStore::Observer implementation: | |
| 89 virtual void OnPrefValueChanged(const std::string& key) OVERRIDE; | |
| 90 virtual void OnInitializationCompleted(bool success) OVERRIDE; | |
| 91 | |
| 92 private: | |
| 93 base::DictionaryValue* GetOrCreateDictionary(const std::string& key) const; | |
| 94 base::DictionaryValue* GetAtomicSettings() const; | |
| 95 base::DictionaryValue* GetSplitSettings() const; | |
| 96 base::DictionaryValue* GetQueuedItems() const; | |
| 97 | |
| 98 // Returns a dictionary with all managed user settings if the service is | |
| 99 // active, or NULL otherwise. | |
| 100 scoped_ptr<base::DictionaryValue> GetSettings(); | |
| 101 | |
| 102 // Sends the settings to all subscribers. This method should be called by the | |
| 103 // subclass whenever the settings change. | |
| 104 void InformSubscribers(); | |
| 105 | |
| 106 // Used for persisting the settings. Unlike other PrefStores, this one is not | |
| 107 // directly hooked up to the PrefService. | |
| 108 scoped_refptr<PersistentPrefStore> store_; | |
| 109 | |
| 110 bool active_; | |
| 111 | |
| 112 // A set of local settings that are fixed and not configured remotely. | |
| 113 scoped_ptr<base::DictionaryValue> local_settings_; | |
| 114 | |
| 115 std::vector<SettingsCallback> subscribers_; | |
| 116 | |
| 117 DISALLOW_COPY_AND_ASSIGN(ManagedUserSettingsService); | |
| 118 }; | |
| 119 | |
| 120 #endif // CHROME_BROWSER_MANAGED_MODE_MANAGED_USER_SETTINGS_SERVICE_H_ | |
| OLD | NEW |