Dependency Injection 베스트 프랙티스

의존성 주입(DI)의 핵심 패턴과 실무 활용법을 다룹니다. 생성자 주입부터 인터페이스 분리, 순환 참조 해결까지 TypeScript 기반으로 구현 방법을 제시합니다.

---

---

들어가며

이 글에서는 Dependency Injection 베스트 프랙티스에 대해 상세히 알아보겠습니다. 총 12가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. 생성자_주입_패턴
2. 인터페이스_기반_주입
3. 팩토리_패턴_활용
4. 컨테이너_기반_DI
5. 순환_참조_해결
6. Lazy_Injection
7. 옵셔널_의존성_처리
8. 프로퍼티_주입_패턴
9. 멀티_인스턴스_주입
10. 데코레이터_기반_메타데이터
11. 스코프_관리_전략
12. 테스트를_위한_Mock_주입

---

1. 생성자 주입 패턴

개요

생성자를 통해 의존성을 주입하는 가장 기본적이고 권장되는 방법입니다. 불변성을 보장하고 테스트가 용이합니다.

코드 예제

class UserService {
  constructor(private readonly db: Database) {}

  async getUser(id: string) {
    return this.db.query('SELECT * FROM users WHERE id = ?', [id]);
  }
}

const service = new UserService(new PostgresDB());

설명

private readonly로 선언하여 생성 시점에 의존성을 주입받고 이후 변경을 방지합니다. 테스트 시 Mock 객체 주입이 쉽습니다.

---

2. 인터페이스 기반 주입

개요

구체 클래스가 아닌 인터페이스에 의존하여 느슨한 결합을 구현합니다. SOLID의 의존성 역전 원칙을 따릅니다.

코드 예제

interface ILogger {
  log(message: string): void;
}

class PaymentService {
  constructor(private logger: ILogger) {}

  process() {
    this.logger.log('Payment processed');
  }
}

설명

ILogger 인터페이스에 의존하므로 ConsoleLogger, FileLogger 등 다양한 구현체로 교체 가능합니다.

---

3. 팩토리 패턴 활용

개요

복잡한 객체 생성 로직을 팩토리로 분리하여 의존성 관리를 단순화합니다. 런타임에 동적으로 구현체를 선택할 수 있습니다.

코드 예제

class ServiceFactory {
  createEmailService(type: 'sendgrid' | 'ses'): IEmailService {
    return type === 'sendgrid'
      ? new SendGridService(this.config)
      : new SESService(this.config);
  }
}

const emailService = factory.createEmailService('sendgrid');

설명

환경 변수나 설정에 따라 적절한 구현체를 생성하여 반환합니다. 조건부 의존성 해결에 유용합니다.

---

4. 컨테이너 기반 DI

개요

IoC 컨테이너를 사용하여 의존성을 중앙에서 관리합니다. 자동 의존성 해결과 생명주기 관리가 가능합니다.

코드 예제

const container = new Container();
container.bind<IDatabase>('Database').to(MongoDatabase);
container.bind<ICache>('Cache').to(RedisCache).inSingletonScope();

const userService = container.get<UserService>(UserService);

설명

InversifyJS 같은 컨테이너로 의존성을 등록하고 자동 주입합니다. 싱글톤, 트랜지언트 등 스코프 관리가 가능합니다.

---

5. 순환 참조 해결

개요

두 클래스가 서로를 참조할 때 발생하는 순환 참조를 이벤트 기반 패턴으로 해결합니다.

코드 예제

class OrderService {
  constructor(private eventBus: EventBus) {}

  createOrder(order: Order) {
    this.eventBus.emit('order.created', order);
  }
}

class NotificationService {
  constructor(eventBus: EventBus) {
    eventBus.on('order.created', this.sendNotification);
  }
}

설명

직접 참조 대신 EventBus를 중간 매개로 사용하여 순환 참조를 제거합니다. 결합도가 낮아집니다.

---

6. Lazy Injection

개요

필요한 시점까지 의존성 생성을 지연시켜 초기화 성능을 개선합니다. 순환 참조 문제 해결에도 도움이 됩니다.

코드 예제

class ReportService {
  constructor(private getDbConnection: () => IDatabase) {}

