Datos en la petición
Una petición puede traer datos en tres lugares. En la ruta:
/pedidos/15, y lo lees con @PathVariable. Spring convierte el texto al tipo del parámetro; si no puede (como /pedidos/abc en un int), responde 400. El nombre debe coincidir: {id} con int id; si no, el error es de tu código: 500.@GetMapping("/{id}")
Pedido uno(@PathVariable int id) { ... }
Después del signo
?: /pedidos?limite=5, y lo lees con @RequestParam. Es obligatorio: si falta, responde 400. Con defaultValue se vuelve opcional.@GetMapping
List<Pedido> todos(
@RequestParam(defaultValue = "10") int limite)
// devuelve como máximo «limite» pedidos
En el cuerpo, como JSON, para crear algo (POST) o reemplazarlo (PUT, lo verás en la lección 4). Lo lees con
@RequestBody y Spring arma el record con los campos del JSON. Si el JSON trae un campo de más, lo ignora; si el JSON está mal escrito, responde 400.record NuevoPedido(String producto, int cantidad) { }
@PostMapping
Pedido crear(@RequestBody NuevoPedido nuevo) { ... }
// POST /pedidos {"producto":"tortas","cantidad":2}
Ojo: si una ruta fija y una con variable chocan, como
/pedidos/buscar y /pedidos/{id}, gana la fija.