Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 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 BASE_FILES_IMPORTANT_FILE_WRITER_H_ | 5 #ifndef BASE_FILES_IMPORTANT_FILE_WRITER_H_ |
| 6 #define BASE_FILES_IMPORTANT_FILE_WRITER_H_ | 6 #define BASE_FILES_IMPORTANT_FILE_WRITER_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/base_export.h" | 10 #include "base/base_export.h" |
| (...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 46 // ImportantFileWriter has been created. | 46 // ImportantFileWriter has been created. |
| 47 virtual bool SerializeData(std::string* data) = 0; | 47 virtual bool SerializeData(std::string* data) = 0; |
| 48 | 48 |
| 49 protected: | 49 protected: |
| 50 virtual ~DataSerializer() {} | 50 virtual ~DataSerializer() {} |
| 51 }; | 51 }; |
| 52 | 52 |
| 53 // Save |data| to |path| in an atomic manner. Blocks and writes data on the | 53 // Save |data| to |path| in an atomic manner. Blocks and writes data on the |
| 54 // current thread. Does not guarantee file integrity across system crash (see | 54 // current thread. Does not guarantee file integrity across system crash (see |
| 55 // the class comment above). | 55 // the class comment above). |
| 56 static bool WriteFileAtomically(const FilePath& path, StringPiece data); | 56 static bool WriteFileAtomically( |
| 57 const FilePath& path, | |
| 58 StringPiece data, | |
| 59 const std::string& histogram_suffix = std::string()); | |
|
dcheng
2017/06/19 20:27:55
OK, I misread the code and thought this was an int
xaerox
2017/06/20 04:21:00
Done.
| |
| 57 | 60 |
| 58 // Initialize the writer. | 61 // Initialize the writer. |
| 59 // |path| is the name of file to write. | 62 // |path| is the name of file to write. |
| 60 // |task_runner| is the SequencedTaskRunner instance where on which we will | 63 // |task_runner| is the SequencedTaskRunner instance where on which we will |
| 61 // execute file I/O operations. | 64 // execute file I/O operations. |
| 62 // All non-const methods, ctor and dtor must be called on the same thread. | 65 // All non-const methods, ctor and dtor must be called on the same thread. |
| 63 ImportantFileWriter(const FilePath& path, | 66 ImportantFileWriter(const FilePath& path, |
| 64 scoped_refptr<SequencedTaskRunner> task_runner); | 67 scoped_refptr<SequencedTaskRunner> task_runner, |
| 68 const char* histogram_suffix = nullptr); | |
| 65 | 69 |
| 66 // Same as above, but with a custom commit interval. | 70 // Same as above, but with a custom commit interval. |
| 67 ImportantFileWriter(const FilePath& path, | 71 ImportantFileWriter(const FilePath& path, |
| 68 scoped_refptr<SequencedTaskRunner> task_runner, | 72 scoped_refptr<SequencedTaskRunner> task_runner, |
| 69 TimeDelta interval); | 73 TimeDelta interval, |
| 74 const char* histogram_suffix = nullptr); | |
| 70 | 75 |
| 71 // You have to ensure that there are no pending writes at the moment | 76 // You have to ensure that there are no pending writes at the moment |
| 72 // of destruction. | 77 // of destruction. |
| 73 ~ImportantFileWriter(); | 78 ~ImportantFileWriter(); |
| 74 | 79 |
| 75 const FilePath& path() const { return path_; } | 80 const FilePath& path() const { return path_; } |
| 76 | 81 |
| 77 // Returns true if there is a scheduled write pending which has not yet | 82 // Returns true if there is a scheduled write pending which has not yet |
| 78 // been started. | 83 // been started. |
| 79 bool HasPendingWrite() const; | 84 bool HasPendingWrite() const; |
| (...skipping 56 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 136 | 141 |
| 137 // An override for |timer_| used for testing. | 142 // An override for |timer_| used for testing. |
| 138 Timer* timer_override_ = nullptr; | 143 Timer* timer_override_ = nullptr; |
| 139 | 144 |
| 140 // Serializer which will provide the data to be saved. | 145 // Serializer which will provide the data to be saved. |
| 141 DataSerializer* serializer_; | 146 DataSerializer* serializer_; |
| 142 | 147 |
| 143 // Time delta after which scheduled data will be written to disk. | 148 // Time delta after which scheduled data will be written to disk. |
| 144 const TimeDelta commit_interval_; | 149 const TimeDelta commit_interval_; |
| 145 | 150 |
| 151 // Custom histogram suffix. | |
| 152 const std::string histogram_suffix_; | |
| 153 | |
| 146 SEQUENCE_CHECKER(sequence_checker_); | 154 SEQUENCE_CHECKER(sequence_checker_); |
| 147 | 155 |
| 148 WeakPtrFactory<ImportantFileWriter> weak_factory_; | 156 WeakPtrFactory<ImportantFileWriter> weak_factory_; |
| 149 | 157 |
| 150 DISALLOW_COPY_AND_ASSIGN(ImportantFileWriter); | 158 DISALLOW_COPY_AND_ASSIGN(ImportantFileWriter); |
| 151 }; | 159 }; |
| 152 | 160 |
| 153 } // namespace base | 161 } // namespace base |
| 154 | 162 |
| 155 #endif // BASE_FILES_IMPORTANT_FILE_WRITER_H_ | 163 #endif // BASE_FILES_IMPORTANT_FILE_WRITER_H_ |
| OLD | NEW |