提供單頁應用程式
程式碼範例: single-page-application
Ktor 提供了提供單頁應用程式的功能,包括 React、Angular 或 Vue。
新增相依性
若要提供單頁應用程式,你只需要 ktor-server-core 相依性。 不需要任何其他特定的相依性。
提供應用程式
若要提供單頁應用程式,你需要定義要從何處提供內容:本機檔案系統或類別路徑(classpath)。 你至少需要指定包含單頁應用程式的資料夾/資源套件。
提供特定框架的應用程式
你可以提供使用特定架構(例如 React、Angular、Vue 等)建立的單頁應用程式組建產物。 假設我們在專案根目錄中有一個包含 React 應用程式的 react-app 資料夾。 該應用程式具有以下結構,並以 index.html 檔案作為主頁面:
text
react-app
├── index.html
├── ...
└── static
└── ...若要提供此應用程式,請在 routing 區塊內呼叫 singlePageApplication,並將資料夾名稱傳遞給 react 函式:
kotlin
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 等。
自訂提供設定
為了示範如何從資源(resources)中提供單頁應用程式,假設我們的應用程式放置在 sample-web-app 資源套件中,其結構如下:
text
sample-web-app
├── main.html
├── ktor_logo.png
├── css
│ └──styles.css
└── js
└── script.js若要提供此應用程式,請使用以下配置:
kotlin
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。
