Server Plugin
相依注入
必要相依性:io.ktor:ktor-server-di
程式碼範例: server-di
相依注入 (DI) 是一種設計模式,可協助你為組建提供所需的相依性。模組不再直接建立具體實作,而是依賴抽象,並由 DI 容器負責在執行時期建構並提供適當的執行個體。這種分離降低了耦合度、提升了可測試性,並使替換或重新配置實作更加容易,而無需修改現有程式碼。
Ktor 提供了內建的 DI 外掛程式,讓你可以一次性註冊服務與配置物件,並在整個應用程式中存取它們。你可以透過一致且型別安全的方式,將這些相依性注入模組、外掛程式、路由及其他 Ktor 組建中。該外掛程式與 Ktor 應用程式生命週期整合,並支援作用域、結構化配置以及自動資源管理,讓組織與維護應用程式層級的服務更加輕鬆。
新增相依性
若要使用 DI,請在建置指令碼中加入 ktor-server-di 構件:
kotlin
implementation(ktorLibs.server.di) 上述程式碼片段使用 Ktor 版本目錄 (version catalog) 來指定 Ktor 相依性。
groovy
implementation ktorLibs.server.di 上述程式碼片段使用 Ktor 版本目錄 (version catalog) 來指定 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 的測試公用程式整合,並支援在測試環境中覆寫相依性、載入配置以及控制衝突行為。
如需更多資訊與範例,請參閱使用相依注入進行測試。
