[kotlin] Ktor Locations 개요

26 Dec 2023

이 블로그 게시물에서는 Kotlin 기반의 Ktor 웹 프레임워크에서 Locations 기능에 대해 알아보겠습니다.

Locations란 무엇인가요?

Ktor 웹 프레임워크의 Locations는 URL 경로의 파라미터와 쿼리 매개변수를 쉽게 다룰 수 있도록 하는 기능입니다. 이를 사용하여 URL 경로와 쿼리 매개변수를 쉽게 파싱하고 생성할 수 있습니다.

Locations를 Ktor 앱에 설정하기 위해서는 내부 종속성을 추가하고 라우팅 엔진에 Locations 기능을 활성화해야 합니다. 먼저 build.gradle 파일에 다음 의존성을 추가합니다:

dependencies {
    implementation "io.ktor:ktor-locations:$ktor_version"
}

그리고 라우팅 설정에서 Locations 기능을 활성화합니다:

routing {
    location<SampleLocation> {
        handle {
            // handle location
        }
    }
}

사용자 정의 Locations 클래스를 작성하여 URL 경로의 파라미터와 쿼리 매개변수를 정의할 수 있습니다. 예를 들어:

@Location("/user/{id}")
data class UserLocation(val id: Int, val debug: Boolean = false)

위의 예시에서 UserLocation 클래스는 /user/{id} URL을 나타내며 id 파라미터와 debug 쿼리 매개변수를 정의합니다.

이제 Locations를 라우팅 엔진에 추가하고 요청을 처리하는 핸들러에서 해당 Locations를 사용하여 URL 파라미터와 쿼리 매개변수에 접근할 수 있습니다.