Skip to content
Server Plugin

部分內容

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

伺服器範例: download-file, 用戶端範例: client-download-file-range

Native 伺服器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 構件新增至您的建置指令碼中:

kotlin
implementation(ktorLibs.server.partialContent)
上述程式碼片段使用 Ktor 版本目錄 (version catalog) 來指定 Ktor 相依性。
groovy
implementation ktorLibs.server.partialContent
上述程式碼片段使用 Ktor 版本目錄 (version catalog) 來指定 Ktor 相依性。
xml
<dependency>
    <groupId>io.ktor</groupId>
    <artifactId>ktor-server-partial-content-jvm</artifactId>
    <version>${ktor_version}</version>
</dependency>

安裝 PartialContent ​

若要將 PartialContent 外掛程式安裝至應用程式中, 請將其傳遞給指定模組模組可讓您透過對路由進行分組來建構應用程式。中的 install 函式。 以下範例示範如何安裝 PartialContent:

  • 在 embeddedServer() 函式呼叫中。
  • 在 Application 類別上明確定義的 module() 擴充函式中。
kotlin
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.plugins.partialcontent.*

fun main() {
    embeddedServer(Netty, port = 8080) {
        install(PartialContent)
        // ...
    }.start(wait = true)
}
kotlin
import io.ktor.server.application.*
import io.ktor.server.plugins.partialcontent.*
// ...
fun Application.module() {
    install(PartialContent)
    // ...
}

PartialContent 外掛程式也可以安裝到特定路由。 如果您需要針對不同的應用程式資源使用不同的 PartialContent 設定,這將會非常實用。

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