Skip to content

Ktor의 격리된 컨텍스트 ​

이 페이지에서는 Koin을 글로벌 컨텍스트(Global Context)에 등록하지 않고 단일 Ktor 애플리케이션을 위해 시작하는 KoinIsolated 플러그인을 다룹니다. 이렇게 하면 각 애플리케이션이 고유한 컨테이너를 갖게 됩니다. 격리된 컨텍스트의 개념과 사용 시점에 대한 설명은 Context Isolation을 참고하세요. 일반적인 Koin 플러그인에 대한 설명은 Koin for Ktor에 나와 있습니다.

KoinIsolated 설치 ​

Koin 대신 KoinIsolated를 설치합니다. 설정 블록은 동일합니다:

kotlin
import org.koin.ktor.plugin.KoinIsolated

fun Application.module() {
    install(KoinIsolated) {
        slf4jLogger()
        modules(appModule)
    }
}
kotlin
import org.koin.ktor.plugin.KoinIsolated
import org.koin.plugin.module.dsl.withConfiguration

fun Application.module() {
    install(KoinIsolated) {
        slf4jLogger()
        withConfiguration<KoinUserApplication>()
    }
}
kotlin
import org.koin.ktor.plugin.KoinIsolated

fun Application.module() {
    install(KoinIsolated) {
        slf4jLogger()
        modules(appModule)
    }
}

Koin과 비교하여 달라지는 점 ​

install(Koin)install(KoinIsolated)
글로벌 컨텍스트에 등록 여부예아니요
Application, Route, Routing, ApplicationCall에서의 inject() / get()예예 (해당 애플리케이션의 인스턴스로부터)
요청 스코프(Request scope) 및 call.scope예예
수명 주기 이벤트(Lifecycle events), ApplicationStopping 시 종료예예
Ktor DI로의 bridge { }예Koin 4.2에서는 적용되지 않음
KoinComponent 클래스, KoinPlatform.getKoin()이 인스턴스를 참조함이 인스턴스를 참조하지 못함

Ktor 확장 함수는 애플리케이션 어트리뷰트(attributes)에 저장된 Koin 인스턴스를 읽으므로 라우트(route)에서의 주입은 동일하게 작동합니다:

kotlin
fun Application.module() {
    install(KoinIsolated) {
        modules(appModule)
    }

    val userService by inject<UserService>()
    val koin = getKoin() // 이 애플리케이션의 Koin 인스턴스

    routing {
        get("/users/{id}") {
            val logger = call.scope.get<RequestLogger>()
            call.respond(userService.getUser(call.parameters["id"]!!))
        }
    }
}

WARNING

Ktor 리시버 외부의 코드는 격리된 인스턴스에 접근할 수 없습니다. KoinComponent를 구현하는 클래스나 KoinPlatform.getKoin() 호출은 글로벌 컨텍스트를 사용하므로 "KoinApplication has not been started" 오류와 함께 실패합니다. 클래스의 의존성은 격리된 모듈에 선언하고 생성자 파라미터를 통해 전달하세요. 직접 의존성을 가져와야 하는 상호 운용(interop) 진입점의 경우, Context Isolation에 나온 대로 getKoin()을 오버라이드하세요.

하나의 JVM 내 여러 서버 ​

각 임베디드 서버는 고유한 컨테이너를 가집니다:

kotlin
fun main() {
    val userServer = embeddedServer(Netty, port = 8080) {
        install(KoinIsolated) { modules(userServiceModule) }
        userRouting()
    }

    val orderServer = embeddedServer(Netty, port = 8081) {
        install(KoinIsolated) { modules(orderServiceModule) }
        orderRouting()
    }

    userServer.start(wait = false)
    orderServer.start(wait = true)
}

install(Koin)을 사용할 경우 플러그인이 시작되기 전에 실행 중인 글로벌 인스턴스를 중지하므로, 두 번째 서버가 첫 번째 서버의 글로벌 Koin을 중지하게 됩니다.

테스트 ​

KoinIsolated를 설치하는 각 testApplication은 고유한 컨테이너를 가지므로, 테스트가 글로벌 컨텍스트를 통해 상태를 공유하지 않고 병렬로 실행될 수 있습니다. 테스트 설정 방법은 Ktor Testing에서 다룹니다.

글로벌 컨텍스트를 유지해야 하는 경우 ​

프로세스 내에서 하나의 Ktor 애플리케이션만 실행되고 해당 프로세스의 다른 진입점(예: main()에서 시작된 스케줄링 작업)이 동일한 컨테이너를 사용해야 하거나, Ktor DI 브리지가 필요한 경우에는 install(Koin)을 계속 사용하세요.