You need to enable JavaScript to run this app. 使用Freezed插件时Bloc状态类的合理定义与多状态数据共享实现
优惠活动
大模型
产品
解决方案
定价
更多

使用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能力就能自动保留数据:

  1. 初始化Bloc的初始状态为:
    const ExampleState(serverData: null, status: ExampleStatus.initial)
    
  2. 接收到"拉取服务端数据"的事件时,先emit一个加载中的状态,无需改动已有的共享字段:
    emit(state.copyWith(status: ExampleStatus.loadingServerData));
    
  3. 网络请求拿到响应的ServerData后,将数据存入状态公共字段,同时切换为可展示的阶段:
    emit(state.copyWith(
      serverData: fetchedServerData,
      status: ExampleStatus.dataReadyForUse,
    ));
    
  4. 接收到"修改数据并上传"的事件时,只需要切换状态标识,已存在的serverData会被copyWith自动保留,不需要手动传入:
    emit(state.copyWith(status: ExampleStatus.uploadingChangedData));
    
  5. 上传完成拿到最新的服务端数据后,直接更新公共字段的serverData值即可。

相比原设计的优势

  • 完全消除重复字段:不需要在每个独立状态类里重复声明ServerData字段,后续要新增共享配置(比如用户权限、本地缓存值)时,只需要在顶级字段加一次即可
  • 简化UI层取值逻辑:原来需要做多层类型判断才能拿到ServerData的逻辑,现在直接通过state.serverData就能在任何阶段访问到
  • 符合Bloc的设计初衷:状态是给UI看的快照,当你处于"上传中"的阶段时,UI完全可以边展示加载框,边把已有的serverData渲染在页面上,不会因为状态切换丢失已经加载完成的数据

内容的提问来源于stack exchange,提问作者Purushotam Kumar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 07:27:01