Skip to content
Server Plugin

部分内容

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

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

原生服务器
Ktor 支持 Kotlin/Native,并允许您在没有额外运行时或虚拟机的情况下运行服务器。
支持:✅

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

PartialContent 具有以下限制:

  • 仅适用于 HEADGET 请求,如果客户端尝试在其他方法中使用 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 范围请求提供文件,请参阅 文件 部分。