Validation des beans avec @Valid
Validez les corps des requêtes avec des annotations.
Validation des beans avec @Valid est une leçon Spring Boot 4 Microservices & REST APIs gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Spring Boot 4 Microservices & REST APIs, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Spring Boot 4 Microservices & REST APIs comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Bean Validation Overview
Bean Validation (JSR-380, Jakarta Validation) lets you declare constraints with annotations on your DTO fields, then validate objects against them. Spring Boot integrates it so incoming request bodies are checked automatically.
Adding the Dependency
The validation API plus an implementation (Hibernate Validator) come via the validation starter. Adding it activates annotation-driven validation in controllers.
<!-- pom.xml -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>Constraints on a DTO
Annotate fields with constraints. Each describes a rule the value must satisfy, plus an optional message shown when it fails.
public class CreateUserRequest {
@NotBlank
private String name;
@Email @NotNull
private String email;
@Size(min = 8, max = 64)
private String password;
@Min(18)
private int age;
// getters/setters
}Common Constraints
The standard annotations cover most needs:
@NotNull— value must not be null@NotBlank— string must contain non-whitespace@NotEmpty— collection/string not empty@Size,@Min,@Max,@Email,@Pattern
Triggering Validation with @Valid
In a controller, annotate the request body parameter with @Valid. Spring validates it before your method body runs; on failure it short-circuits with an error.
@PostMapping("/users")
public ResponseEntity<Void> create(@Valid @RequestBody CreateUserRequest req) {
userService.create(req);
return ResponseEntity.status(HttpStatus.CREATED).build();
}What Happens on Failure
If validation fails, Spring throws MethodArgumentNotValidException for a @RequestBody. By default this yields a 400 Bad Request, so invalid input never reaches your service layer.
Custom Messages
Override the default message per constraint with the message attribute, or externalize messages for i18n via a resource bundle.
@Size(min = 8, message = "Password must be at least 8 characters")
private String password;Validating Path and Query Params
To validate individual method parameters (not a DTO), put constraints directly on them and add @Validated at the class level so method-level validation is active.
@Validated
@RestController
public class ProductController {
@GetMapping("/products")
public List<Product> list(@RequestParam @Min(1) int page) {
return service.page(page);
}
}Nested Validation
Validation does not automatically descend into nested objects. Mark the nested field with @Valid so its constraints are also checked.
public class OrderRequest {
@NotNull
@Valid
private AddressDto shippingAddress;
// ...
}Validating Collections
To validate each element of a collection, place @Valid on the collection field; each item’s constraints are then evaluated.
public class CartRequest {
@NotEmpty
private List<@Valid LineItem> items;
// ...
}Validation Groups
Validation groups let the same DTO enforce different rules in different contexts (for example create vs update). Annotate constraints with a group interface and validate against that group.
public interface OnCreate {}
public class UserDto {
@Null(groups = OnCreate.class)
private Long id; // must be null when creating
}Quick Check
Test your understanding of @Valid.
Recap
Bean Validation guards your input.
- Add
spring-boot-starter-validation - Declare constraints like
@NotBlank,@Size,@Emailon DTOs - Trigger with
@Validon request bodies; failures yield 400 - Use
@Validatedfor param-level validation - Nested objects and collections need their own
@Valid
Questions Fréquemment Posées
La leçon « Validation des beans avec @Valid » est-elle gratuite ?
Oui — le texte complet de « Validation des beans avec @Valid » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Spring Boot 4 Microservices & REST APIs, passe à CoddyKit PRO. Le cours Spring Boot 4 Microservices & REST APIs comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Validation des beans avec @Valid » ?
Validez les corps des requêtes avec des annotations. Tu pratiques Spring Boot 4 Microservices & REST APIs avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Spring Boot 4 Microservices & REST APIs ?
Aucune expérience préalable n'est requise. Spring Boot 4 Microservices & REST APIs sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Validation des beans avec @Valid » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Spring Boot 4 Microservices & REST APIs ?
Oui. Chaque leçon Spring Boot 4 Microservices & REST APIs inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Validation des beans avec @Valid
- Validateurs personnalisés
- @ControllerAdvice et @ExceptionHandler
- Détails des problèmes (RFC 7807)