Flutter云数据库访问插件model_fetch_firestore的使用

model_fetch_firestore 是一个用于在 Flutter 应用中访问 Firebase Firestore 数据库的插件。它提供了一种简单的方式来将 Firestore 文档映射到 Dart 对象，并执行 CRUD（创建、读取、更新、删除）操作。

安装插件

首先，你需要在 pubspec.yaml 文件中添加 model_fetch_firestore 依赖：

dependencies:
  flutter:
    sdk: flutter
  model_fetch_firestore: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

配置 Firebase

在使用 model_fetch_firestore 之前，你需要配置 Firebase。如果你还没有配置 Firebase，请按照以下步骤进行配置：

1. 在 Firebase 控制台 中创建一个新的项目。

2. 在 Firebase 控制台中，添加一个新的 Android 或 iOS 应用，并按照提示下载 google-services.json（Android）或 GoogleService-Info.plist（iOS）文件。

3. 将下载的配置文件放在 Flutter 项目的 android/app 目录（Android）或 ios/Runner 目录（iOS）。

4. 在 pubspec.yaml 中添加 firebase_core 和 cloud_firestore 依赖：

   dependencies:
     flutter:
       sdk: flutter
     firebase_core: ^latest_version
     cloud_firestore: ^latest_version
   

5. 在 lib/main.dart 中初始化 Firebase：

   import 'package:firebase_core/firebase_core.dart';
   
   void main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     runApp(MyApp());
   }
   

使用 model_fetch_firestore

1. 创建模型类

首先，你需要创建一个 Dart 类来表示 Firestore 中的文档。例如，假设你有一个 User 集合，每个文档包含 name 和 age 字段：

import 'package:model_fetch_firestore/model_fetch_firestore.dart';

class User extends FirestoreModel {
  String name;
  int age;

  User({
    required String id,
    required this.name,
    required this.age,
  }) : super(id);

  factory User.fromMap(Map<String, dynamic> map, String id) {
    return User(
      id: id,
      name: map['name'],
      age: map['age'],
    );
  }

  [@override](/user/override)
  Map<String, dynamic> toMap() {
    return {
      'name': name,
      'age': age,
    };
  }
}

2. 创建 Firestore 服务类

接下来，你可以创建一个服务类来处理 Firestore 操作：

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:model_fetch_firestore/model_fetch_firestore.dart';

class UserService {
  final CollectionReference usersCollection =
      FirebaseFirestore.instance.collection('users');

  Future<User> getUser(String id) async {
    final doc = await usersCollection.doc(id).get();
    return User.fromMap(doc.data() as Map<String, dynamic>, doc.id);
  }

  Future<void> addUser(User user) async {
    await usersCollection.doc(user.id).set(user.toMap());
  }

  Future<void> updateUser(User user) async {
    await usersCollection.doc(user.id).update(user.toMap());
  }

  Future<void> deleteUser(String id) async {
    await usersCollection.doc(id).delete();
  }

  Stream<List<User>> getUsers() {
    return usersCollection.snapshots().map((snapshot) {
      return snapshot.docs.map((doc) {
        return User.fromMap(doc.data() as Map<String, dynamic>, doc.id);
      }).toList();
    });
  }
}

3. 在 UI 中使用服务类

现在你可以在 Flutter 应用中使用 UserService 来执行 Firestore 操作。例如，获取用户列表并显示：

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Users'),
      ),
      body: StreamBuilder<List<User>>(
        stream: _userService.getUsers(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Center(child: CircularProgressIndicator());
          } else if (snapshot.hasError) {
            return Center(child: Text('Error: ${snapshot.error}'));
          } else if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return Center(child: Text('No users found'));
          } else {
            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('Age: ${user.age}'),
                );
              },
            );
          }
        },
      ),
    );
  }
}