开发模式
Ktor 提供了一种专门用于开发的模式。此模式支持以下功能:
- 自动重载,用于在不重启服务器的情况下重新加载应用程序类。了解如何使用自动重载在代码更改时重新加载应用程序类。
- 用于调试 管道 的扩展信息(附带堆栈跟踪)。
- 在发生 5** 服务器错误时,在 响应页面上显示扩展调试信息。%plugin_name% 允许 Ktor 应用程序根据抛出的异常或状态码适当地响应任何失败状态。
NOTE
请注意,开发模式会影响性能,不应在生产环境中使用。
启用开发模式
您可以通过多种方式启用开发模式:在应用程序配置文件中、使用专用系统属性或环境变量。
'io.ktor.development' 系统属性
io.ktor.development系统属性 允许您在运行应用程序时启用开发模式。
要在 IntelliJ IDEA 中使用开发模式运行应用程序, 请将带有 -D
标志的 io.ktor.development
传递给 VM options:
如果您使用
Gradle
任务运行应用程序, 可以通过两种方式启用开发模式: 了解如何将 Ktor 服务器依赖项添加到现有 Gradle/Maven 项目。
在您的 build.gradle.kts 文件中配置
ktor
块:Kotlin通过传递 Gradle CLI 标志,为单次运行启用开发模式:
bash
TIP
您还可以使用 -ea
标志来启用开发模式。 请注意,通过 -D
标志传递的 io.ktor.development
系统属性优先于 -ea
。
'io.ktor.development' 环境变量
要为 原生客户端 启用开发模式, 请使用 io.ktor.development
环境变量。