[kotlin] Ktor Location 라이브러리 사용법

21 Dec 2023

kotlin

Ktor에서 제공되는 Location 라이브러리는 HTTP 리디렉션과 같은 작업을 더 쉽게 처리할 수 있게 도와줍니다. 이 라이브러리를 사용하여 클라이언트 요청을 다른 경로로 리디렉션하거나 리소스를 찾을 수 없을 때 발생하는 404 오류를 처리할 수 있습니다. 이제 Location 라이브러리를 어떻게 사용하는지 알아보겠습니다.

의존성 추가

먼저, build.gradle 또는 build.gradle.kts 파일에 다음의 의존성을 추가합니다.

implementation("io.ktor:ktor-locations:$ktor_version")

의존성을 추가한 후 프로젝트를 다시 빌드합니다.

Location 객체 생성

Location은 클라이언트 리디렉션을 나타내는 클래스입니다. Location 객체를 생성하고 리디렉션할 경로를 설정하는 예제는 다음과 같습니다.

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

@Location("/home")
class Home

@Location("/about")
class About

fun Application.main() {
    install(Locations)
    
    routing {
        get<Home> {
            call.respondText("This is the home page")
        }
        get<About> {
            call.respondText("This is the about page")
        }
        get("/redirect") {
            val location = call.resolve<Home>()
            call.respondRedirect(location?.href() ?: "/", false)
        }
    }
}

위 예제에서는 클라이언트가 /home 또는 /about 경로에 접근하면 해당 페이지를 보여줍니다. 그리고 /redirect 경로로 접근하면 Home 경로로 리디렉션합니다.

Location 경로 매개변수

Location을 사용할 때 경로 매개변수를 전달하여 동적인 경로를 처리할 수도 있습니다. 아래는 경로 매개변수를 사용하는 예제입니다.

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

routing {
    get<User> { user ->
        val id = user.id
        // 해당 id에 해당하는 사용자 정보 반환
    }
}

위의 예제에서는 /user/1, /user/2와 같은 경로로의 접속 시, 해당하는 사용자 정보를 반환합니다.

마무리

Ktor Location 라이브러리를 사용하여 클라이언트 리디렉션 및 경로 기반 요청 처리를 쉽게 구현할 수 있습니다. 위와 같이 Location 객체를 생성하여 경로 및 매개변수를 다루면서 유연한 웹 어플리케이션을 개발할 수 있습니다.

더 많은 자세한 내용은 Ktor 공식 문서를 참고하세요.