Skip to content
Server Plugin

의존성 주입

필수 의존성: io.ktor:ktor-server-di

코드 예제: server-di

의존성 주입(Dependency injection, DI)은 컴포넌트에 필요한 의존성을 제공할 수 있도록 돕는 디자인 패턴입니다. 모듈이 구체적인 구현을 직접 생성하는 대신 추상화에 의존하며, DI 컨테이너가 런타임에 적절한 인스턴스를 생성하고 제공하는 역할을 담당합니다. 이러한 분리를 통해 결합도를 낮추고 테스트 가능성을 향상시키며, 기존 코드를 수정하지 않고도 구현을 쉽게 교체하거나 재구성할 수 있습니다.

Ktor는 서비스 및 설정 객체를 한 번 등록한 후 애플리케이션 전반에서 접근할 수 있도록 하는 내장 DI 플러그인을 제공합니다. 일관되고 타입 안전한(type-safe) 방식으로 이러한 의존성을 모듈, 플러그인, 라우트 및 기타 Ktor 컴포넌트에 주입할 수 있습니다. 이 플러그인은 Ktor 애플리케이션 라이프사이클과 통합되며 스코프 지정, 구조화된 설정, 자동 리소스 관리를 지원하여 애플리케이션 수준의 서비스를 구성하고 유지 관리하기 쉽게 해줍니다.

의존성 추가 ​

DI를 사용하려면 빌드 스크립트에 ktor-server-di 아티팩트를 포함하세요:

kotlin
implementation(ktorLibs.server.di)
위 코드 스니펫은 Ktor 버전 카탈로그를 사용하여 Ktor 의존성을 지정합니다.
groovy
implementation ktorLibs.server.di
위 코드 스니펫은 Ktor 버전 카탈로그를 사용하여 Ktor 의존성을 지정합니다.
xml
<dependency>
    <groupId>io.ktor</groupId>
    <artifactId>ktor-server-di-jvm</artifactId>
    <version>${ktor_version}</version>
</dependency>

Ktor에서 의존성 주입이 작동하는 방식 ​

Ktor에서 의존성 주입은 밀접하게 관련된 두 단계로 구성된 단일 통합 프로세스입니다:

이러한 단계는 단일 DI 컨테이너에 의해 처리됩니다.

애플리케이션에서 의존성 주입을 사용하려면 먼저 의존성 등록부터 살펴보세요. 의존성이 선언되고 나면 의존성 해결을 진행합니다.

지원되는 기능 ​

DI 플러그인은 일반적인 애플리케이션 요구사항을 충족하기 위한 다양한 기능을 지원합니다:

설정 및 라이프사이클 동작 ​

DI 컨테이너의 동작은 설정 옵션을 통해 사용자 정의할 수 있습니다. 이러한 옵션은 의존성 키가 일치하는 방식, 충돌이 처리되는 방식, 그리고 고급 시나리오에서 해결이 작동하는 방식을 제어합니다.

설정에 대한 자세한 내용은 DI 플러그인 구성을 참조하세요.

리소스 정리 및 종료 동작에 대해서는 리소스 라이프사이클 관리를 참조하세요.

의존성 주입을 활용한 테스트 ​

DI 플러그인은 Ktor의 테스트 유틸리티와 통합되어 테스트 환경에서 의존성 오버라이드, 설정 로드, 충돌 동작 제어를 지원합니다.

자세한 정보와 예제는 의존성 주입을 활용한 테스트를 참조하세요.