· Flutter 개발 · 3 min read

Repository 패턴으로 깔끔한 데이터 레이어 구성

코드 구조

Repository 패턴이 필요한 이유

Controller에서 직접 API를 호출하거나, MQTT 클라이언트를 직접 써도 동작은 한다. 그런데 이렇게 하면:

  1. 테스트 어렵다: 실제 서버 없이 테스트 불가
  2. 교체 어렵다: API 라이브러리를 바꾸려면 Controller를 전부 수정해야 함
  3. 중복 코드: 같은 API 호출이 여러 Controller에 중복됨

Repository 패턴은 데이터 소스를 추상화해서 이 문제를 해결한다.

인터페이스 정의 (Domain)

Domain 레이어에 인터페이스만 정의한다:

// domain/repositories/api_repository.dart
abstract class ApiRepository {
  Future<ApiResult<List<IoT DeviceDevice>>> getDevices(String spaceId);
  Future<ApiResult<IoT DeviceDevice>> addDevice(AddDeviceRequest request);
  Future<ApiResult<void>> deleteDevice(String deviceId);
  Future<ApiResult<void>> updateDeviceNickname(String deviceId, String nickname);
}

ApiResult는 성공/실패를 타입 안전하게 표현하는 래퍼다:

// domain/common/api_result.dart
sealed class ApiResult<T> {
  const ApiResult();
}

class ApiSuccess<T> extends ApiResult<T> {
  final T data;
  const ApiSuccess(this.data);
}

class ApiFailure<T> extends ApiResult<T> {
  final String message;
  final int? statusCode;
  const ApiFailure(this.message, {this.statusCode});
}

구현체 (Data)

// data/repositories/api_repository_impl.dart
class ApiRepositoryImpl implements ApiRepository {
  final ApiService _apiService;

  ApiRepositoryImpl(this._apiService);

  @override
  Future<ApiResult<List<IoT DeviceDevice>>> getDevices(String spaceId) async {
    try {
      final response = await _apiService.get('/spaces/$spaceId/devices');
      final devices = (response.data as List)
          .map((json) => IoT DeviceDeviceApiMapper.fromJson(json))
          .toList();
      return ApiSuccess(devices);
    } on ApiException catch (e) {
      return ApiFailure(e.message, statusCode: e.statusCode);
    } catch (e) {
      return ApiFailure('알 수 없는 오류가 발생했습니다');
    }
  }
}

Controller에서 사용

class DeviceManagementController extends GetxController {
  final ApiRepository _apiRepo;
  
  final RxList<IoT DeviceDevice> devices = <IoT DeviceDevice>[].obs;
  final RxBool isLoading = false.obs;
  final RxString errorMessage = ''.obs;

  DeviceManagementController(this._apiRepo);

  Future<void> loadDevices(String spaceId) async {
    isLoading.value = true;
    errorMessage.value = '';
    
    final result = await _apiRepo.getDevices(spaceId);
    
    switch (result) {
      case ApiSuccess(:final data):
        devices.value = data;
      case ApiFailure(:final message):
        errorMessage.value = message;
    }
    
    isLoading.value = false;
  }
}

Dart 3의 패턴 매칭으로 ApiResult를 깔끔하게 처리할 수 있다.

Binding으로 DI 구성

GetX Binding에서 Repository를 등록하고 Controller에 주입한다:

// core/bindings/initial_binding.dart
class InitialBinding extends Bindings {
  @override
  void dependencies() {
    // 서비스 레이어 (싱글톤)
    Get.lazyPut<ApiService>(() => ApiService(), fenix: true);
    Get.lazyPut<IotMqttService>(() => IotMqttService(), fenix: true);
    Get.lazyPut<DbService>(() => DbService(), fenix: true);
    
    // Repository (싱글톤)
    Get.lazyPut<ApiRepository>(
      () => ApiRepositoryImpl(Get.find()),
      fenix: true,
    );
    Get.lazyPut<IoT DeviceMqttRepository>(
      () => IoT DeviceMqttRepositoryImpl(Get.find()),
      fenix: true,
    );
    Get.lazyPut<DbRepository>(
      () => DbRepositoryImpl(Get.find()),
      fenix: true,
    );
  }
}

화면별 Binding에서 Controller를 등록:

class DeviceManagementBinding extends Bindings {
  @override
  void dependencies() {
    Get.lazyPut(() => DeviceManagementController(Get.find<ApiRepository>()));
  }
}

테스트 모드에서의 교체

실제 기기 없이 개발할 때 data/test/ 의 Mock 구현체로 교체:

// 테스트 환경에서
Get.lazyPut<ApiRepository>(
  () => TestApiRepositoryImpl(),  // Mock 구현체
  fenix: true,
);

Controller 코드는 전혀 바꾸지 않아도 Mock이 들어간다. 이게 Repository 패턴의 가장 큰 장점이다.


다음 편은 JWT 토큰 자동 갱신을 구현하는 방법이다.

Share:
Back to Blog