Flutter未知功能探索插件dart_super的使用

简介

dart_super 是一个用于Dart的状态管理框架，旨在简化和优化响应式和可扩展应用程序的开发。它提供了诸如响应式状态管理、简单的依赖注入以及直观的测试等功能。

功能特性

• 响应式状态管理：轻松管理应用中的状态变化。
• 简单依赖注入：方便地管理和注入依赖项。
• 直观的测试：提供专用的测试库 super_test 以简化测试过程。

目录

• 功能特性
• 目录
• 开始使用
• 使用方法
  • 计数器应用示例
• Super框架API
  • SuperController
  • SuperModel
• Rx类型
  • RxT
    • RxT子类型
  • RxNotifier
    • 异步状态
  • Rx集合
• 依赖注入
  • of
  • init
  • create
  • delete
  • deleteAll
• 附加信息
  • API参考
• 要求
• 维护者
• 开发者笔记
• 致谢

开始使用

要开始使用 dart_super，首先需要在项目的 pubspec.yaml 文件中添加依赖：

dependencies:
  dart_super:

然后，在 Dart 文件中导入 dart_super 包：

import 'package:dart_super/dart_super.dart';

使用方法

计数器应用示例

以下是一个简单的计数器应用示例，展示了如何使用 dart_super 进行状态管理：

// ignore_for_file: avoid_print
import 'package:dart_super/dart_super.dart';

void main() {
  Super.activate(); // 激活 Super 框架

  // 声明一个状态对象
  final count = 0.rx;

  // 每次状态变化时调用的方法
  rxWatch(() => print(count.state), stopWhen: () => count.state > 3);

  // 增加状态值
  count.state++; // 打印 '1'
  count.state++; // 打印 '2'
  count.state++; // 打印 '3'
  count.state++; // 不打印
}

在这个例子中，我们通过 rxWatch 方法监听 count 状态的变化，并在每次状态变化时执行回调函数。当 count 的值超过 3 时，停止监听。

Super框架API

SuperController

SuperController 是一个混入类，为控制器提供生命周期管理。你可以通过重写其生命周期方法来初始化资源、处理事件和清理资源。

class SampleController extends SuperController {
  final _count = 0.rx;
  final _loading = false.rx;

  int get count => _count.state;
  bool get loading => _loading.state;

  void increment() {
    _count.state++;
  }

  void toggleLoading() {
    _loading.state = !_loading.state;
  }

  @override
  void onDisable() {
    _count.dispose();
    _loading.dispose();
    super.onDisable();
  }
}

SuperModel

SuperModel 提供了类之间的值相等性检查。继承自 SuperModel 的类需要实现 props getter，返回用于相等性检查的属性列表。

class UserModel with SuperModel {
  UserModel(this.id, this.name);

  final int id;
  final String name;

  @override
  List<Object> get props => [id, name];
}

final _user = UserModel(1, 'Paul').rx;
final user2 = UserModel(1, 'Paul');

_user.state == user2; // true
_user.state = user2; // 不会触发重建

Rx类型

RxT

RxT 是一个泛型反应容器，用于保存和更新类型为 T 的状态，并自动通知监听器。

final _counter = RxT<int>(0);

void increment() {
  _counter.state++;
}

_counter.addListener(() {
  print('Counter changed: ${_counter.state}');
});

_counter.increment(); // 触发监听器并打印更新后的状态

RxNotifier

RxNotifier 是一个抽象基类，用于创建管理类型为 T 的状态的反应通知器。

CounterNotifier get counterNotifier => Super.init(CounterNotifier());

class CounterNotifier extends RxNotifier<int> {
  @override
  int initial() {
    return 0;
  }

  void increment() {
    state++;
  }
}

counterNotifier.addListener(() {
  print('Counter changed: ${counterNotifier.state}');
});

counterNotifier.increment(); // 触发监听器并打印更新后的状态

Rx集合

RxMap、RxSet 和 RxList 是类似于 RxT 的反应集合，它们扩展了 Dart 集合的功能，使其具有反应性。

依赖注入

of

从管理器中检索依赖项实例，并启用继承自 SuperController 的依赖项。

Super.of<T>();

init

初始化并检索依赖项实例，如果不存在则创建新实例。

Super.init<T>(T instance);

create

创建依赖项的单例实例并注册到管理器。

Super.create<T>(T instance);

delete

从管理器中删除依赖项实例。

Super.delete<T>();

deleteAll

删除管理器中的所有依赖项实例。

Super.deleteAll();

附加信息

API参考

更多关于API的信息，请参阅 API文档。

要求

• Dart 3: >= 3.0.0

维护者

• Seyon Anko

开发者笔记

dart_super 致力于构建健壮且可扩展的 Dart 应用程序，同时保持代码的整洁和有序。该框架力求在可读性、文档和易用性方面达到高标准。

致谢

感谢上帝全程指导我完成这个项目。

希望你能够喜欢并轻松上手 dart_super！如果你有任何反馈或改进建议，请随时联系我。祝你编码愉快！

Best regards, DrDejaVu