OLD | NEW |
1 // Copyright 2016 The Chromium Authors. All rights reserved. | 1 // Copyright 2016 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 IOS_CHROME_BROWSER_READING_LIST_READING_LIST_STORE_H_ | 5 #ifndef IOS_CHROME_BROWSER_READING_LIST_READING_LIST_STORE_H_ |
6 #define IOS_CHROME_BROWSER_READING_LIST_READING_LIST_STORE_H_ | 6 #define IOS_CHROME_BROWSER_READING_LIST_READING_LIST_STORE_H_ |
7 | 7 |
8 #include "base/threading/non_thread_safe.h" | 8 // This is a temporary convenience file. |
9 #include "components/sync/model/model_type_store.h" | 9 #include "components/reading_list/reading_list_store.h" |
10 #include "components/sync/model/model_type_sync_bridge.h" | |
11 #include "ios/chrome/browser/reading_list/reading_list_model_storage.h" | |
12 #include "ios/chrome/browser/reading_list/reading_list_store_delegate.h" | |
13 | |
14 namespace syncer { | |
15 class MutableDataBatch; | |
16 } | |
17 | |
18 class ReadingListModel; | |
19 | |
20 // A ReadingListModelStorage storing and syncing data in protobufs. | |
21 class ReadingListStore : public syncer::ModelTypeSyncBridge, | |
22 public ReadingListModelStorage, | |
23 public base::NonThreadSafe { | |
24 using StoreFactoryFunction = base::Callback<void( | |
25 const syncer::ModelTypeStore::InitCallback& callback)>; | |
26 | |
27 public: | |
28 ReadingListStore(StoreFactoryFunction create_store_callback, | |
29 const ChangeProcessorFactory& change_processor_factory); | |
30 ~ReadingListStore() override; | |
31 | |
32 std::unique_ptr<ScopedBatchUpdate> EnsureBatchCreated() override; | |
33 | |
34 // ReadingListModelStorage implementation | |
35 void SetReadingListModel(ReadingListModel* model, | |
36 ReadingListStoreDelegate* delegate) override; | |
37 | |
38 void SaveEntry(const ReadingListEntry& entry, bool read) override; | |
39 void RemoveEntry(const ReadingListEntry& entry) override; | |
40 | |
41 // ReadingListModelStorage implementation. | |
42 syncer::ModelTypeSyncBridge* GetModelTypeSyncBridge() override; | |
43 | |
44 // Creates an object used to communicate changes in the sync metadata to the | |
45 // model type store. | |
46 std::unique_ptr<syncer::MetadataChangeList> CreateMetadataChangeList() | |
47 override; | |
48 | |
49 // Perform the initial merge between local and sync data. This should only be | |
50 // called when a data type is first enabled to start syncing, and there is no | |
51 // sync metadata. Best effort should be made to match local and sync data. The | |
52 // keys in the |entity_data_map| will have been created via GetClientTag(...), | |
53 // and if a local and sync data should match/merge but disagree on tags, the | |
54 // service should use the sync data's tag. Any local pieces of data that are | |
55 // not present in sync should immediately be Put(...) to the processor before | |
56 // returning. The same MetadataChangeList that was passed into this function | |
57 // can be passed to Put(...) calls. Delete(...) can also be called but should | |
58 // not be needed for most model types. Durable storage writes, if not able to | |
59 // combine all change atomically, should save the metadata after the data | |
60 // changes, so that this merge will be re-driven by sync if is not completely | |
61 // saved during the current run. | |
62 syncer::SyncError MergeSyncData( | |
63 std::unique_ptr<syncer::MetadataChangeList> metadata_change_list, | |
64 syncer::EntityDataMap entity_data_map) override; | |
65 | |
66 // Apply changes from the sync server locally. | |
67 // Please note that |entity_changes| might have fewer entries than | |
68 // |metadata_change_list| in case when some of the data changes are filtered | |
69 // out, or even be empty in case when a commit confirmation is processed and | |
70 // only the metadata needs to persisted. | |
71 syncer::SyncError ApplySyncChanges( | |
72 std::unique_ptr<syncer::MetadataChangeList> metadata_change_list, | |
73 syncer::EntityChangeList entity_changes) override; | |
74 | |
75 // Asynchronously retrieve the corresponding sync data for |storage_keys|. | |
76 void GetData(StorageKeyList storage_keys, DataCallback callback) override; | |
77 | |
78 // Asynchronously retrieve all of the local sync data. | |
79 void GetAllData(DataCallback callback) override; | |
80 | |
81 // Get or generate a client tag for |entity_data|. This must be the same tag | |
82 // that was/would have been generated in the SyncableService/Directory world | |
83 // for backward compatibility with pre-USS clients. The only time this | |
84 // theoretically needs to be called is on the creation of local data, however | |
85 // it is also used to verify the hash of remote data. If a data type was never | |
86 // launched pre-USS, then method does not need to be different from | |
87 // GetStorageKey(). | |
88 std::string GetClientTag(const syncer::EntityData& entity_data) override; | |
89 | |
90 // Get or generate a storage key for |entity_data|. This will only ever be | |
91 // called once when first encountering a remote entity. Local changes will | |
92 // provide their storage keys directly to Put instead of using this method. | |
93 // Theoretically this function doesn't need to be stable across multiple calls | |
94 // on the same or different clients, but to keep things simple, it probably | |
95 // should be. | |
96 std::string GetStorageKey(const syncer::EntityData& entity_data) override; | |
97 | |
98 // Methods used as callbacks given to DataTypeStore. | |
99 void OnStoreCreated(syncer::ModelTypeStore::Result result, | |
100 std::unique_ptr<syncer::ModelTypeStore> store); | |
101 | |
102 class ScopedBatchUpdate : public ReadingListModelStorage::ScopedBatchUpdate { | |
103 public: | |
104 explicit ScopedBatchUpdate(ReadingListStore* store); | |
105 | |
106 ~ScopedBatchUpdate() override; | |
107 | |
108 private: | |
109 ReadingListStore* store_; | |
110 | |
111 DISALLOW_COPY_AND_ASSIGN(ScopedBatchUpdate); | |
112 }; | |
113 | |
114 private: | |
115 void BeginTransaction(); | |
116 void CommitTransaction(); | |
117 // Callbacks needed for the database handling. | |
118 void OnDatabaseLoad( | |
119 syncer::ModelTypeStore::Result result, | |
120 std::unique_ptr<syncer::ModelTypeStore::RecordList> entries); | |
121 void OnDatabaseSave(syncer::ModelTypeStore::Result result); | |
122 void OnReadAllMetadata(syncer::SyncError sync_error, | |
123 std::unique_ptr<syncer::MetadataBatch> metadata_batch); | |
124 | |
125 void AddEntryToBatch(syncer::MutableDataBatch* batch, | |
126 const ReadingListEntry& entry, | |
127 bool read); | |
128 | |
129 std::unique_ptr<syncer::ModelTypeStore> store_; | |
130 ReadingListModel* model_; | |
131 ReadingListStoreDelegate* delegate_; | |
132 StoreFactoryFunction create_store_callback_; | |
133 | |
134 int pending_transaction_count_; | |
135 std::unique_ptr<syncer::ModelTypeStore::WriteBatch> batch_; | |
136 }; | |
137 | 10 |
138 #endif // IOS_CHROME_BROWSER_READING_LIST_READING_LIST_STORE_H_ | 11 #endif // IOS_CHROME_BROWSER_READING_LIST_READING_LIST_STORE_H_ |
OLD | NEW |