Skip to content
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 的测试工具集成,支持在测试环境中覆盖依赖项、加载配置以及控制冲突行为。

有关详细信息和示例,请参阅使用依赖注入进行测试。