BLoC — 무엇인가, Flutter의 Business Logic Component

BLoC란 무엇인가?

BLoC(Business Logic Component) — 비즈니스 로직을 UI와 분리된 별도 클래스로 추출하는 Flutter용 아키텍처 패턴입니다. 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 아키텍처는 세 가지 엔터티를 중심으로 구축됩니다: 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의 두 가지 타입으로 매개변수화됩니다. 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, 오류 및 전환을 기록할 수 있습니다. 인스턴스 하나만 연결하면 됩니다: 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를 한 번 처리): 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를 동일한 애플리케이션 내에서 사용할 수 있습니다.