Skip to content
Server Plugin

Webjars

必要相依性:io.ktor:ktor-server-webjars

程式碼範例: webjars

Native 伺服器Ktor 支援 Kotlin/Native,可讓您在無需額外執行階段或虛擬機的情況下執行伺服器。支援:✖️

Webjars 外掛程式能夠提供 WebJars 所提供的用戶端程式庫。它允許您將 JavaScript 與 CSS 程式庫等資源封裝為 fat JAR 的一部分。

新增相依性 ​

若要啟用 Webjars,您需要在建置指令碼中包含以下構件:

  • 新增 ktor-server-webjars 相依性:

    kotlin
    implementation(ktorLibs.server.webjars)
    上述程式碼片段使用 Ktor 版本目錄來指定 Ktor 相依性。
    groovy
    implementation ktorLibs.server.webjars
    上述程式碼片段使用 Ktor 版本目錄來指定 Ktor 相依性。
    xml
    <dependency>
        <groupId>io.ktor</groupId>
        <artifactId>ktor-server-webjars-jvm</artifactId>
        <version>${ktor_version}</version>
    </dependency>
  • 新增所需用戶端程式庫的相依性。以下範例展示如何新增 Bootstrap 構件:

    kotlin
    implementation("org.webjars:bootstrap:$bootstrap_version")
    groovy
    implementation "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。