FSTRemoteEventTests.mm 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824
  1. /*
  2. * Copyright 2017 Google
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. #import <XCTest/XCTest.h>
  17. #include <memory>
  18. #include <unordered_map>
  19. #include <utility>
  20. #include <vector>
  21. #include "Firestore/core/src/firebase/firestore/local/query_data.h"
  22. #include "Firestore/core/src/firebase/firestore/model/document_key.h"
  23. #include "Firestore/core/src/firebase/firestore/model/types.h"
  24. #include "Firestore/core/src/firebase/firestore/remote/existence_filter.h"
  25. #include "Firestore/core/src/firebase/firestore/remote/remote_event.h"
  26. #include "Firestore/core/src/firebase/firestore/remote/watch_change.h"
  27. #import "Firestore/Example/Tests/Util/FSTHelpers.h"
  28. #include "Firestore/core/test/firebase/firestore/testutil/testutil.h"
  29. #include "absl/memory/memory.h"
  30. namespace core = firebase::firestore::core;
  31. namespace testutil = firebase::firestore::testutil;
  32. using firebase::firestore::local::QueryData;
  33. using firebase::firestore::local::QueryPurpose;
  34. using firebase::firestore::model::Document;
  35. using firebase::firestore::model::DocumentKey;
  36. using firebase::firestore::model::DocumentKeySet;
  37. using firebase::firestore::model::DocumentState;
  38. using firebase::firestore::model::MaybeDocument;
  39. using firebase::firestore::model::NoDocument;
  40. using firebase::firestore::model::SnapshotVersion;
  41. using firebase::firestore::model::TargetId;
  42. using firebase::firestore::nanopb::ByteString;
  43. using firebase::firestore::remote::DocumentWatchChange;
  44. using firebase::firestore::remote::ExistenceFilter;
  45. using firebase::firestore::remote::ExistenceFilterWatchChange;
  46. using firebase::firestore::remote::RemoteEvent;
  47. using firebase::firestore::remote::TargetChange;
  48. using firebase::firestore::remote::TestTargetMetadataProvider;
  49. using firebase::firestore::remote::WatchChange;
  50. using firebase::firestore::remote::WatchChangeAggregator;
  51. using firebase::firestore::remote::WatchTargetChange;
  52. using firebase::firestore::remote::WatchTargetChangeState;
  53. using firebase::firestore::testutil::VectorOfUniquePtrs;
  54. using firebase::firestore::util::MakeString;
  55. using firebase::firestore::util::Status;
  56. using testutil::DeletedDoc;
  57. using testutil::Doc;
  58. using testutil::Map;
  59. using testutil::Query;
  60. NS_ASSUME_NONNULL_BEGIN
  61. namespace {
  62. template <typename... Elems>
  63. std::vector<std::unique_ptr<WatchChange>> Changes(Elems... elems) {
  64. return VectorOfUniquePtrs<WatchChange>(std::move(elems)...);
  65. }
  66. // These helpers work around the fact that `make_unique` cannot deduce the
  67. // desired type (`vector<TargetId>` in this case) from an initialization list
  68. // (e.g., `{1,2}`).
  69. std::unique_ptr<DocumentWatchChange> MakeDocChange(std::vector<TargetId> updated,
  70. std::vector<TargetId> removed,
  71. DocumentKey key,
  72. const MaybeDocument &doc) {
  73. return absl::make_unique<DocumentWatchChange>(std::move(updated), std::move(removed),
  74. std::move(key), doc);
  75. }
  76. std::unique_ptr<WatchTargetChange> MakeTargetChange(WatchTargetChangeState state,
  77. std::vector<TargetId> target_ids) {
  78. return absl::make_unique<WatchTargetChange>(state, std::move(target_ids));
  79. }
  80. std::unique_ptr<WatchTargetChange> MakeTargetChange(WatchTargetChangeState state,
  81. std::vector<TargetId> target_ids,
  82. ByteString token) {
  83. return absl::make_unique<WatchTargetChange>(state, std::move(target_ids), std::move(token));
  84. }
  85. } // namespace
  86. @interface FSTRemoteEventTests : XCTestCase
  87. @end
  88. @implementation FSTRemoteEventTests {
  89. ByteString _resumeToken1;
  90. TestTargetMetadataProvider _targetMetadataProvider;
  91. std::unordered_map<TargetId, int> _noOutstandingResponses;
  92. }
  93. - (void)setUp {
  94. _resumeToken1 = testutil::ResumeToken(7);
  95. }
  96. /**
  97. * Creates a map with query data for the provided target IDs. All targets are considered active
  98. * and query a collection named "coll".
  99. */
  100. - (std::unordered_map<TargetId, QueryData>)queryDataForTargets:
  101. (std::initializer_list<TargetId>)targetIDs {
  102. std::unordered_map<TargetId, QueryData> targets;
  103. for (TargetId targetID : targetIDs) {
  104. core::Query query = Query("coll");
  105. targets[targetID] = QueryData(std::move(query), targetID, 0, QueryPurpose::Listen);
  106. }
  107. return targets;
  108. }
  109. /**
  110. * Creates a map with query data for the provided target IDs. All targets are marked as limbo
  111. * queries for the document at "coll/limbo".
  112. */
  113. - (std::unordered_map<TargetId, QueryData>)queryDataForLimboTargets:
  114. (std::initializer_list<TargetId>)targetIDs {
  115. std::unordered_map<TargetId, QueryData> targets;
  116. for (TargetId targetID : targetIDs) {
  117. core::Query query = Query("coll/limbo");
  118. targets[targetID] = QueryData(std::move(query), targetID, 0, QueryPurpose::LimboResolution);
  119. }
  120. return targets;
  121. }
  122. /**
  123. * Creates an aggregator initialized with the set of provided `WatchChange`s. Tests can add further
  124. * changes via `HandleDocumentChange`, `HandleTargetChange` and `HandleExistenceFilterChange`.
  125. *
  126. * @param targetMap A map of query data for all active targets. The map must include an entry for
  127. * every target referenced by any of the watch changes.
  128. * @param outstandingResponses The number of outstanding ACKs a target has to receive before it is
  129. * considered active, or `_noOutstandingResponses` if all targets are already active.
  130. * @param existingKeys The set of documents that are considered synced with the test targets as
  131. * part of a previous listen. To modify this set during test execution, invoke
  132. * `_targetMetadataProvider.SetSyncedKeys()`.
  133. * @param watchChanges The watch changes to apply before returning the aggregator. Supported
  134. * changes are `DocumentWatchChange` and `WatchTargetChange`.
  135. */
  136. - (WatchChangeAggregator)
  137. aggregatorWithTargetMap:(const std::unordered_map<TargetId, QueryData> &)targetMap
  138. outstandingResponses:(const std::unordered_map<TargetId, int> &)outstandingResponses
  139. existingKeys:(DocumentKeySet)existingKeys
  140. changes:(const std::vector<std::unique_ptr<WatchChange>> &)watchChanges {
  141. WatchChangeAggregator aggregator{&_targetMetadataProvider};
  142. std::vector<TargetId> targetIDs;
  143. for (const auto &kv : targetMap) {
  144. TargetId targetID = kv.first;
  145. const QueryData &queryData = kv.second;
  146. targetIDs.push_back(targetID);
  147. _targetMetadataProvider.SetSyncedKeys(existingKeys, queryData);
  148. };
  149. for (const auto &kv : outstandingResponses) {
  150. TargetId targetID = kv.first;
  151. int count = kv.second;
  152. for (int i = 0; i < count; ++i) {
  153. aggregator.RecordPendingTargetRequest(targetID);
  154. }
  155. }
  156. for (const std::unique_ptr<WatchChange> &change : watchChanges) {
  157. switch (change->type()) {
  158. case WatchChange::Type::Document: {
  159. aggregator.HandleDocumentChange(*static_cast<const DocumentWatchChange *>(change.get()));
  160. break;
  161. }
  162. case WatchChange::Type::TargetChange: {
  163. aggregator.HandleTargetChange(*static_cast<const WatchTargetChange *>(change.get()));
  164. break;
  165. }
  166. default:
  167. HARD_ASSERT("Encountered unexpected type of WatchChange");
  168. }
  169. }
  170. aggregator.HandleTargetChange(
  171. WatchTargetChange{WatchTargetChangeState::NoChange, targetIDs, _resumeToken1});
  172. return aggregator;
  173. }
  174. /**
  175. * Creates a single remote event that includes target changes for all provided `WatchChange`s.
  176. *
  177. * @param snapshotVersion The version at which to create the remote event. This corresponds to the
  178. * snapshot version provided by the NO_CHANGE event.
  179. * @param targetMap A map of query data for all active targets. The map must include an entry for
  180. * every target referenced by any of the watch changes.
  181. * @param outstandingResponses The number of outstanding ACKs a target has to receive before it is
  182. * considered active, or `_noOutstandingResponses` if all targets are already active.
  183. * @param existingKeys The set of documents that are considered synced with the test targets as
  184. * part of a previous listen.
  185. * @param watchChanges The watch changes to apply before creating the remote event. Supported
  186. * changes are `DocumentWatchChange` and `WatchTargetChange`.
  187. */
  188. - (RemoteEvent)
  189. remoteEventAtSnapshotVersion:(FSTTestSnapshotVersion)snapshotVersion
  190. targetMap:(std::unordered_map<TargetId, QueryData>)targetMap
  191. outstandingResponses:(const std::unordered_map<TargetId, int> &)outstandingResponses
  192. existingKeys:(DocumentKeySet)existingKeys
  193. changes:(const std::vector<std::unique_ptr<WatchChange>> &)watchChanges {
  194. WatchChangeAggregator aggregator = [self aggregatorWithTargetMap:targetMap
  195. outstandingResponses:outstandingResponses
  196. existingKeys:existingKeys
  197. changes:watchChanges];
  198. return aggregator.CreateRemoteEvent(testutil::Version(snapshotVersion));
  199. }
  200. - (void)testWillAccumulateDocumentAddedAndRemovedEvents {
  201. // The target map that contains an entry for every target in this test. If a target ID is
  202. // omitted, the target is considered inactive and `TestTargetMetadataProvider` will fail on
  203. // access.
  204. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1, 2, 3, 4, 5, 6}]};
  205. Document existingDoc = Doc("docs/1", 1, Map("value", 1));
  206. auto change1 = MakeDocChange({1, 2, 3}, {4, 5, 6}, existingDoc.key(), existingDoc);
  207. Document newDoc = Doc("docs/2", 2, Map("value", 2));
  208. auto change2 = MakeDocChange({1, 4}, {2, 6}, newDoc.key(), newDoc);
  209. // Create a remote event that includes both `change1` and `change2` as well as a NO_CHANGE event
  210. // with the default resume token (`_resumeToken1`).
  211. // As `existingDoc` is provided as an existing key, any updates to this document will be treated
  212. // as modifications rather than adds.
  213. RemoteEvent event =
  214. [self remoteEventAtSnapshotVersion:3
  215. targetMap:targetMap
  216. outstandingResponses:_noOutstandingResponses
  217. existingKeys:DocumentKeySet{existingDoc.key()}
  218. changes:Changes(std::move(change1), std::move(change2))];
  219. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  220. XCTAssertEqual(event.document_updates().size(), 2);
  221. XCTAssertEqual(event.document_updates().at(existingDoc.key()), existingDoc);
  222. XCTAssertEqual(event.document_updates().at(newDoc.key()), newDoc);
  223. // 'change1' and 'change2' affect six different targets
  224. XCTAssertEqual(event.target_changes().size(), 6);
  225. TargetChange targetChange1{_resumeToken1, false, DocumentKeySet{newDoc.key()},
  226. DocumentKeySet{existingDoc.key()}, DocumentKeySet{}};
  227. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  228. TargetChange targetChange2{_resumeToken1, false, DocumentKeySet{},
  229. DocumentKeySet{existingDoc.key()}, DocumentKeySet{}};
  230. XCTAssertTrue(event.target_changes().at(2) == targetChange2);
  231. TargetChange targetChange3{_resumeToken1, false, DocumentKeySet{},
  232. DocumentKeySet{existingDoc.key()}, DocumentKeySet{}};
  233. XCTAssertTrue(event.target_changes().at(3) == targetChange3);
  234. TargetChange targetChange4{_resumeToken1, false, DocumentKeySet{newDoc.key()}, DocumentKeySet{},
  235. DocumentKeySet{existingDoc.key()}};
  236. XCTAssertTrue(event.target_changes().at(4) == targetChange4);
  237. TargetChange targetChange5{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{},
  238. DocumentKeySet{existingDoc.key()}};
  239. XCTAssertTrue(event.target_changes().at(5) == targetChange5);
  240. TargetChange targetChange6{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{},
  241. DocumentKeySet{existingDoc.key()}};
  242. XCTAssertTrue(event.target_changes().at(6) == targetChange6);
  243. }
  244. - (void)testWillIgnoreEventsForPendingTargets {
  245. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  246. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  247. auto change1 = MakeDocChange({1}, {}, doc1.key(), doc1);
  248. auto change2 = MakeTargetChange(WatchTargetChangeState::Removed, {1});
  249. auto change3 = MakeTargetChange(WatchTargetChangeState::Added, {1});
  250. Document doc2 = Doc("docs/2", 2, Map("value", 2));
  251. auto change4 = MakeDocChange({1}, {}, doc2.key(), doc2);
  252. // We're waiting for the unwatch and watch ack
  253. std::unordered_map<TargetId, int> outstandingResponses{{1, 2}};
  254. RemoteEvent event =
  255. [self remoteEventAtSnapshotVersion:3
  256. targetMap:targetMap
  257. outstandingResponses:outstandingResponses
  258. existingKeys:DocumentKeySet {}
  259. changes:Changes(std::move(change1), std::move(change2),
  260. std::move(change3), std::move(change4))];
  261. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  262. // doc1 is ignored because it was part of an inactive target, but doc2 is in the changes
  263. // because it become active.
  264. XCTAssertEqual(event.document_updates().size(), 1);
  265. XCTAssertEqual(event.document_updates().at(doc2.key()), doc2);
  266. XCTAssertEqual(event.target_changes().size(), 1);
  267. }
  268. - (void)testWillIgnoreEventsForRemovedTargets {
  269. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{}]};
  270. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  271. auto change1 = MakeDocChange({1}, {}, doc1.key(), doc1);
  272. auto change2 = MakeTargetChange(WatchTargetChangeState::Removed, {1});
  273. // We're waiting for the unwatch ack
  274. std::unordered_map<TargetId, int> outstandingResponses{{1, 1}};
  275. RemoteEvent event =
  276. [self remoteEventAtSnapshotVersion:3
  277. targetMap:targetMap
  278. outstandingResponses:outstandingResponses
  279. existingKeys:DocumentKeySet {}
  280. changes:Changes(std::move(change1), std::move(change2))];
  281. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  282. // doc1 is ignored because it was part of an inactive target
  283. XCTAssertEqual(event.document_updates().size(), 0);
  284. // Target 1 is ignored because it was removed
  285. XCTAssertEqual(event.target_changes().size(), 0);
  286. }
  287. - (void)testWillKeepResetMappingEvenWithUpdates {
  288. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  289. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  290. auto change1 = MakeDocChange({1}, {}, doc1.key(), doc1);
  291. // Reset stream, ignoring doc1
  292. auto change2 = MakeTargetChange(WatchTargetChangeState::Reset, {1});
  293. // Add doc2, doc3
  294. Document doc2 = Doc("docs/2", 2, Map("value", 2));
  295. auto change3 = MakeDocChange({1}, {}, doc2.key(), doc2);
  296. Document doc3 = Doc("docs/3", 3, Map("value", 3));
  297. auto change4 = MakeDocChange({1}, {}, doc3.key(), doc3);
  298. // Remove doc2 again, should not show up in reset mapping
  299. auto change5 = MakeDocChange({}, {1}, doc2.key(), doc2);
  300. RemoteEvent event =
  301. [self remoteEventAtSnapshotVersion:3
  302. targetMap:targetMap
  303. outstandingResponses:_noOutstandingResponses
  304. existingKeys:DocumentKeySet{doc1.key()}
  305. changes:Changes(std::move(change1), std::move(change2),
  306. std::move(change3), std::move(change4),
  307. std::move(change5))];
  308. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  309. XCTAssertEqual(event.document_updates().size(), 3);
  310. XCTAssertEqual(event.document_updates().at(doc1.key()), doc1);
  311. XCTAssertEqual(event.document_updates().at(doc2.key()), doc2);
  312. XCTAssertEqual(event.document_updates().at(doc3.key()), doc3);
  313. XCTAssertEqual(event.target_changes().size(), 1);
  314. // Only doc3 is part of the new mapping
  315. TargetChange expectedChange{_resumeToken1, false, DocumentKeySet{doc3.key()}, DocumentKeySet{},
  316. DocumentKeySet{doc1.key()}};
  317. XCTAssertTrue(event.target_changes().at(1) == expectedChange);
  318. }
  319. - (void)testWillHandleSingleReset {
  320. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  321. // Reset target
  322. WatchTargetChange change{WatchTargetChangeState::Reset, {1}};
  323. WatchChangeAggregator aggregator = [self aggregatorWithTargetMap:targetMap
  324. outstandingResponses:_noOutstandingResponses
  325. existingKeys:DocumentKeySet {}
  326. changes:{}];
  327. aggregator.HandleTargetChange(change);
  328. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  329. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  330. XCTAssertEqual(event.document_updates().size(), 0);
  331. XCTAssertEqual(event.target_changes().size(), 1);
  332. // Reset mapping is empty
  333. TargetChange expectedChange{ByteString(), false, DocumentKeySet{}, DocumentKeySet{},
  334. DocumentKeySet{}};
  335. XCTAssertTrue(event.target_changes().at(1) == expectedChange);
  336. }
  337. - (void)testWillHandleTargetAddAndRemovalInSameBatch {
  338. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1, 2}]};
  339. Document doc1a = Doc("docs/1", 1, Map("value", 1));
  340. auto change1 = MakeDocChange({1}, {2}, doc1a.key(), doc1a);
  341. Document doc1b = Doc("docs/1", 1, Map("value", 2));
  342. auto change2 = MakeDocChange({2}, {1}, doc1b.key(), doc1b);
  343. RemoteEvent event =
  344. [self remoteEventAtSnapshotVersion:3
  345. targetMap:targetMap
  346. outstandingResponses:_noOutstandingResponses
  347. existingKeys:DocumentKeySet{doc1a.key()}
  348. changes:Changes(std::move(change1), std::move(change2))];
  349. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  350. XCTAssertEqual(event.document_updates().size(), 1);
  351. XCTAssertEqual(event.document_updates().at(doc1b.key()), doc1b);
  352. XCTAssertEqual(event.target_changes().size(), 2);
  353. TargetChange targetChange1{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{},
  354. DocumentKeySet{doc1b.key()}};
  355. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  356. TargetChange targetChange2{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{doc1b.key()},
  357. DocumentKeySet{}};
  358. XCTAssertTrue(event.target_changes().at(2) == targetChange2);
  359. }
  360. - (void)testTargetCurrentChangeWillMarkTheTargetCurrent {
  361. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  362. auto change = MakeTargetChange(WatchTargetChangeState::Current, {1}, _resumeToken1);
  363. RemoteEvent event = [self remoteEventAtSnapshotVersion:3
  364. targetMap:targetMap
  365. outstandingResponses:_noOutstandingResponses
  366. existingKeys:DocumentKeySet {}
  367. changes:Changes(std::move(change))];
  368. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  369. XCTAssertEqual(event.document_updates().size(), 0);
  370. XCTAssertEqual(event.target_changes().size(), 1);
  371. TargetChange targetChange1{_resumeToken1, true, DocumentKeySet{}, DocumentKeySet{},
  372. DocumentKeySet{}};
  373. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  374. }
  375. - (void)testTargetAddedChangeWillResetPreviousState {
  376. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1, 3}]};
  377. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  378. auto change1 = MakeDocChange({1, 3}, {2}, doc1.key(), doc1);
  379. auto change2 = MakeTargetChange(WatchTargetChangeState::Current, {1, 2, 3}, _resumeToken1);
  380. auto change3 = MakeTargetChange(WatchTargetChangeState::Removed, {1});
  381. auto change4 = MakeTargetChange(WatchTargetChangeState::Removed, {2});
  382. auto change5 = MakeTargetChange(WatchTargetChangeState::Added, {1});
  383. Document doc2 = Doc("docs/2", 2, Map("value", 2));
  384. auto change6 = MakeDocChange({1}, {3}, doc2.key(), doc2);
  385. std::unordered_map<TargetId, int> outstandingResponses{{1, 2}, {2, 1}};
  386. RemoteEvent event =
  387. [self remoteEventAtSnapshotVersion:3
  388. targetMap:targetMap
  389. outstandingResponses:outstandingResponses
  390. existingKeys:DocumentKeySet{doc2.key()}
  391. changes:Changes(std::move(change1), std::move(change2),
  392. std::move(change3), std::move(change4),
  393. std::move(change5), std::move(change6))];
  394. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  395. XCTAssertEqual(event.document_updates().size(), 2);
  396. XCTAssertEqual(event.document_updates().at(doc1.key()), doc1);
  397. XCTAssertEqual(event.document_updates().at(doc2.key()), doc2);
  398. // target 1 and 3 are affected (1 because of re-add), target 2 is not because of remove
  399. XCTAssertEqual(event.target_changes().size(), 2);
  400. // doc1 was before the remove, so it does not show up in the mapping.
  401. // Current was before the remove.
  402. TargetChange targetChange1{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{doc2.key()},
  403. DocumentKeySet{}};
  404. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  405. // Doc1 was before the remove
  406. // Current was before the remove
  407. TargetChange targetChange3{_resumeToken1, true, DocumentKeySet{doc1.key()}, DocumentKeySet{},
  408. DocumentKeySet{doc2.key()}};
  409. XCTAssertTrue(event.target_changes().at(3) == targetChange3);
  410. }
  411. - (void)testNoChangeWillStillMarkTheAffectedTargets {
  412. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  413. WatchChangeAggregator aggregator = [self aggregatorWithTargetMap:targetMap
  414. outstandingResponses:_noOutstandingResponses
  415. existingKeys:DocumentKeySet {}
  416. changes:{}];
  417. WatchTargetChange change{WatchTargetChangeState::NoChange, {1}, _resumeToken1};
  418. aggregator.HandleTargetChange(change);
  419. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  420. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  421. XCTAssertEqual(event.document_updates().size(), 0);
  422. XCTAssertEqual(event.target_changes().size(), 1);
  423. TargetChange targetChange{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{},
  424. DocumentKeySet{}};
  425. XCTAssertTrue(event.target_changes().at(1) == targetChange);
  426. }
  427. - (void)testExistenceFilterMismatchClearsTarget {
  428. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1, 2}]};
  429. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  430. auto change1 = MakeDocChange({1}, {}, doc1.key(), doc1);
  431. Document doc2 = Doc("docs/2", 2, Map("value", 2));
  432. auto change2 = MakeDocChange({1}, {}, doc2.key(), doc2);
  433. auto change3 = MakeTargetChange(WatchTargetChangeState::Current, {1}, _resumeToken1);
  434. WatchChangeAggregator aggregator = [self
  435. aggregatorWithTargetMap:targetMap
  436. outstandingResponses:_noOutstandingResponses
  437. existingKeys:DocumentKeySet{doc1.key(), doc2.key()}
  438. changes:Changes(std::move(change1), std::move(change2), std::move(change3))];
  439. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  440. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  441. XCTAssertEqual(event.document_updates().size(), 2);
  442. XCTAssertEqual(event.document_updates().at(doc1.key()), doc1);
  443. XCTAssertEqual(event.document_updates().at(doc2.key()), doc2);
  444. XCTAssertEqual(event.target_changes().size(), 2);
  445. TargetChange targetChange1{_resumeToken1, true, DocumentKeySet{},
  446. DocumentKeySet{doc1.key(), doc2.key()}, DocumentKeySet{}};
  447. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  448. TargetChange targetChange2{_resumeToken1, false, DocumentKeySet{}, DocumentKeySet{},
  449. DocumentKeySet{}};
  450. XCTAssertTrue(event.target_changes().at(2) == targetChange2);
  451. // The existence filter mismatch will remove the document from target 1,
  452. // but not synthesize a document delete.
  453. ExistenceFilterWatchChange change4{ExistenceFilter{1}, 1};
  454. aggregator.HandleExistenceFilter(change4);
  455. event = aggregator.CreateRemoteEvent(testutil::Version(4));
  456. TargetChange targetChange3{ByteString(), false, DocumentKeySet{}, DocumentKeySet{},
  457. DocumentKeySet{doc1.key(), doc2.key()}};
  458. XCTAssertTrue(event.target_changes().at(1) == targetChange3);
  459. XCTAssertEqual(event.target_changes().size(), 1);
  460. XCTAssertEqual(event.target_mismatches().size(), 1);
  461. XCTAssertEqual(event.document_updates().size(), 0);
  462. }
  463. - (void)testExistenceFilterMismatchRemovesCurrentChanges {
  464. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  465. WatchChangeAggregator aggregator = [self aggregatorWithTargetMap:targetMap
  466. outstandingResponses:_noOutstandingResponses
  467. existingKeys:DocumentKeySet {}
  468. changes:{}];
  469. WatchTargetChange markCurrent{WatchTargetChangeState::Current, {1}, _resumeToken1};
  470. aggregator.HandleTargetChange(markCurrent);
  471. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  472. DocumentWatchChange addDoc{{1}, {}, doc1.key(), doc1};
  473. aggregator.HandleDocumentChange(addDoc);
  474. // The existence filter mismatch will remove the document from target 1, but not synthesize a
  475. // document delete.
  476. ExistenceFilterWatchChange existenceFilter{ExistenceFilter{0}, 1};
  477. aggregator.HandleExistenceFilter(existenceFilter);
  478. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  479. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  480. XCTAssertEqual(event.document_updates().size(), 1);
  481. XCTAssertEqual(event.target_mismatches().size(), 1);
  482. XCTAssertEqual(event.document_updates().at(doc1.key()), doc1);
  483. XCTAssertEqual(event.target_changes().size(), 1);
  484. TargetChange targetChange1{ByteString(), false, DocumentKeySet{}, DocumentKeySet{},
  485. DocumentKeySet{}};
  486. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  487. }
  488. - (void)testDocumentUpdate {
  489. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  490. Document doc1 = Doc("docs/1", 1, Map("value", 1));
  491. auto change1 = MakeDocChange({1}, {}, doc1.key(), doc1);
  492. Document doc2 = Doc("docs/2", 2, Map("value", 2));
  493. auto change2 = MakeDocChange({1}, {}, doc2.key(), doc2);
  494. WatchChangeAggregator aggregator =
  495. [self aggregatorWithTargetMap:targetMap
  496. outstandingResponses:_noOutstandingResponses
  497. existingKeys:DocumentKeySet {}
  498. changes:Changes(std::move(change1), std::move(change2))];
  499. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  500. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  501. XCTAssertEqual(event.document_updates().size(), 2);
  502. XCTAssertEqual(event.document_updates().at(doc1.key()), doc1);
  503. XCTAssertEqual(event.document_updates().at(doc2.key()), doc2);
  504. _targetMetadataProvider.SetSyncedKeys(DocumentKeySet{doc1.key(), doc2.key()}, targetMap[1]);
  505. NoDocument deletedDoc1 = DeletedDoc(doc1.key(), 3);
  506. DocumentWatchChange change3{{}, {1}, deletedDoc1.key(), deletedDoc1};
  507. aggregator.HandleDocumentChange(change3);
  508. Document updatedDoc2 = Doc("docs/2", 3, Map("value", 2));
  509. DocumentWatchChange change4{{1}, {}, updatedDoc2.key(), updatedDoc2};
  510. aggregator.HandleDocumentChange(change4);
  511. Document doc3 = Doc("docs/3", 3, Map("value", 3));
  512. DocumentWatchChange change5{{1}, {}, doc3.key(), doc3};
  513. aggregator.HandleDocumentChange(change5);
  514. event = aggregator.CreateRemoteEvent(testutil::Version(3));
  515. XCTAssertEqual(event.snapshot_version(), testutil::Version(3));
  516. XCTAssertEqual(event.document_updates().size(), 3);
  517. // doc1 is replaced
  518. XCTAssertEqual(event.document_updates().at(doc1.key()), deletedDoc1);
  519. // doc2 is updated
  520. XCTAssertEqual(event.document_updates().at(doc2.key()), updatedDoc2);
  521. // doc3 is new
  522. XCTAssertEqual(event.document_updates().at(doc3.key()), doc3);
  523. // Target is unchanged
  524. XCTAssertEqual(event.target_changes().size(), 1);
  525. TargetChange targetChange1{_resumeToken1, false, DocumentKeySet{doc3.key()},
  526. DocumentKeySet{updatedDoc2.key()}, DocumentKeySet{deletedDoc1.key()}};
  527. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  528. }
  529. - (void)testResumeTokensHandledPerTarget {
  530. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1, 2}]};
  531. WatchChangeAggregator aggregator = [self aggregatorWithTargetMap:targetMap
  532. outstandingResponses:_noOutstandingResponses
  533. existingKeys:DocumentKeySet {}
  534. changes:{}];
  535. WatchTargetChange change1{WatchTargetChangeState::Current, {1}, _resumeToken1};
  536. aggregator.HandleTargetChange(change1);
  537. ByteString resumeToken2 = testutil::ResumeToken(7);
  538. WatchTargetChange change2{WatchTargetChangeState::Current, {2}, resumeToken2};
  539. aggregator.HandleTargetChange(change2);
  540. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  541. XCTAssertEqual(event.target_changes().size(), 2);
  542. TargetChange targetChange1{_resumeToken1, true, DocumentKeySet{}, DocumentKeySet{},
  543. DocumentKeySet{}};
  544. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  545. TargetChange targetChange2{resumeToken2, true, DocumentKeySet{}, DocumentKeySet{},
  546. DocumentKeySet{}};
  547. XCTAssertTrue(event.target_changes().at(2) == targetChange2);
  548. }
  549. - (void)testLastResumeTokenWins {
  550. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1, 2}]};
  551. WatchChangeAggregator aggregator = [self aggregatorWithTargetMap:targetMap
  552. outstandingResponses:_noOutstandingResponses
  553. existingKeys:DocumentKeySet {}
  554. changes:{}];
  555. WatchTargetChange change1{WatchTargetChangeState::Current, {1}, _resumeToken1};
  556. aggregator.HandleTargetChange(change1);
  557. ByteString resumeToken2 = testutil::ResumeToken(2);
  558. WatchTargetChange change2{WatchTargetChangeState::NoChange, {1}, resumeToken2};
  559. aggregator.HandleTargetChange(change2);
  560. ByteString resumeToken3 = testutil::ResumeToken(3);
  561. WatchTargetChange change3{WatchTargetChangeState::NoChange, {2}, resumeToken3};
  562. aggregator.HandleTargetChange(change3);
  563. RemoteEvent event = aggregator.CreateRemoteEvent(testutil::Version(3));
  564. XCTAssertEqual(event.target_changes().size(), 2);
  565. TargetChange targetChange1{resumeToken2, true, DocumentKeySet{}, DocumentKeySet{},
  566. DocumentKeySet{}};
  567. XCTAssertTrue(event.target_changes().at(1) == targetChange1);
  568. TargetChange targetChange2{resumeToken3, false, DocumentKeySet{}, DocumentKeySet{},
  569. DocumentKeySet{}};
  570. XCTAssertTrue(event.target_changes().at(2) == targetChange2);
  571. }
  572. - (void)testSynthesizeDeletes {
  573. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForLimboTargets:{1}]};
  574. DocumentKey limboKey = testutil::Key("coll/limbo");
  575. auto resolveLimboTarget = MakeTargetChange(WatchTargetChangeState::Current, {1});
  576. RemoteEvent event = [self remoteEventAtSnapshotVersion:3
  577. targetMap:targetMap
  578. outstandingResponses:_noOutstandingResponses
  579. existingKeys:DocumentKeySet {}
  580. changes:Changes(std::move(resolveLimboTarget))];
  581. NoDocument expected(limboKey, event.snapshot_version(), /* has_committed_mutations= */ false);
  582. XCTAssertEqual(event.document_updates().at(limboKey), expected);
  583. XCTAssertTrue(event.limbo_document_changes().contains(limboKey));
  584. }
  585. - (void)testDoesntSynthesizeDeletesForWrongState {
  586. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{1}]};
  587. auto wrongState = MakeTargetChange(WatchTargetChangeState::NoChange, {1});
  588. RemoteEvent event = [self remoteEventAtSnapshotVersion:3
  589. targetMap:targetMap
  590. outstandingResponses:_noOutstandingResponses
  591. existingKeys:DocumentKeySet {}
  592. changes:Changes(std::move(wrongState))];
  593. XCTAssertEqual(event.document_updates().size(), 0);
  594. XCTAssertEqual(event.limbo_document_changes().size(), 0);
  595. }
  596. - (void)testDoesntSynthesizeDeletesForExistingDoc {
  597. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForTargets:{3}]};
  598. auto hasDocument = MakeTargetChange(WatchTargetChangeState::Current, {3});
  599. RemoteEvent event =
  600. [self remoteEventAtSnapshotVersion:3
  601. targetMap:targetMap
  602. outstandingResponses:_noOutstandingResponses
  603. existingKeys:DocumentKeySet{FSTTestDocKey(@"coll/limbo")}
  604. changes:Changes(std::move(hasDocument))];
  605. XCTAssertEqual(event.document_updates().size(), 0);
  606. XCTAssertEqual(event.limbo_document_changes().size(), 0);
  607. }
  608. - (void)testSeparatesDocumentUpdates {
  609. std::unordered_map<TargetId, QueryData> targetMap{[self queryDataForLimboTargets:{1}]};
  610. Document newDoc = Doc("docs/new", 1, Map("key", "value"));
  611. auto newDocChange = MakeDocChange({1}, {}, newDoc.key(), newDoc);
  612. Document existingDoc = Doc("docs/existing", 1, Map("some", "data"));
  613. auto existingDocChange = MakeDocChange({1}, {}, existingDoc.key(), existingDoc);
  614. NoDocument deletedDoc = DeletedDoc("docs/deleted", 1);
  615. auto deletedDocChange = MakeDocChange({}, {1}, deletedDoc.key(), deletedDoc);
  616. NoDocument missingDoc = DeletedDoc("docs/missing", 1);
  617. auto missingDocChange = MakeDocChange({}, {1}, missingDoc.key(), missingDoc);
  618. RemoteEvent event = [self
  619. remoteEventAtSnapshotVersion:3
  620. targetMap:targetMap
  621. outstandingResponses:_noOutstandingResponses
  622. existingKeys:DocumentKeySet{existingDoc.key(), deletedDoc.key()}
  623. changes:Changes(std::move(newDocChange), std::move(existingDocChange),
  624. std::move(deletedDocChange),
  625. std::move(missingDocChange))];
  626. TargetChange targetChange2{_resumeToken1, false, DocumentKeySet{newDoc.key()},
  627. DocumentKeySet{existingDoc.key()}, DocumentKeySet{deletedDoc.key()}};
  628. XCTAssertTrue(event.target_changes().at(1) == targetChange2);
  629. }
  630. - (void)testTracksLimboDocuments {
  631. std::unordered_map<TargetId, QueryData> targetMap = [self queryDataForTargets:{1}];
  632. auto additionalTargets = [self queryDataForLimboTargets:{2}];
  633. targetMap.insert(additionalTargets.begin(), additionalTargets.end());
  634. // Add 3 docs: 1 is limbo and non-limbo, 2 is limbo-only, 3 is non-limbo
  635. Document doc1 = Doc("docs/1", 1, Map("key", "value"));
  636. Document doc2 = Doc("docs/2", 1, Map("key", "value"));
  637. Document doc3 = Doc("docs/3", 1, Map("key", "value"));
  638. // Target 2 is a limbo target
  639. auto docChange1 = MakeDocChange({1, 2}, {}, doc1.key(), doc1);
  640. auto docChange2 = MakeDocChange({2}, {}, doc2.key(), doc2);
  641. auto docChange3 = MakeDocChange({1}, {}, doc3.key(), doc3);
  642. auto targetsChange = MakeTargetChange(WatchTargetChangeState::Current, {1, 2});
  643. RemoteEvent event =
  644. [self remoteEventAtSnapshotVersion:3
  645. targetMap:targetMap
  646. outstandingResponses:_noOutstandingResponses
  647. existingKeys:DocumentKeySet {}
  648. changes:Changes(std::move(docChange1), std::move(docChange2),
  649. std::move(docChange3), std::move(targetsChange))];
  650. DocumentKeySet limboDocChanges = event.limbo_document_changes();
  651. // Doc1 is in both limbo and non-limbo targets, therefore not tracked as limbo
  652. XCTAssertFalse(limboDocChanges.contains(doc1.key()));
  653. // Doc2 is only in the limbo target, so is tracked as a limbo document
  654. XCTAssertTrue(limboDocChanges.contains(doc2.key()));
  655. // Doc3 is only in the non-limbo target, therefore not tracked as limbo
  656. XCTAssertFalse(limboDocChanges.contains(doc3.key()));
  657. }
  658. @end
  659. NS_ASSUME_NONNULL_END