Valida lo que llega
Tu API no controla quién la llama: puede llegar un pedido sin producto o con cantidad -3. Validar es revisar los datos antes de usarlos. Spring lo hace con Bean Validation: reglas que escribes como anotaciones en los campos del record.
Primero agrega al pom.xml el starter de validación:
spring-boot-starter-validation. Sin él, @NotBlank y @Valid ni siquiera existen: el código no compila.record NuevoPedido(
@NotBlank(message = "falta el producto")
String producto,
@Positive(message = "la cantidad debe ser positiva")
int cantidad) { }
@NotBlank exige texto de verdad y @Positive un número mayor que 0. Con message escribes el texto del error; si no lo pones, sale uno genérico en el idioma de quien llama (la cabecera Accept-Language), como «no debe estar vacío».Las reglas solo se revisan si pones
@Valid junto al @RequestBody. Si alguna falla, Spring responde 400 y tu método no se ejecuta: no se guarda nada.@PostMapping
String crear(@Valid @RequestBody NuevoPedido p) {
...
}
// POST /pedidos {"producto":"","cantidad":2}
// 400 {"status":400,"error":"Bad Request",...}
Ojo: si un
int no viene en el JSON, Spring Boot 4 responde 400 desde antes, aun sin @Valid: Jackson no puede dejar vacío un int, porque no acepta null. Ese 400 es porque Spring no pudo convertir el JSON, no de tus reglas.