Webjars
필수 의존성: io.ktor:ktor-server-webjars
코드 예제: webjars
네이티브 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✖️
Webjars 플러그인은 WebJars에서 제공하는 클라이언트 측 라이브러리를 서빙할 수 있도록 해줍니다. JavaScript 및 CSS 라이브러리와 같은 에셋을 fat JAR의 일부로 패키징할 수 있습니다.
의존성 추가
Webjars을 활성화하려면 빌드 스크립트에 다음 아티팩트를 포함해야 합니다:
ktor-server-webjars의존성 추가:kotlinimplementation(ktorLibs.server.webjars)위 코드 스니펫에서는 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.groovyimplementation ktorLibs.server.webjars위 코드 스니펫에서는 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.xml<dependency> <groupId>io.ktor</groupId> <artifactId>ktor-server-webjars-jvm</artifactId> <version>${ktor_version}</version> </dependency>필요한 클라이언트 측 라이브러리에 대한 의존성을 추가합니다. 아래 예제는 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()확장 함수 내에서 설치.
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)
}import io.ktor.server.application.*
import io.ktor.server.webjars.*
// ...
fun Application.module() {
install(Webjars)
// ...
}Webjars 구성
기본적으로 Webjars은 /webjars 경로에서 WebJars 에셋을 서빙합니다. 아래 예제는 이를 변경하여 모든 WebJars 에셋을 /assets 경로에서 서빙하는 방법을 보여줍니다:
import io.ktor.server.application.*
import io.ktor.server.webjars.*
fun Application.module() {
install(Webjars) {
path = "assets"
}
}예를 들어, org.webjars:bootstrap 의존성을 설치했다면 다음과 같이 bootstrap.css를 추가할 수 있습니다:
<head>
<link rel="stylesheet" href="/assets/bootstrap/bootstrap.css">
</head>Webjars을 사용하면 의존성을 로드하는 데 사용되는 경로를 변경하지 않고도 의존성 버전을 변경할 수 있습니다.
전체 예제는 여기에서 확인할 수 있습니다: webjars.
