Ktor 클라이언트에서의 웹소켓 직렬화
[ContentNegotiation](client-serialization.md) 플러그인과 유사하게, 웹소켓(WebSockets)은 특정 형식으로 텍스트 프레임(text frames)을 직렬화/역직렬화할 수 있도록 합니다. Ktor 클라이언트는 다음 형식을 기본으로(out-of-the-box) 지원합니다: JSON, XML, CBOR, ProtoBuf.
의존성 추가
kotlinx.serialization 컨버터를 사용하기 전에, [Setup](https://github.com/Kotlin/kotlinx.serialization#setup) 섹션에 설명된 대로 Kotlin 직렬화 플러그인을 추가해야 합니다.
JSON
JSON 데이터를 직렬화/역직렬화하려면, 다음 라이브러리 중 하나를 선택할 수 있습니다: kotlinx.serialization, Gson, 또는 Jackson.
빌드 스크립트에 ktor-serialization-kotlinx-json 아티팩트를 추가하세요:
빌드 스크립트에 ktor-serialization-gson 아티팩트를 추가하세요:
빌드 스크립트에 ktor-serialization-jackson 아티팩트를 추가하세요:
XML
XML을 직렬화/역직렬화하려면 빌드 스크립트에 ktor-serialization-kotlinx-xml을 추가하세요:
참고: XML 직렬화는
jsNode타겟에서 지원되지 않습니다.
CBOR
CBOR을 직렬화/역직렬화하려면 빌드 스크립트에 ktor-serialization-kotlinx-cbor을 추가하세요:
ProtoBuf
ProtoBuf를 직렬화/역직렬화하려면 빌드 스크립트에 ktor-serialization-kotlinx-protobuf를 추가하세요:
직렬 변환기 구성
JSON 직렬 변환기
웹소켓 [configuration](client-websockets.topic#install_plugin)에 JSON 직렬 변환기를 등록하려면, Json 매개변수를 사용하여 KotlinxWebsocketSerializationConverter 인스턴스를 생성하고, 이 인스턴스를 contentConverter 속성에 할당하세요:
import io.ktor.serialization.kotlinx.*
import kotlinx.serialization.json.*
val client = HttpClient(CIO) {
install(WebSockets) {
contentConverter = KotlinxWebsocketSerializationConverter(Json)
}
}Gson 직렬 변환기를 등록하려면, GsonWebsocketContentConverter를 contentConverter 속성에 할당하세요:
import io.ktor.serialization.gson.*
install(WebSockets) {
contentConverter = GsonWebsocketContentConverter()
}Jackson 직렬 변환기를 등록하려면, JacksonWebsocketContentConverter를 contentConverter 속성에 할당하세요:
import io.ktor.serialization.jackson.*
install(WebSockets) {
contentConverter = JacksonWebsocketContentConverter()
}XML 직렬 변환기
웹소켓 [configuration](client-websockets.topic#install_plugin)에 XML 직렬 변환기를 등록하려면, XML 매개변수를 사용하여 KotlinxWebsocketSerializationConverter 인스턴스를 생성하고, 이 인스턴스를 contentConverter 속성에 할당하세요:
import nl.adaptivity.xmlutil.serialization.*
install(WebSockets) {
contentConverter = KotlinxWebsocketSerializationConverter(XML)
}CBOR 직렬 변환기
웹소켓 [configuration](client-websockets.topic#install_plugin)에 CBOR 직렬 변환기를 등록하려면, Cbor 매개변수를 사용하여 KotlinxWebsocketSerializationConverter 인스턴스를 생성하고, 이 인스턴스를 contentConverter 속성에 할당하세요:
import io.ktor.serialization.kotlinx.cbor.*
install(WebSockets) {
contentConverter = KotlinxWebsocketSerializationConverter(Cbor)
}ProtoBuf 직렬 변환기
웹소켓 [configuration](client-websockets.topic#install_plugin)에 ProtoBuf 직렬 변환기를 등록하려면, ProtoBuf 매개변수를 사용하여 KotlinxWebsocketSerializationConverter 인스턴스를 생성하고, 이 인스턴스를 contentConverter 속성에 할당하세요:
import io.ktor.serialization.kotlinx.protobuf.*
install(WebSockets) {
contentConverter = KotlinxWebsocketSerializationConverter(ProtoBuf)
}데이터 수신 및 전송
데이터 클래스 생성
텍스트 프레임을 객체로/객체에서 직렬화/역직렬화하려면, 데이터 클래스를 생성해야 합니다. 예를 들어:
data class Customer(val id: Int, val firstName: String, val lastName: String)kotlinx.serialization을 사용하는 경우, 이 클래스에 @Serializable 어노테이션이 있는지 확인하세요:
@Serializable
data class Customer(val id: Int, val firstName: String, val lastName: String)kotlinx.serialization에 대해 더 알아보려면, [Kotlin Serialization Guide](https://github.com/Kotlin/kotlinx.serialization/blob/master/docs/serialization-guide.md)를 참조하세요.
데이터 전송
[지정된 형식](#configure_serializer)으로 텍스트 프레임 내에서 [클래스 인스턴스](#create_data_class)를 전송하려면, sendSerialized 함수를 사용하세요:
client.webSocket(method = HttpMethod.Get, host = "127.0.0.1", port = 8080, path = "/customer") {
sendSerialized(Customer(1, "Jane", "Smith"))
}데이터 수신
텍스트 프레임의 내용을 수신하고 변환하려면, 데이터 클래스를 매개변수로 받는 receiveDeserialized 함수를 호출하세요:
client.webSocket(method = HttpMethod.Get, host = "127.0.0.1", port = 8080, path = "/customer/1") {
val customer = receiveDeserialized<Customer>()
println("A customer with id ${customer.id} is received by the client.")
}[incoming](client-websockets.topic#incoming) 채널에서 역직렬화된 프레임을 수신하려면, [WebsocketContentConverter.deserialize](https://api.ktor.io/ktor-shared/ktor-serialization/io.ktor.serialization/-websocket-content-converter/deserialize.html) 함수를 사용하세요. WebsocketContentConverter는 DefaultClientWebSocketSession.converter 속성을 통해 사용할 수 있습니다.
전체 예시는 여기에서 찾을 수 있습니다: client-websockets-serialization.