服务单页应用程序

代码示例: single-page-application

Ktor 提供了服务单页应用程序（包括 React、Angular 或 Vue）的能力。

添加依赖项

要服务单页应用程序，你只需要 ktor-server-core 依赖项。不需要任何特定依赖项。

服务应用程序

要服务单页应用程序，你需要定义内容的来源：本地文件系统或类路径。你至少需要指定一个包含单页应用程序的文件夹/资源包。

服务特定框架的应用程序

你可以服务使用特定框架（例如 React、Angular、Vue 等）创建的单页应用程序的构建项。假设我们在项目根目录中有一个 react-app 文件夹，其中包含一个 React 应用程序。该应用程序具有以下结构，并以 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。