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 ヘッダーが定義されているレスポンスでのみ動作します。
• レンジを配信する際にCompressionを無効にします。

依存関係の追加

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

Gradle (Kotlin)Gradle (Groovy)Maven

PartialContent のインストール

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

モジュール

モジュールを使用すると、ルートをグループ化してアプリケーションを構造化できます。

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

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

embeddedServermodule

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

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