  async generate() {
    const db = this.getDbConnection(); // 실제 사용 시점에 생성
    return db.query('SELECT * FROM reports');
  }
}

new ReportService(() => new HeavyDatabase());

설명

팩토리 함수를 주입받아 실제로 필요할 때만 의존성을 생성합니다. 무거운 객체 초기화를 지연시킵니다.

---

7. 옵셔널 의존성 처리

개요

선택적 의존성을 명시적으로 처리하여 유연성을 높입니다. undefined 체크로 안전하게 사용합니다.

코드 예제

class AnalyticsService {
  constructor(
    private tracker?: ITracker,
    private logger?: ILogger
  ) {}

  track(event: string) {
    this.tracker?.track(event);
    this.logger?.log(`Tracked: ${event}`);
  }
}

설명

옵셔널 파라미터로 선택적 의존성을 표현합니다. 옵셔널 체이닝으로 안전하게 호출합니다.

---

8. 프로퍼티 주입 패턴

개요

setter나 public 프로퍼티를 통한 주입 방법입니다. 순환 참조나 프레임워크 제약이 있을 때 사용합니다.

코드 예제

class CacheService {
  private storage: IStorage | null = null;

  setStorage(storage: IStorage) {
    this.storage = storage;
  }

  get(key: string) {
    return this.storage?.get(key);
  }
}

설명

생성자 주입이 불가능한 경우에 사용하지만, 불변성이 깨지므로 생성자 주입을 우선 고려해야 합니다.

---

9. 멀티 인스턴스 주입

개요

같은 인터페이스의 여러 구현체를 배열로 주입받아 처리합니다. 플러그인 패턴에 유용합니다.

코드 예제

class ValidationService {
  constructor(private validators: IValidator[]) {}

  validate(data: any): boolean {
    return this.validators.every(v => v.validate(data));
  }
}

new ValidationService([emailValidator, phoneValidator, ageValidator]);

설명

여러 검증기를 배열로 받아 순차적으로 실행합니다. 동적으로 검증 규칙을 추가/제거할 수 있습니다.

---

10. 데코레이터 기반 메타데이터

개요

데코레이터로 의존성 메타데이터를 선언하여 자동 주입을 구현합니다. 타입 안정성과 가독성이 향상됩니다.

코드 예제

@injectable()
class OrderController {
  constructor(
    @inject('OrderService') private orderService: IOrderService,
    @inject('Logger') private logger: ILogger
  ) {}

  createOrder() { /* ... */ }
}

설명

@injectable과 @inject 데코레이터로 DI 컨테이너가 자동으로 의존성을 해결합니다. reflect-metadata 필요합니다.

---

11. 스코프 관리 전략

개요

의존성의 생명주기를 Transient, Scoped, Singleton으로 관리합니다. 리소스 효율성과 상태 관리에 중요합니다.

코드 예제

container.bind(Logger).toSelf().inTransientScope(); // 매번 새 인스턴스
container.bind(DbConnection).toSelf().inRequestScope(); // 요청당 1개
container.bind(ConfigService).toSelf().inSingletonScope(); // 전역 1개

const logger1 = container.get(Logger); // 다른 인스턴스

설명

Transient는 매번 생성, Request는 요청별 공유, Singleton은 전역 공유입니다. 용도에 맞게 선택합니다.

---

12. 테스트를 위한 Mock 주입

개요

테스트 환경에서 실제 의존성을 Mock 객체로 교체하여 격리된 단위 테스트를 수행합니다.

코드 예제

const mockDb: IDatabase = {
  query: jest.fn().mockResolvedValue([{ id: 1, name: 'Test' }])
};

const service = new UserService(mockDb);
const result = await service.getUser('1');

expect(mockDb.query).toHaveBeenCalledWith('SELECT * FROM users WHERE id = ?', ['1']);

설명

jest.fn()으로 Mock을 생성하여 주입합니다. 호출 여부와 인자를 검증하여 격리된 테스트를 수행합니다.

---

마치며

이번 글에서는 Dependency Injection 베스트 프랙티스에 대해 알아보았습니다. 총 12가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

관련 태그

#TypeScript #DependencyInjection #DesignPatterns #SOLID #BestPractices