Firestore-DocumentSnapshot和QueryDocumentSnapshot之间的区别

Question

文件上说

QueryDocumentSnapshot包含作为查询的一部分从Firest数据库中的文档中读取的数据。该文档保证存在，并且可以使用getData（）或get（）方法提取其数据。

QueryDocumentSnapshot提供与DocumentSnapshot相同的API曲面。由于查询结果仅包含现有文档，因此存在（）方法将始终返回true并且getData（）永远不会为空。

https://firebase.google.com/docs/reference/android/com/google/firebase/firestore/QueryDocumentSnapshot

但这并不能解释我什么时候应该用一个来代替另一个。我在一个集合的SnapshotListener中尝试了这两种方法，都奏效了。

protected void onStart() {
    super.onStart();
    notebookRef.addSnapshotListener(new EventListener<QuerySnapshot>() {
        @Override
        public void onEvent(QuerySnapshot queryDocumentSnapshots, FirebaseFirestoreException e) {
            if (e != null) {
                Toast.makeText(MainActivity.this, "Error while loading!", Toast.LENGTH_SHORT).show();
                Log.d(TAG, e.toString());
                return;
            }

            String allNotes = "";

            for (QueryDocumentSnapshot documentSnapshot : queryDocumentSnapshots) {


                Note note = documentSnapshot.toObject(Note.class);

                String title = note.getTitle();
                String description = note.getDescription();

                allNotes += "\nTitle: " + title + " Description: " + description;

            }

            textViewData.setText(allNotes);
        }
    });
}

Answer 1

正如你所说：

QueryDocumentSnapshot提供与DocumentSnapshot相同的API表面

这是因为QueryDocumentSnapshot是DocumentSnapshot的子类。这意味着每个QueryDocumentSnapshot都可以分配（向下转换）给DocumentSnapshot类型的变量。它们做完全相同的事情，除了您声明的它们之间的区别：

由于查询结果只包含现有文档，exists（）方法将始终返回true，getData（）永远不会为null。

因此，如果您正在处理QueryDocumentSnapshot，那么可以保证exists（）方法将返回什么。如果您处理的是DocumenSnapshot（实际上不是一个被降级的QueryDocumentSnapshot），那么您就没有这个保证。

我想你可能太看重一个是另一个的子类这一事实了。只需使用您在API文档中看到的类型，不要将任何内容强制转换为其他类型，除非您确实知道需要这样做。