Kotlin Academy · 강의

라우팅과 타입이 지정된 매개변수

경로 및 쿼리 매개변수가 있는 경로를 정의하고 route 블록으로 그룹화해 보세요.

라우팅과 타입이 지정된 매개변수은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Ktor 라우팅 기초

Ktor의 라우팅은 install(Routing) { ... }을 통해 설치하는 플러그인이거나, routing { ... }이라는 약식 표기입니다. 라우트는 HTTP 메서드 함수인 get, post, put, delete, patch를 사용하여 정의합니다.

routing {
    get("/hello") { call.respondText("Hello!") }
    post("/items") { /* handle POST */ }
}

경로 매개변수

{name}을 사용하여 경로 매개변수를 정의합니다. call.parameters["name"]을 통해 액세스합니다. 값은 항상 String?입니다:

get("/users/{id}") {
    val id = call.parameters["id"] ?: return@get call.respondText("Missing id", status = HttpStatusCode.BadRequest)
    call.respondText("User: $id")
}

선택적 경로 세그먼트

?를 추가하여 세그먼트를 선택 사항으로 표시합니다: {name?}. 세그먼트가 없으면 call.parameters["name"]이 null을 반환합니다.

get("/posts/{slug?}") {
    val slug = call.parameters["slug"]
    if (slug == null) call.respondText("All posts")
    else call.respondText("Post: $slug")
}

유형이 지정된 매개변수 변환

Parameters의 확장 함수를 사용하여 경로 매개변수를 유형이 지정된 값으로 변환합니다. Ktor는 기본 제공 도우미를 제공하며, 직접 작성할 수도 있습니다:

get("/items/{id}") {
    val id = call.parameters["id"]?.toLongOrNull()
        ?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid id")
    call.respondText("Item #$id")
}

쿼리 매개변수

call.request.queryParameters["key"]를 통해 쿼리 문자열 매개변수에 액세스합니다. 동일한 키에 대한 여러 값은 getAll("key")을 통해 사용할 수 있습니다:

get("/search") {
    val q = call.request.queryParameters["q"] ?: ""
    val page = call.request.queryParameters["page"]?.toIntOrNull() ?: 1
    call.respondText("Search: $q, page $page")
}

라우트 그룹화

route("/prefix") { ... }를 사용하여 관련 라우트를 공통 접두사 아래에 그룹화합니다. 이렇게 하면 반복을 줄이고 라우팅 트리를 읽기 쉽게 만들 수 있습니다:

route("/api/v1") {
    route("/users") {
        get { /* list users */ }
        get("/{id}") { /* get user by id */ }
        post { /* create user */ }
    }
}

함수로 라우트 구성하기

라우팅 구성을 모듈식으로 유지하려면 라우트 그룹을 Route의 확장 함수로 추출합니다:

fun Route.userRoutes() {
    route("/users") {
        get { /* ... */ }
        post { /* ... */ }
        get("/{id}") { /* ... */ }
    }
}

// In Application module:
routing { userRoutes() }

요청 본문 처리하기

요청 본문을 텍스트, 바이트 또는 역직렬화된 객체로 받습니다(ContentNegotiation 플러그인이 필요함). 유형이 지정된 역직렬화에는 call.receive<T>()를 사용합니다:

post("/users") {
    val user = call.receive<UserDto>()
    call.respond(HttpStatusCode.Created, user)
}

상태 코드로 응답하기

세밀하게 제어하려면 call.respond(status, body)를 사용하고, 간편한 메서드로는 call.respondText(), call.respondFile(), call.respond(HttpStatusCode.NotFound)를 사용합니다:

get("/users/{id}") {
    val user = userRepo.find(call.parameters["id"])
    if (user == null) call.respond(HttpStatusCode.NotFound)
    else call.respond(user)
}

와일드카드 및 테일카드 라우트

단일 와일드카드 세그먼트에는 *를 사용하고, {...}(테일카드)를 사용하여 경로의 나머지 부분을 하나의 매개변수로 일치시킵니다:

get("/static/{path...}") {
    val filePath = call.parameters.getAll("path")?.joinToString("/") ?: ""
    call.respondText("Serving: $filePath")
}

라우트 우선순위

Ktor는 선언 순서대로 라우트를 평가합니다. 더 구체적인 라우트를 와일드카드보다 먼저 선언해야 합니다. 두 라우트가 일치하면 먼저 일치한 라우트가 선택됩니다.

빠른 확인

Ktor에서 여러 라우트를 공통 URL 접두사 아래에 그룹화하려면 어떻게 해야 합니까?

복습: 라우팅 및 유형이 지정된 매개변수

핵심 요점:

routing { } 내부에서 get, post 등을 사용하여 라우트를 정의합니다
경로 매개변수: {name} — call.parameters["name"]을 통해 액세스합니다
쿼리 매개변수: call.request.queryParameters["key"]
route("/prefix") { }로 라우트를 그룹화하고 Route의 확장 함수로 추출합니다
call.receive<T>()로 유형이 지정된 본문을 받습니다(ContentNegotiation 필요)

자주 묻는 질문

“라우팅과 타입이 지정된 매개변수” 강의는 무료인가요?

네 — “라우팅과 타입이 지정된 매개변수” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“라우팅과 타입이 지정된 매개변수”에서 뭘 배우나요?

경로 및 쿼리 매개변수가 있는 경로를 정의하고 route 블록으로 그룹화해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“라우팅과 타입이 지정된 매개변수” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기