Ktor는 Kotlin으로 작성된 웹 애플리케이션을 빌드하기 위한 프레임워크로, 경로와 쿼리 매개변수를 쉽게 다룰 수 있는 Location 라이브러리를 제공합니다.

Location 라이브러리란?

Location은 URI 경로 및 쿼리 매개변수에 대한 추상화된 표현을 제공하는 라이브러리입니다. Ktor에서는 call 객체를 이용하여 현재 요청에 대한 Location을 획득하고 다양한 속성을 편리하게 접근할 수 있도록 도와줍니다.

import io.ktor.locations.*
import io.ktor.application.*
import io.ktor.response.*
import io.ktor.routing.*

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

위의 코드처럼 @Location 어노테이션을 사용하여 Location을 정의할 수 있습니다. 이를 통해 요청 경로의 특정 부분을 매개변수화하고, 해당 값에 접근할 수 있게 됩니다.

</br>

Location 라이브러리 사용하기

우선 Location을 이용하여 경로와 쿼리 매개변수에 접근하기 위해 아래와 같이 application 레벨에서 해당 모듈을 등록해야 합니다.

install(Locations)

그 후 다음과 같이 call 객체를 통해 Location을 사용할 수 있습니다.

get<UserLocation> { location ->
    val userId = location.id
    call.respondText("User ID: $userId")
}

위의 코드에서 get<UserLocation>은 Location 타입에 대한 라우팅을 설정하는 것을 의미합니다. 그리고 해당 경로로 요청이 오면 URI에서 id 값을 추출하여 응답으로 제공하는 예시입니다.

</br>

마치며

Ktor Location 라이브러리를 사용하면 URI 경로와 쿼리 매개변수를 다루기 편리해집니다. 해당 라이브러리를 이용해서 라우팅 로직을 쉽게 구현할 수 있으며, 코드의 가독성과 유지보수성을 높일 수 있습니다.

위에서 소개된 기능들을 참고하여 효과적으로 활용해 보시기 바랍니다.

참고문헌