[kotlin] Ktor Location 라이브러리와 RESTful API 연동

21 Dec 2023

kotlin

이번에는 Ktor의 이전 문제를 해결하고 애플리케이션의 RESTful API와 상호작용하기 위해 Ktor의 Location 라이브러리를 사용하는 방법에 대해 설명하겠습니다.

1. Ktor과 Location 라이브러리

Ktor은 Kotlin으로 작성된 웹 프레임워크로, 경량이면서도 풍부한 기능을 제공합니다. Location 라이브러리는 Ktor에서 경로 및 쿼리 매개변수를 처리하기 위한 도우미 라이브러리로 유용하게 활용됩니다.

2. Location 라이브러리를 이용한 RESTful API 호출

Location 라이브러리를 사용하여 RESTful API 호출을 처리하는 예시를 살펴보겠습니다.

import io.ktor.application.*
import io.ktor.client.features.*
import io.ktor.client.request.*
import io.ktor.locations.*
import io.ktor.routing.*
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.client.statement.*

@Location("/api/user/{id}")
data class UserLocation(val id: Int)

fun Route.userApi() {
    get<UserLocation> { userLocation -> 
        val user = getUserFromApi(userLocation.id)
        call.respond(user)
    }
}

fun main() {
    embeddedServer(Netty, port = 8080) {
        install(Locations)
        install(DefaultHeaders)
        routing {
            userApi()
        }
    }.start(wait = true)
}

suspend fun getUserFromApi(userId: Int): String {
    val client = HttpClient {
        install(HttpTimeout) {
            requestTimeoutMillis = 5000
            connectTimeoutMillis = 5000
            socketTimeoutMillis = 5000
        }
    }
    val response: String = client.get("https://api.example.com/users/$userId")
    client.close()
    return response
}

위의 예시는 Location 라이브러리를 사용하여 RESTful API로부터 사용자 정보를 가져오는 간단한 예제입니다.

3. 결론

Ktor의 Location 라이브러리는 경로와 쿼리 매개변수를 관리하면서 RESTful API와의 상호작용을 쉽게 처리할 수 있도록 도와줍니다. 앞으로 Location 라이브러리를 활용하여 Kotlin 기반의 RESTful API 호출을 보다 효율적으로 처리할 수 있을 것입니다.

참고 자료

Ktor 공식 문서: https://ktor.io/docs/locations.html
Kotlin 공식 문서: https://kotlinlang.org/docs/home.html