使用Freezed插件时Bloc状态类的合理定义与多状态数据共享实现
Bloc状态层的共享数据设计方案
核心设计误区
你当前的设计问题本质是混淆了状态和操作阶段/事件的边界:
- 你之前定义的
GetDataFromServer本质是Bloc需要响应的事件,也就是触发某类操作的指令,而非Bloc对外同步的状态。 - 把不同的操作动作做成独立的状态子类,会导致所有跨阶段复用的
ServerData需要在每个独立状态子类里重复声明,既冗余又容易在状态流转过程中出现数据丢失的问题。
正确的Bloc状态设计逻辑是:
- 状态是对UI当前完整形态的不可变快照,一旦生成就不会被修改
- 所有需要跨阶段保留的数据,作为状态的公共顶级字段存在
- 操作阶段的区分,通过状态内的枚举标识实现,不需要拆成独立的Freezed子类
基于Freezed的可复用结构实现
首先把所有跨状态共享的数据提为顶级公共字段,把原来的几个独立状态构造函数,替换成枚举类型的阶段标识:
import 'package:freezed_annotation/freezed_annotation.dart'; part 'example_state.freezed.dart'; // 定义所有可能的操作阶段枚举 enum ExampleStatus { initial, loadingServerData, // 对应原GetDataFromServer的加载阶段 dataReadyForUse, // 对应原UseServerData的正常展示阶段 uploadingChangedData, // 对应原ChangeServerDataAndUpload的上传阶段 operationFailed, } @freezed abstract class ExampleState with _$ExampleState { // 内部构造函数,支持自定义扩展逻辑 const ExampleState._(); // 所有状态共享的顶级字段,不管处于哪个阶段,都能直接访问 const factory ExampleState({ // 跨阶段复用的服务端数据 required ServerData? serverData, // 当前所处的操作阶段 required ExampleStatus status, // 可选:操作错误信息 String? errorMessage, }) = _ExampleState; } // 原有ServerData模型保持不变即可 class ServerData { final String userId; final String firstName; final String lastName; final String fullAddress; final String fatherName; ServerData( this.userId, this.firstName, this.lastName, this.fullAddress, this.fatherName, ); }
状态流转的实际使用方式
这种结构下,跨状态共享ServerData完全不需要手动传值,依托Freezed自带的copyWith能力就能自动保留数据:
- 初始化Bloc的初始状态为:
const ExampleState(serverData: null, status: ExampleStatus.initial) - 接收到"拉取服务端数据"的事件时,先emit一个加载中的状态,无需改动已有的共享字段:
emit(state.copyWith(status: ExampleStatus.loadingServerData)); - 网络请求拿到响应的
ServerData后,将数据存入状态公共字段,同时切换为可展示的阶段:emit(state.copyWith( serverData: fetchedServerData, status: ExampleStatus.dataReadyForUse, )); - 接收到"修改数据并上传"的事件时,只需要切换状态标识,已存在的
serverData会被copyWith自动保留,不需要手动传入:emit(state.copyWith(status: ExampleStatus.uploadingChangedData)); - 上传完成拿到最新的服务端数据后,直接更新公共字段的
serverData值即可。
相比原设计的优势
- 完全消除重复字段:不需要在每个独立状态类里重复声明
ServerData字段,后续要新增共享配置(比如用户权限、本地缓存值)时,只需要在顶级字段加一次即可 - 简化UI层取值逻辑:原来需要做多层类型判断才能拿到
ServerData的逻辑,现在直接通过state.serverData就能在任何阶段访问到 - 符合Bloc的设计初衷:状态是给UI看的快照,当你处于"上传中"的阶段时,UI完全可以边展示加载框,边把已有的
serverData渲染在页面上,不会因为状态切换丢失已经加载完成的数据
内容的提问来源于stack exchange,提问作者Purushotam Kumar
相关产品推荐
相关产品推荐

