| OLD | NEW |
|---|
| (Empty) |
| 1 // Copyright (c) 2012 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 BASE_PREFS_JSON_PREF_STORE_H_ | |
| 6 #define BASE_PREFS_JSON_PREF_STORE_H_ | |
| 7 | |
| 8 #include <stdint.h> | |
| 9 | |
| 10 #include <set> | |
| 11 #include <string> | |
| 12 | |
| 13 #include "base/callback_forward.h" | |
| 14 #include "base/compiler_specific.h" | |
| 15 #include "base/files/file_path.h" | |
| 16 #include "base/files/important_file_writer.h" | |
| 17 #include "base/gtest_prod_util.h" | |
| 18 #include "base/macros.h" | |
| 19 #include "base/memory/scoped_ptr.h" | |
| 20 #include "base/memory/weak_ptr.h" | |
| 21 #include "base/observer_list.h" | |
| 22 #include "base/prefs/base_prefs_export.h" | |
| 23 #include "base/prefs/persistent_pref_store.h" | |
| 24 #include "base/threading/non_thread_safe.h" | |
| 25 | |
| 26 class PrefFilter; | |
| 27 | |
| 28 namespace base { | |
| 29 class Clock; | |
| 30 class DictionaryValue; | |
| 31 class FilePath; | |
| 32 class HistogramBase; | |
| 33 class JsonPrefStoreLossyWriteTest; | |
| 34 class SequencedTaskRunner; | |
| 35 class SequencedWorkerPool; | |
| 36 class Value; | |
| 37 FORWARD_DECLARE_TEST(JsonPrefStoreTest, WriteCountHistogramTestBasic); | |
| 38 FORWARD_DECLARE_TEST(JsonPrefStoreTest, WriteCountHistogramTestSinglePeriod); | |
| 39 FORWARD_DECLARE_TEST(JsonPrefStoreTest, WriteCountHistogramTestMultiplePeriods); | |
| 40 FORWARD_DECLARE_TEST(JsonPrefStoreTest, WriteCountHistogramTestPeriodWithGaps); | |
| 41 } | |
| 42 | |
| 43 // A writable PrefStore implementation that is used for user preferences. | |
| 44 class BASE_PREFS_EXPORT JsonPrefStore | |
| 45 : public PersistentPrefStore, | |
| 46 public base::ImportantFileWriter::DataSerializer, | |
| 47 public base::SupportsWeakPtr<JsonPrefStore>, | |
| 48 public base::NonThreadSafe { | |
| 49 public: | |
| 50 struct ReadResult; | |
| 51 | |
| 52 // Returns instance of SequencedTaskRunner which guarantees that file | |
| 53 // operations on the same file will be executed in sequenced order. | |
| 54 static scoped_refptr<base::SequencedTaskRunner> GetTaskRunnerForFile( | |
| 55 const base::FilePath& pref_filename, | |
| 56 base::SequencedWorkerPool* worker_pool); | |
| 57 | |
| 58 // Same as the constructor below with no alternate filename. | |
| 59 JsonPrefStore( | |
| 60 const base::FilePath& pref_filename, | |
| 61 const scoped_refptr<base::SequencedTaskRunner>& sequenced_task_runner, | |
| 62 scoped_ptr<PrefFilter> pref_filter); | |
| 63 | |
| 64 // |sequenced_task_runner| must be a shutdown-blocking task runner, ideally | |
| 65 // created by the GetTaskRunnerForFile() method above. | |
| 66 // |pref_filename| is the path to the file to read prefs from. | |
| 67 // |pref_alternate_filename| is the path to an alternate file which the | |
| 68 // desired prefs may have previously been written to. If |pref_filename| | |
| 69 // doesn't exist and |pref_alternate_filename| does, |pref_alternate_filename| | |
| 70 // will be moved to |pref_filename| before the read occurs. | |
| 71 JsonPrefStore( | |
| 72 const base::FilePath& pref_filename, | |
| 73 const base::FilePath& pref_alternate_filename, | |
| 74 const scoped_refptr<base::SequencedTaskRunner>& sequenced_task_runner, | |
| 75 scoped_ptr<PrefFilter> pref_filter); | |
| 76 | |
| 77 // PrefStore overrides: | |
| 78 bool GetValue(const std::string& key, | |
| 79 const base::Value** result) const override; | |
| 80 void AddObserver(PrefStore::Observer* observer) override; | |
| 81 void RemoveObserver(PrefStore::Observer* observer) override; | |
| 82 bool HasObservers() const override; | |
| 83 bool IsInitializationComplete() const override; | |
| 84 | |
| 85 // PersistentPrefStore overrides: | |
| 86 bool GetMutableValue(const std::string& key, base::Value** result) override; | |
| 87 void SetValue(const std::string& key, | |
| 88 scoped_ptr<base::Value> value, | |
| 89 uint32_t flags) override; | |
| 90 void SetValueSilently(const std::string& key, | |
| 91 scoped_ptr<base::Value> value, | |
| 92 uint32_t flags) override; | |
| 93 void RemoveValue(const std::string& key, uint32_t flags) override; | |
| 94 bool ReadOnly() const override; | |
| 95 PrefReadError GetReadError() const override; | |
| 96 // Note this method may be asynchronous if this instance has a |pref_filter_| | |
| 97 // in which case it will return PREF_READ_ERROR_ASYNCHRONOUS_TASK_INCOMPLETE. | |
| 98 // See details in pref_filter.h. | |
| 99 PrefReadError ReadPrefs() override; | |
| 100 void ReadPrefsAsync(ReadErrorDelegate* error_delegate) override; | |
| 101 void CommitPendingWrite() override; | |
| 102 void SchedulePendingLossyWrites() override; | |
| 103 void ReportValueChanged(const std::string& key, uint32_t flags) override; | |
| 104 | |
| 105 // Just like RemoveValue(), but doesn't notify observers. Used when doing some | |
| 106 // cleanup that shouldn't otherwise alert observers. | |
| 107 void RemoveValueSilently(const std::string& key, uint32_t flags); | |
| 108 | |
| 109 // Registers |on_next_successful_write| to be called once, on the next | |
| 110 // successful write event of |writer_|. | |
| 111 void RegisterOnNextSuccessfulWriteCallback( | |
| 112 const base::Closure& on_next_successful_write); | |
| 113 | |
| 114 private: | |
| 115 // Represents a histogram for recording the number of writes to the pref file | |
| 116 // that occur every kHistogramWriteReportIntervalInMins minutes. | |
| 117 class BASE_PREFS_EXPORT WriteCountHistogram { | |
| 118 public: | |
| 119 static const int32_t kHistogramWriteReportIntervalMins; | |
| 120 | |
| 121 WriteCountHistogram(const base::TimeDelta& commit_interval, | |
| 122 const base::FilePath& path); | |
| 123 // Constructor for testing. |clock| is a test Clock that is used to retrieve | |
| 124 // the time. | |
| 125 WriteCountHistogram(const base::TimeDelta& commit_interval, | |
| 126 const base::FilePath& path, | |
| 127 scoped_ptr<base::Clock> clock); | |
| 128 ~WriteCountHistogram(); | |
| 129 | |
| 130 // Record that a write has occured. | |
| 131 void RecordWriteOccured(); | |
| 132 | |
| 133 // Reports writes (that have not yet been reported) in all of the recorded | |
| 134 // intervals that have elapsed up until current time. | |
| 135 void ReportOutstandingWrites(); | |
| 136 | |
| 137 base::HistogramBase* GetHistogram(); | |
| 138 | |
| 139 private: | |
| 140 // The minimum interval at which writes can occur. | |
| 141 const base::TimeDelta commit_interval_; | |
| 142 | |
| 143 // The path to the file. | |
| 144 const base::FilePath path_; | |
| 145 | |
| 146 // Clock which is used to retrieve the current time. | |
| 147 scoped_ptr<base::Clock> clock_; | |
| 148 | |
| 149 // The interval at which to report write counts. | |
| 150 const base::TimeDelta report_interval_; | |
| 151 | |
| 152 // The time at which the last histogram value was reported for the number | |
| 153 // of write counts. | |
| 154 base::Time last_report_time_; | |
| 155 | |
| 156 // The number of writes that have occured since the last write count was | |
| 157 // reported. | |
| 158 uint32_t writes_since_last_report_; | |
| 159 | |
| 160 DISALLOW_COPY_AND_ASSIGN(WriteCountHistogram); | |
| 161 }; | |
| 162 | |
| 163 FRIEND_TEST_ALL_PREFIXES(base::JsonPrefStoreTest, | |
| 164 WriteCountHistogramTestBasic); | |
| 165 FRIEND_TEST_ALL_PREFIXES(base::JsonPrefStoreTest, | |
| 166 WriteCountHistogramTestSinglePeriod); | |
| 167 FRIEND_TEST_ALL_PREFIXES(base::JsonPrefStoreTest, | |
| 168 WriteCountHistogramTestMultiplePeriods); | |
| 169 FRIEND_TEST_ALL_PREFIXES(base::JsonPrefStoreTest, | |
| 170 WriteCountHistogramTestPeriodWithGaps); | |
| 171 friend class base::JsonPrefStoreLossyWriteTest; | |
| 172 | |
| 173 ~JsonPrefStore() override; | |
| 174 | |
| 175 // This method is called after the JSON file has been read. It then hands | |
| 176 // |value| (or an empty dictionary in some read error cases) to the | |
| 177 // |pref_filter| if one is set. It also gives a callback pointing at | |
| 178 // FinalizeFileRead() to that |pref_filter_| which is then responsible for | |
| 179 // invoking it when done. If there is no |pref_filter_|, FinalizeFileRead() | |
| 180 // is invoked directly. | |
| 181 void OnFileRead(scoped_ptr<ReadResult> read_result); | |
| 182 | |
| 183 // ImportantFileWriter::DataSerializer overrides: | |
| 184 bool SerializeData(std::string* output) override; | |
| 185 | |
| 186 // This method is called after the JSON file has been read and the result has | |
| 187 // potentially been intercepted and modified by |pref_filter_|. | |
| 188 // |initialization_successful| is pre-determined by OnFileRead() and should | |
| 189 // be used when reporting OnInitializationCompleted(). | |
| 190 // |schedule_write| indicates whether a write should be immediately scheduled | |
| 191 // (typically because the |pref_filter_| has already altered the |prefs|) -- | |
| 192 // this will be ignored if this store is read-only. | |
| 193 void FinalizeFileRead(bool initialization_successful, | |
| 194 scoped_ptr<base::DictionaryValue> prefs, | |
| 195 bool schedule_write); | |
| 196 | |
| 197 // Schedule a write with the file writer as long as |flags| doesn't contain | |
| 198 // WriteablePrefStore::LOSSY_PREF_WRITE_FLAG. | |
| 199 void ScheduleWrite(uint32_t flags); | |
| 200 | |
| 201 const base::FilePath path_; | |
| 202 const base::FilePath alternate_path_; | |
| 203 const scoped_refptr<base::SequencedTaskRunner> sequenced_task_runner_; | |
| 204 | |
| 205 scoped_ptr<base::DictionaryValue> prefs_; | |
| 206 | |
| 207 bool read_only_; | |
| 208 | |
| 209 // Helper for safely writing pref data. | |
| 210 base::ImportantFileWriter writer_; | |
| 211 | |
| 212 scoped_ptr<PrefFilter> pref_filter_; | |
| 213 base::ObserverList<PrefStore::Observer, true> observers_; | |
| 214 | |
| 215 scoped_ptr<ReadErrorDelegate> error_delegate_; | |
| 216 | |
| 217 bool initialized_; | |
| 218 bool filtering_in_progress_; | |
| 219 bool pending_lossy_write_; | |
| 220 PrefReadError read_error_; | |
| 221 | |
| 222 std::set<std::string> keys_need_empty_value_; | |
| 223 | |
| 224 WriteCountHistogram write_count_histogram_; | |
| 225 | |
| 226 DISALLOW_COPY_AND_ASSIGN(JsonPrefStore); | |
| 227 }; | |
| 228 | |
| 229 #endif // BASE_PREFS_JSON_PREF_STORE_H_ | |
| OLD | NEW |
|---|
Chromium Code Reviews
Issue 1645073005:
Revert of Move base/prefs to components/prefs (Closed)
Base URL: https://chromium.googlesource.com/chromium/src.git@master