Flutter状态管理插件blowe_bloc的使用

blowe_bloc 是一个高级的Flutter状态管理和业务逻辑组件包，扩展自 flutter_bloc。它提供了一整套工具来简化复杂应用程序的开发，具有清晰的关注点分离、高效的状态管理和增强的UI组件。

主要特性

高级BLoC组件

• BloweLoadBloc: 用于处理数据加载操作。
• BloweWatchBloc: 用于处理实时数据更新。
• BlowePaginationBloc: 用于处理分页数据。

高级搜索功能

• BloweSearchBloc: 管理搜索操作，包括添加、移除和清除搜索历史。
• BloweSearchDelegate: 处理搜索功能的UI方面，支持自动历史管理和防抖支持。

综合模型

• BloweNoParams: 无需参数的操作。
• BlowePaginationModel: 管理分页数据。
• BloweSerializableItem: 序列化项目。
• BloweSearchParams: 搜索参数处理。

反应式小部件

• BloweBlocButton: 根据BLoC状态启用按钮。
• BloweBlocListener: 监听BLoC状态变化并触发相应的回调函数。
• BloweBlocSelector: 根据BLoC状态重建小部件。
• BloweMultiBlocSelector: 监控多个BLoCs并根据其状态启用小部件。
• BlowePaginationListView: 显示分页列表，并处理加载、错误和完成状态。

表单字段小部件

• BloweTextFormField: 支持文本输入验证。
• BloweDropdownButtonFormField: 支持下拉选择框。
• BloweBoolFormListTile: 支持开关或复选框。
• BloweRadiusForm: 管理一组半径选项。
• BloweNumberFormListTile: 数字选择器。

无缝集成

• 基于 flutter_bloc 构建，易于集成到现有Flutter项目中。

错误处理

• 提供强大的错误处理机制，确保应用的健壮性。

示例Demo

以下是一个完整的示例，展示了如何使用 blowe_bloc 包中的不同组件：

main.dart

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Blowe Bloc Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final MyBloweLoadBloc _loadBloc = MyBloweLoadBloc();
  final MyBloweWatchBloc _watchBloc = MyBloweWatchBloc();
  final MyBlowePaginationBloc _paginationBloc = MyBlowePaginationBloc();

  @override
  void dispose() {
    _loadBloc.close();
    _watchBloc.close();
    _paginationBloc.close();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Blowe Bloc Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            BloweBlocButton<MyBloweLoadBloc, ElevatedButton>(
              text: 'Load Data',
              onPressed: () {
                _loadBloc.fetch(const BloweNoParams());
              },
            ),
            SizedBox(height: 20),
            BloweBlocListener<MyBloweLoadBloc, String>(
              onCompleted: (context, state) {
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text(state)),
                );
              },
              onError: (context, state) {
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Error: $state')),
                );
              },
              onLoading: (context, state) {
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Loading...')),
                );
              },
              child: Container(),
            ),
            SizedBox(height: 20),
            BloweBlocSelector<MyBloweLoadBloc>(
              builder: (context, enabled) {
                return FloatingActionButton(
                  onPressed: enabled
                      ? () {
                          _loadBloc.fetch(const BloweNoParams());
                        }
                      : null,
                  child: const Icon(Icons.add),
                );
              },
            ),
            SizedBox(height: 20),
            BlowePaginationListView<MyBlowePaginationBloc, String, BloweNoParams, dynamic>(
              itemBuilder: (context, item) => ListTile(
                title: Text(item),
              ),
              paramsProvider: () => const BloweNoParams(),
              emptyWidget: Center(child: Text('No items found')),
              padding: EdgeInsets.all(8.0),
            ),
          ],
        ),
      ),
    );
  }
}

class MyBloweLoadBloc extends BloweLoadBloc<String, BloweNoParams> {
  @override
  Future<String> load(BloweNoParams params) => Future<String>.delayed(
        const Duration(seconds: 2),
        () => 'Blowe Load Bloc Completed!',
      );
}

class MyBloweWatchBloc extends BloweWatchBloc<String, BloweNoParams> {
  @override
  Stream<String> watch(BloweNoParams params) => Stream<String>.periodic(
        const Duration(seconds: 2),
        (count) => 'Blowe Watch Bloc Update $count',
      );
}

class MyBlowePaginationBloc extends BlowePaginationBloc<MyPaginationModel, BloweNoParams> {
  @override
  Future<MyPaginationModel> load(BloweNoParams params, int page) => Future<MyPaginationModel>.delayed(
        const Duration(seconds: 2),
        () => MyPaginationModel(data: List.generate(10, (index) => 'Item $index')),
      );
}

class MyPaginationModel extends BlowePaginationModel<String> {
  MyPaginationModel({required List<String> data}) : super(data: data);
}

使用说明

1. 安装依赖： 在 pubspec.yaml 文件中添加 blowe_bloc 依赖：

   dependencies:
     flutter:
       sdk: flutter
     blowe_bloc: ^latest_version
   

2. 导入库： 在需要使用的文件中导入 blowe_bloc：

   import 'package:blowe_bloc/blowe_bloc.dart';