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

时间:2017-10-21 22:06:27

标签: caching download persistence offline google-cloud-firestore

我从Firestore开始。我已经阅读了有关离线数据持久性的文档和教程,但我还不清楚Firestore是否会再次下载数据,即使内容尚未被修改。 例如,如果我有一个查询,其结果将每周更新一次,并且我不需要应用程序再次下载内容,直到进行更改,那么编写效果的最佳方式是什么?码? 谢谢!

1 个答案:

答案 0 :(得分:5)

您想使用"快照侦听器"用于收听查询的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更改),您可以在发出查询时使用QueryListenOptionshttps://firebase.google.com/docs/reference/android/com/google/firebase/firestore/QueryListenOptions