シングルページアプリケーションの配信
コード例: single-page-application
Ktor は React、Angular、Vue などのシングルページアプリケーションを配信する機能を提供します。
依存関係の追加
シングルページアプリケーションを配信するには、ktor-server-core 依存関係のみが必要です。 特定の追加依存関係は不要です。
アプリケーションの配信
シングルページアプリケーションを配信するには、コンテンツの配信元(ローカルファイルシステムまたはクラスパス)を定義する必要があります。 少なくとも、シングルページアプリケーションが含まれるフォルダーまたはリソースパッケージを指定する必要があります。
特定のフレームワーク向けアプリケーションの配信
React、Angular、Vue などの特定のフレームワークを使用して作成されたシングルページアプリケーションのビルド成果物を配信できます。 プロジェクトのルートに React アプリケーションを含む react-app フォルダーがあると仮定します。 このアプリケーションは次の構造を持ち、メインページとして index.html ファイルが含まれています。
react-app
├── index.html
├── ...
└── static
└── ...このアプリケーションを配信するには、routing ブロック内で singlePageApplication を呼び出し、フォルダー名を react 関数に渡します。
import io.ktor.server.application.*
import io.ktor.server.http.content.*
import io.ktor.server.routing.*
fun Application.module() {
routing {
singlePageApplication {
react("react-app")
}
}
}Ktor は自動的に index.html を検索します。 デフォルトページをカスタマイズする方法については、配信設定のカスタマイズ を参照してください。
その他のフレームワークについては、angular、vue、ember などの対応する関数を使用してください。
配信設定のカスタマイズ
リソースからシングルページアプリケーションを配信する方法を説明するために、アプリケーションが sample-web-app リソースパッケージ内に配置されており、次のような構造になっていると仮定します。
sample-web-app
├── main.html
├── ktor_logo.png
├── css
│ └──styles.css
└── js
└── script.jsこのアプリケーションを配信するには、以下の設定を使用します。
import io.ktor.server.application.*
import io.ktor.server.http.content.*
import io.ktor.server.routing.*
fun Application.module() {
routing {
singlePageApplication {
useResources = true
filesPath = "sample-web-app"
defaultPage = "main.html"
ignoreFiles { it.endsWith(".txt") }
}
}
}useResources: リソースパッケージからのアプリケーションの配信を有効にします。filesPath: アプリケーションが配置されているパスを指定します。defaultPage: 配信するデフォルトのリソースとしてmain.htmlを指定します。ignoreFiles: 末尾が.txtで終わるパスを無視します。
完全なサンプルは、こちらで確認できます: single-page-application
