Server Plugin

部分コンテンツ

必要な依存関係: io.ktor:ktor-server-partial-content

サーバーの例: download-file, クライアントの例: client-download-file-range

ネイティブサーバー

Ktor supports Kotlin/Native and allows you to run a server without an additional runtime or virtual machine.

のサポート: ✅

PartialContentプラグインは、HTTPメッセージの一部のみをクライアントに返送するために使用されるHTTPレンジリクエストの処理のサポートを追加します。このプラグインは、コンテンツのストリーミングや、中断されたダウンロードの再開に役立ちます。

PartialContentには以下の制限事項があります：

• HEADおよびGETリクエストに対してのみ動作し、クライアントが他のメソッドでRangeヘッダーを使用しようとすると405 Method Not Allowedを返します。
• Content-Lengthヘッダーが定義されているレスポンスに対してのみ動作します。
• レンジを配信する際、圧縮（Compression）を無効にします。

依存関係の追加

PartialContentを使用するには、ビルドスクリプトにktor-server-partial-contentアーティファクトを含める必要があります：

Gradle (Kotlin)Gradle (Groovy)Maven

PartialContentのインストール

PartialContentプラグインをアプリケーションにインストールするには、指定された

モジュール

Modules allow you to structure your application by grouping routes.

内のinstall関数に渡します。 以下のコードスニペットは、PartialContentをインストールする方法を示しています...

• ... embeddedServer関数の呼び出し内。
• ... 明示的に定義されたmodule（Applicationクラスの拡張関数）内。

embeddedServermodule

PartialContentプラグインは、特定のルートにインストールすることもできます。 これは、アプリケーションのリソースごとに異なるPartialContent構成が必要な場合に役立ちます。

HTTPレンジリクエストを使用してファイルを配信するためにPartialContentを使用する方法については、Fileセクションを参照してください。