Enrutamiento y parámetros tipados
Defina rutas con parámetros de ruta y de consulta, y agrúpelas mediante bloques route.
Enrutamiento y parámetros tipados es una lección gratuita de Kotlin Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Kotlin Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Kotlin Academy incluye 4 lecciones en total.
Conceptos básicos del enrutamiento en Ktor
El enrutamiento en Ktor es un complemento que se instala mediante install(Routing) { ... } o la forma abreviada routing { ... }. Las rutas se definen mediante funciones correspondientes a los métodos HTTP: get, post, put, delete, patch.
routing {
get("/hello") { call.respondText("Hello!") }
post("/items") { /* handle POST */ }
}Parámetros de ruta
Defina un parámetro de ruta mediante {name}. Acceda a él mediante call.parameters["name"]. El valor siempre es un String?:
get("/users/{id}") {
val id = call.parameters["id"] ?: return@get call.respondText("Missing id", status = HttpStatusCode.BadRequest)
call.respondText("User: $id")
}Segmentos de ruta opcionales
Marque un segmento como opcional añadiendo ?: {name?}. Si el segmento está ausente, call.parameters["name"] devuelve null.
get("/posts/{slug?}") {
val slug = call.parameters["slug"]
if (slug == null) call.respondText("All posts")
else call.respondText("Post: $slug")
}Conversión de parámetros a tipos
Convierta los parámetros de ruta a valores tipados mediante funciones de extensión sobre Parameters. Ktor proporciona funciones auxiliares integradas, aunque también puede escribir las suyas:
get("/items/{id}") {
val id = call.parameters["id"]?.toLongOrNull()
?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid id")
call.respondText("Item #$id")
}Parámetros de consulta
Acceda a los parámetros de la cadena de consulta mediante call.request.queryParameters["key"]. Los valores múltiples de una misma clave están disponibles mediante getAll("key"):
get("/search") {
val q = call.request.queryParameters["q"] ?: ""
val page = call.request.queryParameters["page"]?.toIntOrNull() ?: 1
call.respondText("Search: $q, page $page")
}Agrupación de rutas
Agrupe las rutas relacionadas bajo un prefijo común mediante route("/prefix") { ... }. Esto reduce la repetición y facilita la lectura del árbol de enrutamiento:
route("/api/v1") {
route("/users") {
get { /* list users */ }
get("/{id}") { /* get user by id */ }
post { /* create user */ }
}
}Organización de rutas en funciones
Extraiga los grupos de rutas en funciones de extensión sobre Route para mantener modular la configuración del enrutamiento:
fun Route.userRoutes() {
route("/users") {
get { /* ... */ }
post { /* ... */ }
get("/{id}") { /* ... */ }
}
}
// In Application module:
routing { userRoutes() }Gestión del cuerpo de la solicitud
Reciba el cuerpo de una solicitud como texto, bytes o un objeto deserializado (requiere el complemento ContentNegotiation). Utilice call.receive para la deserialización tipada:
post("/users") {
val user = call.receive<UserDto>()
call.respond(HttpStatusCode.Created, user)
}Respuesta con códigos de estado
Utilice call.respond(status, body) para tener un control total, o los métodos auxiliares 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)
}Rutas comodín y tailcard
Utilice * para un único segmento comodín y {...} (tailcard) para hacer coincidir el resto de la ruta como un único parámetro:
get("/static/{path...}") {
val filePath = call.parameters.getAll("path")?.joinToString("/") ?: ""
call.respondText("Serving: $filePath")
}Prioridades de las rutas
Ktor evalúa las rutas en el orden en que se declaran. Las rutas más específicas deben declararse antes que las rutas comodín. Cuando coinciden dos rutas, gana la primera coincidencia.
Comprobación rápida
¿Cómo se agrupan varias rutas bajo un prefijo de URL común en Ktor?
Recapitulación: enrutamiento y parámetros tipados
Conclusiones clave:
- Defina las rutas con
get,post, etc., dentro derouting { } - Parámetros de ruta:
{name}— acceda a ellos mediantecall.parameters["name"] - Parámetros de consulta:
call.request.queryParameters["key"] - Agrupe las rutas con
route("/prefix") { }y extráigalas a funciones de extensión sobreRoute - Reciba cuerpos tipados con
call.receive(requiere ContentNegotiation)()
Aprende Kotlin con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 51
- Lecciones
- 203
Preguntas frecuentes
¿La lección «Enrutamiento y parámetros tipados» es gratis?
Sí — el texto completo de «Enrutamiento y parámetros tipados» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Kotlin Academy, actualiza a CoddyKit PRO. El curso de Kotlin Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Enrutamiento y parámetros tipados»?
Defina rutas con parámetros de ruta y de consulta, y agrúpelas mediante bloques route. Practicas Kotlin Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Kotlin Academy?
No se requiere experiencia previa. Kotlin Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.
¿Cuánto tiempo toma la lección «Enrutamiento y parámetros tipados»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Kotlin Academy?
Sí. Cada lección de Kotlin Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Configuración de un proyecto Ktor: embeddedServer y módulos de aplicación
- Enrutamiento y parámetros tipados
- Negociación de contenido y kotlinx.serialization
- Plugins de autenticación: JWT y sesión