OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_H_ | 5 #ifndef COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_H_ |
6 #define COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_H_ | 6 #define COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_H_ |
7 | 7 |
8 class PrefHashStoreTransaction; | 8 class PrefHashStoreTransaction; |
9 | 9 |
10 namespace base { | 10 namespace base { |
11 class DictionaryValue; | 11 class DictionaryValue; |
12 class Value; | 12 class Value; |
13 } | 13 } |
14 | 14 |
15 enum class TrackedPreferenceType { ATOMIC, SPLIT }; | |
16 | |
17 // A TrackedPreference tracks changes to an individual preference, reporting and | 15 // A TrackedPreference tracks changes to an individual preference, reporting and |
18 // reacting to them according to preference-specific and browser-wide policies. | 16 // reacting to them according to preference-specific and browser-wide policies. |
19 class TrackedPreference { | 17 class TrackedPreference { |
20 public: | 18 public: |
21 virtual ~TrackedPreference() {} | 19 virtual ~TrackedPreference() {} |
22 | 20 |
23 virtual TrackedPreferenceType GetType() const = 0; | |
24 | |
25 // Notifies the underlying TrackedPreference about its new |value| which | 21 // Notifies the underlying TrackedPreference about its new |value| which |
26 // can update hashes in the corresponding hash store via |transaction|. | 22 // can update hashes in the corresponding hash store via |transaction|. |
27 virtual void OnNewValue(const base::Value* value, | 23 virtual void OnNewValue(const base::Value* value, |
28 PrefHashStoreTransaction* transaction) const = 0; | 24 PrefHashStoreTransaction* transaction) const = 0; |
29 | 25 |
30 // Verifies that the value of this TrackedPreference in |pref_store_contents| | 26 // Verifies that the value of this TrackedPreference in |pref_store_contents| |
31 // is valid. Responds to verification failures according to | 27 // is valid. Responds to verification failures according to |
32 // preference-specific and browser-wide policy and reports results to via UMA. | 28 // preference-specific and browser-wide policy and reports results to via UMA. |
33 // May use |transaction| to check/modify hashes in the corresponding hash | 29 // May use |transaction| to check/modify hashes in the corresponding hash |
34 // store. Performs validation and reports results without enforcing for | 30 // store. |
35 // |external_validation_transaction|. This call assumes exclusive access to | |
36 // |external_validation_transaction| and its associated state and as such | |
37 // should only be called before any other subsystem is made aware of it. | |
38 virtual bool EnforceAndReport( | 31 virtual bool EnforceAndReport( |
39 base::DictionaryValue* pref_store_contents, | 32 base::DictionaryValue* pref_store_contents, |
40 PrefHashStoreTransaction* transaction, | 33 PrefHashStoreTransaction* transaction) const = 0; |
41 PrefHashStoreTransaction* external_validation_transaction) const = 0; | |
42 }; | 34 }; |
43 | 35 |
44 #endif // COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_H_ | 36 #endif // COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_H_ |
OLD | NEW |