BLoC — とは何か、FlutterにおけるBusiness Logic Component

BLoCとは？

BLoC（Business Logic Component）— Flutter用のアーキテクチャパターンで、ビジネスロジックをUIから分離した独立したクラスに抽出します。BLoCはイベントのストリーム（Event）を介して入力データを受け取り、状態のストリーム（State）を介して出力データを生成します。プレゼンテーション層（Widget）はStateストリームにサブスクライブしてUIをレンダリングするだけで、ビジネスロジックを直接実行することはありません。

BLoCの概念はリアクティブプログラミングとObserverパターンに基づいています。各BLoCコンポーネントは、明確な契約を持つ独立したモジュールです。既知のEventのセット（何が起こり得るか）と既知のStateのセット（何が表示され得るか）があります。開発者はUIから「誤って」状態を変更することはできません — 特定のEventを介してのみ可能です。これにより、コードは予測可能でテスト可能になります。

Flutter Community 2025の調査によると、BLoCはProviderに次いでFlutterの状態管理ソリューションで人気第2位です。主な利点：強い型付け、ロジックの分離、組み込みのStreamサポート、豊富なユーティリティエコシステム（BlocProvider、BlocListener、BlocSelector）。

BLoCのアーキテクチャ：Event → Bloc → State

BLoCアーキテクチャは3つのエンティティを中心に構築されています：Event（入力）、Bloc（ハンドラ）、State（出力）。Widgetはadd()メソッドを介してEventを送信します。BlocはmapEventToStateまたはon<Event>メソッドでEventを受け取り、ビジネスロジックを実行し、yieldを介して新しいStateを発行します。WidgetはStreamを介してStateを受け取り、再構築します。

abstract class CounterEvent {}

class Increment extends CounterEvent {}
class Decrement extends CounterEvent {}

class CounterBloc extends Bloc<CounterEvent, int> {
  CounterBloc() : super(0);

  @override
  Stream<int> mapEventToState(CounterEvent event) async* {
    if (event is Increment) {
      yield state + 1;
    } else if (event is Decrement) {
      yield state - 1;
    }
  }
}

タイプセーフティ： BlocはEventとStateの2つの型でパラメータ化されています。Dartコンパイラは、Widgetが宣言されたEventのみを呼び出し、Blocが宣言されたStateのみを返すことをチェックします。「不明なアクション」のような実行時エラーは排除されます。

CloseとDispose： BlocはCloseableインターフェースを実装します。ウィジェットが破棄されると、Blocは自動的にclose()メソッドを介してStreamを閉じます。リアクティブサブスクリプションのリークは不可能です — BlocProviderがBlocのライフサイクルを管理し、ルートまたはページにバインドします。

BlocとCubit：比較

Cubitは、flutter_bloc 6.0パッケージで導入された、EventなしのBlocの簡略化された実装です。CubitはEventクラスの代わりに直接メソッドを宣言します：increment()、fetchData()。内部的には、Cubitは同じStreamベースのメカニズムを使用しますが、Event層を隠します。これにより、単純なシナリオではボイラープレートが40〜50％削減されます。

Cubitを選ぶ場合： 2〜3のバリアントがある状態（loading、loaded、error）、単純なフォーム、カウンター、UI状態（開く/閉じる）。Blocを選ぶ場合： 複数のアクションを持つ複雑なビジネスロジック：注文処理、認証、データ同期。BlocはEventを通じて各アクションの詳細なトレースを提供します — すべての呼び出しはBlocObserverに記録されます。

BlocObserver — アプリケーション内のすべてのBlocとCubitを追跡するグローバルオブザーバーです。Event、State、エラー、遷移をログに記録できます。1つのインスタンスを接続するだけです：Bloc.observer = AppBlocObserver()、アプリケーション全体の状態追跡が集中管理されます。

BlocProviderとBlocBuilder

BlocProvider — flutter_blocのInheritedWidgetで、子ウィジェットにBlocを提供します。ウィジェットが初期化されると、BlocProviderはBlocを作成し、破棄されるとclose()を介して自動的に閉じます。BlocProviderはMaterialAppレベル（グローバルBloc）または特定のルートレベル（ローカルBloc）に配置できます。

BlocProvider(
  create: (context) => CounterBloc(),
  child: Column(
    children: [
      BlocBuilder<CounterBloc, int>(
        builder: (context, state) => Text('$state'),
      ),
      ElevatedButton(
        onPressed: () => context.read<CounterBloc>().add(Increment()),
        child: Text('+'),
      ),
    ],
  ),
)

BlocBuilder — 新しいStateごとにUIを再構築するウィジェット。BlocListener — 副作用用（UIを再構築せずにStateを1回処理）：SnackBarを表示、別の画面に移動。BlocConsumer — 再構築と副作用の両方が必要な場合のBuilderとListenerの組み合わせ。BlocSelector — Stateの特定のフィールドが変更された場合のみ選択的に再構築します。

MultiBlocProvider — ネストレベルを増やさずにネストされたBlocProviderを使用するためのウィジェット。10〜15個のBlocを持つFlutterアプリケーションは、ルートレベルでMultiBlocProviderを使用して、アプリケーション全体で利用可能なすべてのBloc（AuthenticationBloc、CartBloc、SettingsBloc）を登録します。

BLoCのテスト

BLoCのテストは、Flutterウィジェットなしで分離して行われます。Dartパッケージflutter_testとbloc_testパッケージをインポートするだけです。テストシナリオ：Blocを作成し、Eventを追加し、Stateを確認します。blocTest — build → act → expectのシーケンスを自動化するユーティリティです。

blocTest<CounterBloc, int>(
  'emits [1] when Increment is added',
  build: () => CounterBloc(),
  act: (bloc) => bloc.add(Increment()),
  expect: () => [1],
)

モッキング： リポジトリまたはAPIに依存するBlocは、mocktailを介してモックでテストされます。リポジトリは抽象化レベルでモックされ、Blocはコンストラクタを介してモックされた依存関係を受け取ります。Hydrated Bloc — ローカルストレージへの自動状態保存/復元のための拡張機能。HydratedBlocStorageと一時ファイルストレージを使用してテストされます。

本番環境でのBLoC

フォルダとファイル： BLoCを使用した典型的なFlutterプロジェクト構造：bloc/counter_bloc.dart、bloc/counter_event.dart、bloc/counter_state.dart。30画面以上の場合は、機能ベースのグループ化が推奨されます：features/auth/bloc/、features/cart/bloc/。各Blocは別ファイル、各EventとStateは別ファイルまたはBlocと同じファイルに配置します。

パフォーマンス： BLoCは空のStreamにオーバーヘッドを作成しません。BlocBuilderはbuildWhenを使用して再構築をフィルタリングします — 特定の条件が変更された場合のみウィジェットが更新されます。Closeにより、非アクティブなBlocがメモリを消費しないことが保証されます。Flutter DevToolsによると、BLoCはバンドルサイズに1％未満しか追加しません。

Providerからの移行： BLoCは同じプロジェクト内でProviderと簡単に共存できます。段階的な移行：最初に最も複雑なProviderをBlocに置き換え、次に残りを置き換えます。BlocProviderはProviderツリーと互換性があります：古いウィジェットはProviderを、新しいウィジェットはBlocProviderを、同じアプリケーション内で使用できます。