Server Plugin

部分内容

所需依赖项: io.ktor:ktor-server-partial-content

服务端示例: download-file, 客户端示例: client-download-file-range

原生服务端

Ktor 支持 Kotlin/Native，并允许您在没有额外运行时或虚拟机的情况下运行服务端。

支持: ✅

PartialContent 插件添加了对处理 HTTP 范围请求的支持，这些请求用于仅将 HTTP 消息的一部分发送回客户端。此插件适用于流式传输内容或恢复部分下载。

PartialContent 有以下限制：

• 仅适用于 HEAD 和 GET 请求，如果客户端尝试将 Range 头部与其它方法一起使用，则返回 405 Method Not Allowed。
• 仅适用于已定义 Content-Length 头部响应。
• 在提供范围时禁用 Compression。

添加依赖项

要使用 PartialContent，您需要在构建脚本中包含 ktor-server-partial-content artifact：

Gradle (Kotlin)Gradle (Groovy)Maven

安装 PartialContent

要将 PartialContent 插件安装到应用程序，请将其传递给指定

模块

模块允许您通过分组路由来构建应用程序。

中的 install 函数。 以下代码片段展示了如何安装 PartialContent ...

• ... 在 embeddedServer 函数调用内部。
• ... 在显式定义的 module 内部，它是一个 Application 类的扩展函数。

embeddedServermodule

PartialContent 插件也可以安装到特定路由。如果您需要针对不同的应用程序资源使用不同的 PartialContent 配置，这可能会很有用。

要了解如何使用 PartialContent 通过 HTTP 范围请求来提供文件，请参见 File 节。