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
    Groovy
    XML
  • 필요한 클라이언트 측 라이브러리에 대한 의존성을 추가합니다. 아래 예제는 Bootstrap 아티팩트를 추가하는 방법을 보여줍니다:

    Kotlin
    Groovy
    XML

    $bootstrap_version을 필요한 bootstrap 아티팩트 버전(예: 5.2.3)으로 교체할 수 있습니다.

Webjars 설치

애플리케이션에 Webjars 플러그인을 설치하려면, 지정된

모듈
모듈을 사용하면 경로를 그룹화하여 애플리케이션을 구성할 수 있습니다.
install 함수에 전달하십시오. 아래 코드 스니펫은 Webjars을 설치하는 방법을 보여줍니다...

  • ... embeddedServer 함수 호출 내부에서.
  • ... Application 클래스의 확장 함수인 명시적으로 정의된 module 내부에서.
kotlin
kotlin

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.