기본 헤더
필요한 의존성: io.ktor:ktor-server-default-headers
네이티브 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✅
DefaultHeaders 플러그인은 각 응답에 표준 Server 및 Date 헤더를 추가합니다. 또한 추가적인 기본 헤더를 제공하고 Server 헤더를 재정의할 수 있습니다.
의존성 추가
DefaultHeaders을(를) 사용하려면 빌드 스크립트에 ktor-server-default-headers 아티팩트를 추가합니다:
implementation(ktorLibs.server.defaultHeaders)implementation ktorLibs.server.defaultHeaders<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-server-default-headers-jvm</artifactId>
<version>${ktor_version}</version>
</dependency>DefaultHeaders 설치
애플리케이션에 DefaultHeaders 플러그인을 설치하려면 지정된 모듈모듈을 사용하면 라우트를 그룹화하여 애플리케이션의 구조를 설계할 수 있습니다.의 install 함수에 전달하세요. 다음 예제는 DefaultHeaders을(를) 설치하는 방법을 보여줍니다:
embeddedServer()함수 호출 내에서 설치.Application클래스에 명시적으로 정의된module()확장 함수 내에서 설치.
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.plugins.defaultheaders.*
fun main() {
embeddedServer(Netty, port = 8080) {
install(DefaultHeaders)
// ...
}.start(wait = true)
}import io.ktor.server.application.*
import io.ktor.server.plugins.defaultheaders.*
// ...
fun Application.module() {
install(DefaultHeaders)
// ...
}DefaultHeaders 플러그인은 특정 라우트에 설치할 수도 있습니다. 애플리케이션의 서로 다른 리소스에 대해 각기 다른 DefaultHeaders 설정이 필요한 경우에 유용합니다.
DefaultHeaders 구성
추가 헤더 추가
기본 헤더 목록을 커스터마이징하려면 header(name, value) 함수를 사용하여 원하는 헤더를 install 블록에 전달합니다. name 매개변수는 HttpHeaders 값을 받습니다. 예를 들면 다음과 같습니다:
install(DefaultHeaders) {
header(HttpHeaders.ETag, "7c876b7e")
}커스텀 헤더를 추가하려면 헤더 이름을 문자열 값으로 전달합니다:
install(DefaultHeaders) {
header("Custom-Header", "Some value")
}헤더 재정의
Server 헤더를 재정의하려면 해당하는 HttpHeaders 값을 사용합니다:
install(DefaultHeaders) {
header(HttpHeaders.Server, "Custom")
}Date 헤더는 성능상의 이유로 캐시되므로 DefaultHeaders을(를) 사용하여 재정의할 수 없습니다.
