Ktor 是使用 Kotlin 构建异步服务器和客户端的 Web 框架，上个月发布了重要的新版本 2.0，并于近日发布了首个补丁更新 2.0.1。
Ktor 2.0 引入了许多新功能，以及破坏性变化，官方称这让他们有机会执行一些维护工作并摆脱遗留决策。尽管存在重大变更，但官方表示已尽可能降低其影响，并提供了有助于自动迁移的实用工具。
Ktor 2.0 新特性
Ktor 服务器
简化的可扩展性
Ktor 提供的所有功能均以插件架构构建，“功能”也因此更名为“插件”。对于某些人来说，架构模型会难以理解。2.0 大幅简化了可扩展性 API，使插件更易创建。
看看下面 1.x 的 API 代码
companion object Feature : ApplicationFeature<ApplicationCallPipeline, CustomHeader.Configuration, CustomHeader> { override val key = AttributeKey<CustomHeader>("CustomPlugin" override fun install(pipeline: ApplicationCallPipeline, configure: Configuration.( -> Unit: CustomHeader { val configuration = Configuration(.apply(configure val feature = CustomHeader(configuration
pipeline.intercept(ApplicationCallPipeline.Call {
feature.intercept(this
} return feature
}
}到了 2.0 中
val myCustomPlugin = createApplicationPlugin("CustomPlugin" { onCall {
} onCallReceive {
} onCallRespond {
}
}大多数现有插件都已转换为使用新 API，并已覆盖大多数情景。 有关详情，请参见 `CustomHeader` 插件从旧 API 到新 API 的转换，以及插件开发文档。
据官方介绍，他们在可扩展性方面还有更多计划，包括用于从市场轻松发布和使用插件的工具！
Native 支持
在服务器端，除了 GraalVM（从 1.6 开始就已支持）之外，现在还支持 Kotlin/Native，这意味着独立服务器应用程序上有了两种选择。
关于 Kotin/Native 支持，目前仅限于使用 CIO 作为引擎，开发团队将继续在性能领域推进工作。建议使用新的 Kotlin/Native 内存模型。
其他服务器改进
对 Ktor 服务器进行了一系列较小的改进，包括随机端口支持
fun main( {
embeddedServer(Netty, port = 0 {
configureRouting(
}.start(wait = true
}以及改进的测试 API、类型安全路由、XML 序列化、插件的子路由以及 60 多个错误修正和其他功能。
Ktor 客户端
简化的 API
API 得到进一步简化。在 Ktor 客户端中，引入了新的 API 来处理常见 HTTP 请求
val result = client.post("http://127.0.0.1:$port/" {
}
result.bodyAsText(新版本已经摆脱了通用的 post<T>, get<T> 方法。 现在，所有内容都返回一个 `HttpResponse`，可供访问正文（使用 `bodyAsText`、`bodyAsChannel`）以及标题。
重试
增加了对重试的内置支持，包括重试之间的时间调整
val client = HttpClient(CIO { install(HttpRequestRetry { maxRetries = 5 retryIf { request, response -> !response.status.isSuccess( } retryOnExceptionIf { _, cause -> cause is NetworkError } delayMillis { retry -> retry * 3000L } // retries in 3, 6, 9, etc. seconds }}内容协商
如果您一直在服务器中使用内容协商，您应该已经很熟悉这一功能了。 本质上，它就是客户端与服务器协商可以请求和提供的不同类型内容的能力。 在此之前，它的协商方面仅适用于服务器。 现在，客户端也提供了此功能。
val client = HttpClient(CIO { install(ContentNegotiation { }}这个插件有效取代了 `JsonFeature`。
其他客户端改进
除了上述内容外，客户端还包括用于身份验证的快捷 API（例如 `basic(` 和 `bearer(` 辅助函数）、请求级别的侦听器、新的指标插件、XML 序列化，以及许多错误修正和其他功能。
更多内容查看 Changelog。