Firestore - 使用缓存直到在线内容更新

Question

我开始使用 Firestore。我已经阅读了有关离线数据持久性的文档和教程，但我不太清楚 Firestore 是否会再次下载数据，即使内容没有被修改。例如，如果我有一个查询，结果将每周更新一次，并且在进行更改之前我不需要应用程序再次下载内容，那么在效率方面编写代码的最佳方式是什么？谢谢！

Answer 1

您想使用 "snapshot listener" API 来收听您的查询： https://firebase.google.com/docs/firestore/query-data/listen#listen_to_multiple_documents_in_a_collection

这里有一些JavaScript作为例子：

db.collection("cities").where("state", "==", "CA")
    .onSnapshot(function(querySnapshot) {
        var cities = [];
        querySnapshot.forEach(function(doc) {
            cities.push(doc.data().name);
        });
        console.log("Current cities in CA: ", cities.join(", "));
    });

第一次附加此侦听器时，Firestore 将访问网络以将所有结果下载到您的查询中，并为您提供查询快照，正如您所期望的那样。

如果您第二次附加同一个侦听器并且您正在使用离线持久性，则侦听器将立即被缓存的结果触发。以下是检测结果是来自缓存还是本地的方法：

db.collection("cities").where("state", "==", "CA")
  .onSnapshot({ includeQueryMetadataChanges: true }, function(snapshot) {
      snapshot.docChanges.forEach(function(change) {
          if (change.type === "added") {
              console.log("New city: ", change.doc.data());
          }

          var source = snapshot.metadata.fromCache ? "local cache" : "server";
          console.log("Data came from " + source);
      });
  });

在您获得缓存结果后，Firestore 会与服务器核对您的查询结果是否有任何变化。如果是，您将获得另一个包含更改的快照。

如果您希望收到仅涉及元数据的更改通知（例如，如果没有文档更改但有 snapshot.metadata.fromCache 更改），您可以在发出查询时使用 QueryListenOptions： https://firebase.google.com/docs/reference/android/com/google/firebase/firestore/QueryListenOptions

Firestore - 使用缓存直到在线内容更新

Firestore - Using cache until online content updates

caching

download

persistence

offline

google-cloud-firestore