如何将Firestore的QueryDocumentSnapshot转换为Events列表？

问题 #

我从Firestore获取了一个快照，需要将其转换为Events类型的列表，用于预约界面。以下是Events的数据模型：

String? id;
String? eventName;
DateTime? eventStartTime;
String? eventDuration;
DateTime? eventDate;
String? eventDescription;
String? userId;
String? companyId;

我已编写将DocumentSnapshot转为Events的工厂方法：

factory Events.fromJson(DocumentSnapshot doc) {
    Map data = doc.data() as Map<String, dynamic>;
    return Events(
      id: doc.id,
      eventName: data['eventName'],
      eventStartTime: (data['eventStartTime'] as Timestamp).toDate(),
      eventDuration: data['eventDuration'],
      eventDate: (data['eventDate'] as Timestamp).toDate(),
      eventDescription: data['eventDescription'],
      userId: data['userId'],
      companyId: data['companyId'],
    );
  }

在StreamBuilder中执行转换时出现错误，代码如下：

if (snapshot.connectionState == ConnectionState.waiting) {
                return const Center(child: CircularProgressIndicator());
              } else {
                if (snapshot.hasData && snapshot.data!.docs.isNotEmpty) {
                  List<Events> eventsList =
                      Events.fromJson(snapshot.data) as List<Events>;   <<<< HERE
                  return _buildTableCalendar(eventsList);
                } else {
                  return _buildTableCalendar();
                }
              }

尝试修改后仍出现新错误，请问如何正确将该快照转换为Events列表？

解决方法 #

错误根源 #

你当前的代码错误在于：Events.fromJson是用来转换单个DocumentSnapshot为Events对象的方法，但StreamBuilder中的snapshot.data是QuerySnapshot（包含多个文档的集合快照），直接把整个QuerySnapshot传给fromJson并强转为List<Events>，类型完全不匹配，必然报错。

正确转换方式 #

遍历QuerySnapshot中的docs列表，对每个DocumentSnapshot调用Events.fromJson，将结果收集为List<Events>：

修改StreamBuilder中的转换代码：

if (snapshot.connectionState == ConnectionState.waiting) {
  return const Center(child: CircularProgressIndicator());
} else {
  if (snapshot.hasData && snapshot.data!.docs.isNotEmpty) {
    // 正确遍历所有文档并转换
    List<Events> eventsList = snapshot.data!.docs
        .map((doc) => Events.fromJson(doc))
        .toList();
    return _buildTableCalendar(eventsList);
  } else {
    return _buildTableCalendar();
  }
}

额外优化建议 #

为避免Firestore字段为null导致的崩溃，建议在工厂方法中增加空值判断：

factory Events.fromJson(DocumentSnapshot doc) {
  Map data = doc.data() as Map<String, dynamic>;
  return Events(
    id: doc.id,
    eventName: data['eventName'],
    // 处理Timestamp可能为null的情况
    eventStartTime: data['eventStartTime'] is Timestamp 
        ? (data['eventStartTime'] as Timestamp).toDate() 
        : null,
    eventDuration: data['eventDuration'],
    eventDate: data['eventDate'] is Timestamp 
        ? (data['eventDate'] as Timestamp).toDate() 
        : null,
    eventDescription: data['eventDescription'],
    userId: data['userId'],
    companyId: data['companyId'],
  );
}

内容的提问来源于stack exchange，提问作者LostTexan