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标头的响应。 - 在提供范围内容时禁用 压缩。
添加依赖项
要使用 PartialContent,您需要在构建脚本中包含 ktor-server-partial-content 构件:
Kotlin
Groovy
XML
安装 PartialContent
要将 PartialContent 插件 安装 到应用程序中,请将其传递给指定
模块
中的 模块允许您通过对路由进行分组来构建应用程序结构。
install 函数。 下面的代码片段显示了如何安装 PartialContent ... - ... 在
embeddedServer函数调用内部。 - ... 在显式定义的
module内部,它是Application类的扩展函数。
kotlin
kotlin
PartialContent 插件也可以 安装到特定路由。 如果您需要为不同的应用程序资源使用不同的 PartialContent 配置,这可能会很有用。
要了解如何使用 PartialContent 通过 HTTP 范围请求提供文件,请参阅 文件 部分。
