Server Plugin

部分內容

必要的相依性：io.ktor:ktor-server-partial-content

伺服器端範例： download-file， 用戶端範例： client-download-file-range

原生伺服器

Ktor 支援 Kotlin/Native，並允許您在沒有額外執行階段或虛擬機的情況下執行伺服器。

支援：✅

PartialContent 外掛程式增加了對處理 HTTP 範圍請求 (HTTP range requests) 的支援，這些請求用於僅將 HTTP 訊息的一部分傳回給用戶端。此外掛程式對於串流內容或續傳部分下載非常有用。

PartialContent 有以下限制：

• 僅適用於 HEAD 和 GET 請求；如果用戶端嘗試在其他方法中使用 Range 標頭，則傳回 405 Method Not Allowed。
• 僅適用於已定義 Content-Length 標頭的回應。
• 在提供範圍內容時會停用 Compression。

新增相依性

若要使用 PartialContent，您需要在建置指令碼中包含 ktor-server-partial-content 構件：

Gradle (Kotlin)Gradle (Groovy)Maven

安裝 PartialContent

若要在應用程式中安裝 PartialContent 外掛程式，請將其傳遞給指定

模組

模組允許您透過分組路由來建構應用程式。

中的 install 函式。 下方的程式碼片段展示了如何安裝 PartialContent ...

• ... 在 embeddedServer 函式呼叫中。
• ... 在明確定義的 module 中，它是 Application 類別的擴充函式。

embeddedServermodule

PartialContent 外掛程式也可以安裝到特定路由。 如果您需要為不同的應用程式資源使用不同的 PartialContent 配置，這可能會非常有用。

若要了解如何使用 PartialContent 透過 HTTP 範圍請求提供檔案，請參閱 File 章節。