Flutter基础数据管理工具插件base_data的使用

Library for manage general repositories.

使用方法

仅使用API实现

以下是一个示例，展示如何通过API实现来管理数据。

// 导入base_data库
import 'package:base_data/base_data.dart';

// 定义一个混合类，继承自GetAllApiSource<User>
mixin UsersApiSource on GetAllApiSource<User> {}

// 定义一个存储适配器类，继承自GetAllRepositoryAdapter<User>
class UsersRepositoryAdapter with GetAllRepositoryAdapter<User> {
  // 注入API源
  final UsersApiSource apiSource;

  // 构造函数
  UsersRepositoryAdapter(this.apiSource);
}

同时使用API和数据库实现

以下是一个示例，展示如何同时通过API和数据库实现来管理数据。

// 导入base_data库
import 'package:base_data/base_data.dart';

// 定义一个混合类，继承自GetAllApiSource<User>
mixin UsersApiSource on GetAllApiSource<User> {}

// 定义一个混合类，继承自PutAllDbSource<User>
mixin UsersDbSource on PutAllDbSource<User> {}

// 定义一个存储适配器类，继承自StorageGetAllRepositoryAdapter<User>
class UsersRepositoryAdapter with StorageGetAllRepositoryAdapter<User> {
  // 注入API源
  final UsersApiSource apiSource;

  // 注入数据库源
  final UsersDbSource dbSource;

  // 构造函数
  UsersRepositoryAdapter(this.apiSource, this.dbSource);
}

完整示例Demo

以下是一个完整的示例，展示如何在Flutter项目中使用base_data插件进行基础数据管理。

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

// 定义用户模型
class User {
  final String id;
  final String name;

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

// 定义API源
mixin UsersApiSource on GetAllApiSource<User> {
  @override
  Future<List<User>> getAll() async {
    // 模拟从API获取数据
    return [
      User(id: "1", name: "Alice"),
      User(id: "2", name: "Bob"),
    ];
  }
}

// 定义数据库源
mixin UsersDbSource on PutAllDbSource<User> {
  @override
  Future<void> putAll(List<User> users) async {
    // 模拟将数据写入数据库
    print("Data written to database: $users");
  }
}

// 定义存储适配器
class UsersRepositoryAdapter with StorageGetAllRepositoryAdapter<User> {
  final UsersApiSource apiSource;
  final UsersDbSource dbSource;

  UsersRepositoryAdapter(this.apiSource, this.dbSource);

  // 获取所有用户
  Future<List<User>> getAllUsers() async {
    // 从API获取数据
    List<User> users = await apiSource.getAll();

    // 将数据写入数据库
    await dbSource.putAll(users);

    return users;
  }
}

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("base_data插件使用示例"),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 初始化API源和数据库源
              UsersApiSource apiSource = UsersApiSource();
              UsersDbSource dbSource = UsersDbSource();

              // 初始化存储适配器
              UsersRepositoryAdapter repository =
                  UsersRepositoryAdapter(apiSource, dbSource);

              // 调用方法获取用户数据
              List<User> users = await repository.getAllUsers();

              // 打印结果
              print("Fetched Users: $users");
            },
            child: Text("获取用户数据"),
          ),
        ),
      ),
    );
  }
}

运行效果

运行上述代码后，点击按钮会触发以下操作：

1. 从API获取用户数据。
2. 将数据写入数据库。
3. 打印获取到的用户数据。

输出示例：

Data written to database: [Instance of 'User', Instance of 'User']
Fetched Users: [Instance of 'User', Instance of 'User']