DI 플러그인 구성
필수 의존성: io.ktor:ktor-server-di
코드 예제: server-di
애플리케이션 구성 파일에서 의존성 주입(DI) 플러그인을 구성할 수 있습니다. 이러한 설정은 의존성 확인(resolution) 동작에 전역적으로 영향을 미치며, 등록된 모든 의존성에 적용됩니다.
의존성 키 매핑
ktor.di.keyMapping 속성은 의존성 확인 과정에서 키를 일반화하고 매칭하는 방식을 정의합니다. 이는 요청된 타입을 확인할 때 등록된 어떤 의존성을 호환 가능한 것으로 간주할지 결정합니다.
yaml
ktor:
di:
keyMapping: Supertypes * Nullables * OutTypeArgumentsSupertypes * RawTypes위 예제는 DI 플러그인이 사용하는 기본 키 매핑과 일치합니다.
사용 가능한 키 매핑 옵션
DefaultSupertypes * Nullables * OutTypeArgumentsSupertypes * RawTypesSupertypesNullablesOutTypeArgumentsSupertypesout 타입 매개변수에 대한 공변성(covariance)을 허용합니다. RawTypesUnnamed@Named)을 무시합니다. 키 매핑 옵션 조합
집합 연산자인 *(교집합), +(합집합), ()(그룹화)를 사용하여 키 매핑 옵션을 조합할 수 있습니다.
다음 예제에서 List<String>으로 등록된 의존성은 Collection<String>(Supertypes), List 또는 List?(RawTypes 및 Nullables)로 확인할 수 있습니다:
yaml
ktor:
di:
keyMapping: Supertypes + (Nullables * RawTypes)이 조합은 표현식에 포함되지 않았으므로 Collection?으로는 확인되지 않습니다.
충돌 해결 정책
ktor.di.conflictPolicy 속성은 동일한 의존성 키에 대해 여러 프로바이더가 등록되었을 때 DI 컨테이너가 동작하는 방식을 제어합니다:
yaml
ktor:
di:
conflictPolicy: Default사용 가능한 정책
DefaultOverridePreviousIgnoreConflictsIgnoreConflicts를 사용합니다. 이를 통해 테스트 코드가 오류를 발생시키지 않고 프로덕션 의존성을 재정의할 수 있습니다. 