Ktor 中的依賴注入 (Dependency Injection)

koin-ktor 模組專門為 Ktor 引入依賴注入（dependency injection）。

安裝 Koin 外掛程式（Plugin）

若要在 Ktor 中啟動 Koin 容器（container），只需安裝 Koin 外掛程式，如下所示：

fun Application.main() {
    // 安裝 Koin
    install(Koin) {
        slf4jLogger()
        modules(helloAppModule)
    }

}

在 Ktor 中注入（Inject）

Koin 的 inject() 和 get() 函數可從 Application、Route、Routing 類別中使用：

fun Application.main() {

    // 注入 HelloService
    val service by inject<HelloService>()

    routing {
        get("/hello") {
            call.respondText(service.sayHello())
        }
    }
}

從 Ktor 請求作用域（Request Scope）解析（自 4.1.0 起）

您可以宣告組件（component）在 Ktor 請求作用域時間軸內存活。 為此，您只需要在 requestScope 區段內宣告您的組件。 給定一個 ScopeComponent 類別，用以在 ktor web 請求作用域上實例化，讓我們宣告它：

requestScope {
    scopedOf(::ScopeComponent)
}

然後從您的 http 呼叫中，只需呼叫 call.scope.get() 來解析正確的依賴項：

routing {
    get("/hello") {
        val component = call.scope.get<ScopeComponent>()
        // ... 
    }
}

備註

對於每個新請求，作用域（scope）將被重新創建。 這會為每個請求創建和刪除作用域實例。

從外部 Ktor 模組運行 Koin

對於 Ktor 模組，您可以加載特定的 Koin 模組。 只需使用 koin { } 函數宣告它們：

fun Application.module2() {

    koin {
        // 加載 koin 模組
        modules(appModule2)
    }

}

Ktor 事件（Events）

您可以監聽 KTor Koin 事件：

fun Application.main() {
    // ...

    // 安裝 Ktor 功能（features）
    environment.monitor.subscribe(KoinApplicationStarted) {
        log.info("Koin started.")
    }

    environment.monitor.subscribe(KoinApplicationStopPreparing) {
        log.info("Koin stopping...")
    }

    environment.monitor.subscribe(KoinApplicationStopped) {
        log.info("Koin stopped.")
    }

    //...
}