将Firestore文档转换为对象映射

在 Flutter 中，使用 Cloud Firestore 时，通常需要将 Firestore 文档转换为 Dart 对象。为了实现这一点，您可以创建一个模型类，并在该类中定义一个从 Firestore 文档转换为对象的方法。以下是一个完整的示例，展示如何将 Firestore 文档转换为 Dart 对象。

步骤 1: 添加依赖

确保在 pubspec.yaml 文件中添加了 cloud_firestore 依赖：

dependencies:
  flutter:
    sdk: flutter
  cloud_firestore: ^3.1.5  # 请检查最新版本

步骤 2: 创建模型类

创建一个 Dart 类来表示 Firestore 文档。例如，假设我们有一个用户模型：

class User {
  final String id;
  final String name;
  final String email;

  User({required this.id, required this.name, required this.email});

  // 从 Firestore 文档创建 User 对象
  factory User.fromFirestore(Map<String, dynamic> data, String documentId) {
    return User(
      id: documentId,
      name: data['name'] ?? '',
      email: data['email'] ?? '',
    );
  }

  // 将 User 对象转换为 Map，用于存储到 Firestore
  Map<String, dynamic> toFirestore() {
    return {
      'name': name,
      'email': email,
    };
  }
}

步骤 3: 从 Firestore 获取数据并转换为对象

在您的 Flutter 应用中，您可以使用 Firestore 的 API 来获取文档，并将其转换为 User 对象。以下是一个示例：

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

class UserService {
  final FirebaseFirestore _firestore = FirebaseFirestore.instance;

  // 获取用户列表
  Future<List<User>> getUsers() async {
    QuerySnapshot snapshot = await _firestore.collection('users').get();
    return snapshot.docs.map((doc) {
      return User.fromFirestore(doc.data() as Map<String, dynamic>, doc.id);
    }).toList();
  }
}

class UserListScreen extends StatelessWidget {
  final UserService userService = UserService();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('用户列表')),
      body: FutureBuilder<List<User>>(
        future: userService.getUsers(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Center(child: CircularProgressIndicator());
          } else if (snapshot.hasError) {
            return Center(child: Text('发生错误: ${snapshot.error}'));
          } else if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return Center(child: Text('没有用户'));
          }

          final users = snapshot.data!;

          return ListView.builder(
            itemCount: users.length,
            itemBuilder: (context, index) {
              final user = users[index];
              return ListTile(
                title: Text(user.name),
                subtitle: Text(user.email),
              );
            },
          );
        },
      ),
    );
  }
}

代码解释

模型类：User 类包含了用户的属性，并提供了从 Firestore 文档创建对象的工厂构造函数 fromFirestore 和将对象转换为 Map 的 toFirestore 方法。
服务类：UserService 类包含了一个方法 getUsers，用于从 Firestore 获取用户数据并将其转换为 User 对象列表。
UI 组件：UserListScreen 是一个简单的界面，使用 FutureBuilder 来异步加载用户数据并显示在列表中。