Skip to content
Server Plugin

Webjars

필수 의존성: io.ktor:ktor-server-webjars

코드 예제: webjars

네이티브 서버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 에셋을 서빙합니다. 아래 예제는 이를 변경하여 모든 WebJars 에셋을 /assets 경로에서 서빙하는 방법을 보여줍니다:

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.