DoubleReceive
필수 의존성: io.ktor:ktor-server-double-receive
코드 예제: double-receive
네이티브 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✅
DoubleReceive 플러그인은 RequestAlreadyConsumedException 예외 없이 요청 본문(request body)을 여러 번 수신할 수 있는 기능을 제공합니다. 이 기능은 다른 플러그인이 이미 요청 본문을 소비하여 라우트 핸들러 내에서 이를 수신할 수 없을 때 유용할 수 있습니다. 예를 들어, DoubleReceive을(를) 사용하면 CallLogging 플러그인으로 요청 본문을 로깅한 다음, post 라우트 핸들러 내에서 본문을 한 번 더 수신할 수 있습니다.
의존성 추가
DoubleReceive을(를) 사용하려면 빌드 스크립트에 ktor-server-double-receive 아티팩트를 추가하세요.
implementation(ktorLibs.server.doubleReceive)implementation ktorLibs.server.doubleReceive<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-server-double-receive-jvm</artifactId>
<version>${ktor_version}</version>
</dependency>DoubleReceive 설치
애플리케이션에 DoubleReceive 플러그인을 설치하려면, 지정된 모듈모듈을 사용하면 라우트를 그룹화하여 애플리케이션의 구조를 설계할 수 있습니다.의 install 함수에 전달하세요. 다음 예제는 DoubleReceive을(를) 설치하는 방법을 보여줍니다:
embeddedServer()함수 호출 내에서 설치.Application클래스에 명시적으로 정의된module()확장 함수 내에서 설치.
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.plugins.doublereceive.*
fun main() {
embeddedServer(Netty, port = 8080) {
install(DoubleReceive)
// ...
}.start(wait = true)
}import io.ktor.server.application.*
import io.ktor.server.plugins.doublereceive.*
// ...
fun Application.module() {
install(DoubleReceive)
// ...
}DoubleReceive 플러그인은 특정 라우트에 설치할 수도 있습니다. 서로 다른 애플리케이션 리소스에 대해 서로 다른 DoubleReceive 설정이 필요한 경우 유용할 수 있습니다.
DoubleReceive을(를) 설치한 후에는 요청 본문을 여러 번 수신할 수 있으며, 호출할 때마다 동일한 인스턴스가 반환됩니다. 예를 들어, CallLogging 플러그인을 사용하여 요청 본문 로깅을 활성화하고...
install(CallLogging) {
level = Level.TRACE
format { call ->
runBlocking {
"Body: ${call.receiveText()}"
}
}
}... 그런 다음 라우트 핸들러 내에서 요청 본문을 한 번 더 가져올 수 있습니다.
post("/") {
val receivedText = call.receiveText()
call.respondText("Text '$receivedText' is received")
}전체 예제는 여기에서 확인할 수 있습니다: double-receive.
DoubleReceive 구성
기본 구성을 사용할 경우, DoubleReceive은(는) 요청 본문을 다음과 같은 타입으로 수신할 수 있는 기능을 제공합니다:
ByteArrayStringParametersContentNegotiation플러그인에서 사용하는 데이터 클래스
기본적으로 DoubleReceive은(는) 다음 동작을 지원하지 않습니다:
- 동일한 요청에서 서로 다른 타입을 수신하는 것
- 스트림 또는 채널을 수신하는 것
동일한 요청에서 서로 다른 타입을 수신하거나 스트림 또는 채널을 수신할 필요가 없다면 cacheRawRequest 속성을 false로 설정하세요:
install(DoubleReceive) {
cacheRawRequest = false
}