[kotlin] Ktor Location 라이브러리를 활용한 웹소켓 통신

21 Dec 2023

kotlin

이 포스트에서는 Ktor Location 라이브러리를 활용하여 클라이언트와 서버 간의 웹소켓 통신을 구현하는 방법에 대해 알아보겠습니다.

Ktor Location 라이브러리란?

Ktor는 Kotlin으로 작성된 멀티 플랫폼 HTTP 클라이언트 및 서버 프레임워크이며, Location은 Ktor의 요청 경로를 파싱하고 생성하기 위한 라이브러리입니다. 이를 활용하여 경로에 따라 적합한 웹소켓 핸들러를 호출할 수 있습니다.

웹소켓 통신 구현하기

1. Ktor 및 Ktor Location 라이브러리 의존성 추가하기

// build.gradle.kts

dependencies {
    implementation("io.ktor:ktor-server-core:1.6.5")
    implementation("io.ktor:ktor-server-netty:1.6.5")
    implementation("io.ktor:ktor-websockets:1.6.5")
    implementation("io.ktor:ktor-locations:1.6.5")
}

2. 웹소켓 핸들러 정의하기

import io.ktor.websocket.*

class ChatHandler : WebSocketHandler {
    override suspend fun onConnect(session: WebSocketSession) {
        // 클라이언트 연결 시 처리 로직
    }

    override suspend fun onMessage(session: WebSocketSession, text: String) {
        // 메시지 수신 시 처리 로직
    }

    override suspend fun onClose(session: WebSocketSession, closeReason: CloseReason) {
        // 클라이언트 해제 시 처리 로직
    }
}

3. 경로에 따른 핸들러 연결하기

import io.ktor.locations.*

@Location("/chat")
class ChatLocation

fun Route.webSocketHandlers() {
    webSocket("/chat", handler = ChatHandler())
}

위 예제에서 ChatLocation과 ChatHandler를 정의하고, ChatLocation을 경로로 사용하여 ChatHandler를 연결합니다.

Ktor Location 라이브러리를 사용하면 요청 경로에 따라 적절한 핸들러를 호출하는 기능을 손쉽게 구현할 수 있습니다.

이렇게 Ktor Location 라이브러리를 활용하여 웹소켓 통신을 구현할 수 있습니다. 추가적인 코드 및 사용 방법은 Ktor 공식 문서를 참고하세요.