[kotlin] Ktor 클라이언트 라이브러리의 테스트 방법

22 Dec 2023

kotlin

Kotlin의 Ktor는 경량화된 오픈 소스 웹 프레임워크이며, 클라이언트 라이브러리를 사용하여 HTTP 통신을 처리할 수 있습니다. Ktor 클라이언트의 유연성과 모듈화로 인해 테스트 작성이 쉽습니다. 이번 글에서는 Ktor 클라이언트 라이브러리의 테스트 방법을 소개합니다.

Ktor 클라이언트 테스트 환경 설정

Ktor 클라이언트 라이브러리를 사용하여 HTTP 요청을 테스트하려면 아래와 같은 종속성을 Gradle 또는 Maven 프로젝트에 추가해야 합니다.

Gradle:

testImplementation("io.ktor:ktor-client-mock-common:{version}")

Maven:

<dependency>
    <groupId>io.ktor</groupId>
    <artifactId>ktor-client-mock-common</artifactId>
    <version>{version}</version>
</dependency>

위에서 {version}은 사용 중인 Ktor 버전에 맞게 바꿔주어야 합니다.

Ktor 클라이언트 테스트 작성

다음은 Ktor 클라이언트 라이브러리를 사용하여 HTTP GET 요청을 테스트하는 예제 코드입니다.

import io.ktor.client.HttpClient
import io.ktor.client.engine.mock.MockEngine
import io.ktor.client.engine.mock.respond
import io.ktor.client.request.get
import io.ktor.client.request.HttpRequestBuilder
import io.ktor.http.HttpStatusCode
import kotlinx.coroutines.runBlocking
import kotlin.test.Test
import kotlin.test.assertEquals

class KtorClientTest {
    @Test
    fun testHttpGetRequest() = runBlocking {
        val client = HttpClient(MockEngine) {
            engine {
                addHandler { request ->
                    when (request.url.fullPath) {
                        "/api/data" -> {
                            respond("{'result': 'success'}", HttpStatusCode.OK)
                        }
                        else -> error("Unhandled ${request.url.fullPath}")
                    }
                }
            }
        }

        val response = client.get<String> {
            url {
                protocol = URLProtocol.HTTP
                host = "example.com"
                encodedPath = "/api/data"
            }
        }

        assertEquals("{'result': 'success'}", response)

        client.close()
    }
}

위의 예제 코드는 Ktor 클라이언트 라이브러리를 사용하여 HTTP GET 요청을 테스트하는 방법을 보여줍니다. HttpClient를 사용하여 MockEngine으로 가짜 응답을 설정하고, 실제 요청과 응답을 확인하기 위해 runBlocking 내에서 테스트를 실행합니다.

결론

Ktor 클라이언트는 간단하고 직관적인 방법으로 HTTP 요청을 테스트할 수 있게 해줍니다. 위의 예제 코드를 참고하여 원하는 요청과 응답에 대한 테스트를 쉽게 작성할 수 있습니다. Ktor 공식 문서나 개발자 커뮤니티의 추가 자료를 참고하면 더 많은 정보를 얻을 수 있습니다.