Skip to content
Server Plugin

DoubleReceive

필수 의존성: io.ktor:ktor-server-double-receive

코드 예제: double-receive

네이티브 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✅

DoubleReceive 플러그인은 RequestAlreadyConsumedException 예외 없이 요청 본문(request body)을 여러 번 수신할 수 있는 기능을 제공합니다. 이 기능은 다른 플러그인이 이미 요청 본문을 소비하여 라우트 핸들러 내에서 이를 수신할 수 없을 때 유용할 수 있습니다. 예를 들어, DoubleReceive을(를) 사용하면 CallLogging 플러그인으로 요청 본문을 로깅한 다음, post 라우트 핸들러 내에서 본문을 한 번 더 수신할 수 있습니다.

의존성 추가 ​

DoubleReceive을(를) 사용하려면 빌드 스크립트에 ktor-server-double-receive 아티팩트를 추가하세요.

kotlin
implementation(ktorLibs.server.doubleReceive)
위 코드 스니펫은 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.
groovy
implementation ktorLibs.server.doubleReceive
위 코드 스니펫은 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.
xml
<dependency>
    <groupId>io.ktor</groupId>
    <artifactId>ktor-server-double-receive-jvm</artifactId>
    <version>${ktor_version}</version>
</dependency>

DoubleReceive 설치 ​

애플리케이션에 DoubleReceive 플러그인을 설치하려면, 지정된 모듈모듈을 사용하면 라우트를 그룹화하여 애플리케이션의 구조를 설계할 수 있습니다.의 install 함수에 전달하세요. 다음 예제는 DoubleReceive을(를) 설치하는 방법을 보여줍니다:

  • embeddedServer() 함수 호출 내에서 설치.
  • Application 클래스에 명시적으로 정의된 module() 확장 함수 내에서 설치.
kotlin
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)
}
kotlin
import io.ktor.server.application.*
import io.ktor.server.plugins.doublereceive.*
// ...
fun Application.module() {
    install(DoubleReceive)
    // ...
}

DoubleReceive 플러그인은 특정 라우트에 설치할 수도 있습니다. 서로 다른 애플리케이션 리소스에 대해 서로 다른 DoubleReceive 설정이 필요한 경우 유용할 수 있습니다.

DoubleReceive을(를) 설치한 후에는 요청 본문을 여러 번 수신할 수 있으며, 호출할 때마다 동일한 인스턴스가 반환됩니다. 예를 들어, CallLogging 플러그인을 사용하여 요청 본문 로깅을 활성화하고...

kotlin
install(CallLogging) {
    level = Level.TRACE
    format { call ->
        runBlocking {
            "Body: ${call.receiveText()}"
        }
    }
}

... 그런 다음 라우트 핸들러 내에서 요청 본문을 한 번 더 가져올 수 있습니다.

kotlin
post("/") {
    val receivedText = call.receiveText()
    call.respondText("Text '$receivedText' is received")
}

전체 예제는 여기에서 확인할 수 있습니다: double-receive.

DoubleReceive 구성 ​

기본 구성을 사용할 경우, DoubleReceive은(는) 요청 본문을 다음과 같은 타입으로 수신할 수 있는 기능을 제공합니다:

  • ByteArray
  • String
  • Parameters
  • ContentNegotiation 플러그인에서 사용하는 데이터 클래스

기본적으로 DoubleReceive은(는) 다음 동작을 지원하지 않습니다:

동일한 요청에서 서로 다른 타입을 수신하거나 스트림 또는 채널을 수신할 필요가 없다면 cacheRawRequest 속성을 false로 설정하세요:

kotlin
install(DoubleReceive) {
    cacheRawRequest = false
}