Server Plugin
Webjars
必要相依性:io.ktor:ktor-server-webjars
程式碼範例: webjars
Native 伺服器Ktor 支援 Kotlin/Native,可讓您在無需額外執行階段或虛擬機的情況下執行伺服器。支援:✖️
Webjars 外掛程式能夠提供 WebJars 所提供的用戶端程式庫。它允許您將 JavaScript 與 CSS 程式庫等資源封裝為 fat JAR 的一部分。
新增相依性
若要啟用 Webjars,您需要在建置指令碼中包含以下構件:
新增
ktor-server-webjars相依性:新增所需用戶端程式庫的相依性。以下範例展示如何新增 Bootstrap 構件:
kotlinimplementation("org.webjars:bootstrap:$bootstrap_version")groovyimplementation "org.webjars:bootstrap:$bootstrap_version"xml<dependency> <groupId>org.webjars</groupId> <artifactId>bootstrap</artifactId> <version>${bootstrap_version}</version> </dependency>您可以將
$bootstrap_version替換為所需的bootstrap構件版本,例如5.2.3。
安裝 Webjars
若要將 Webjars 外掛程式安裝到您的應用程式中,請將其傳遞給指定模組模組可讓您透過對路由進行分組來建構應用程式。中的 install 函式。 以下範例展示如何安裝 Webjars:
- 在
embeddedServer()函式呼叫中。 - 在
Application類別上明確定義的module()擴充函式中。
kotlin
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.webjars.*
fun main() {
embeddedServer(Netty, port = 8080) {
install(Webjars)
// ...
}.start(wait = true)
}kotlin
import io.ktor.server.application.*
import io.ktor.server.webjars.*
// ...
fun Application.module() {
install(Webjars)
// ...
}設定 Webjars
預設情況下,Webjars 會在 /webjars 路徑上提供 WebJars 資源。以下範例展示如何變更此設定,並在 /assets 路徑上提供任何 WebJars 資源:
kotlin
import io.ktor.server.application.*
import io.ktor.server.webjars.*
fun Application.module() {
install(Webjars) {
path = "assets"
}
}例如,若您已安裝 org.webjars:bootstrap 相依性,可以按照以下方式新增 bootstrap.css:
html
<head>
<link rel="stylesheet" href="/assets/bootstrap/bootstrap.css">
</head>請注意,Webjars 允許您變更相依性的版本,而無需變更用於載入它們的路徑。
您可以在此處找到完整範例:webjars。
