Spring Boot 4 Microservices & REST APIs · Aula

Validação de beans com @Valid

Valide corpos de requisição com anotações.

Validação de beans com @Valid é uma aula grátis de Spring Boot 4 Microservices & REST APIs no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Spring Boot 4 Microservices & REST APIs, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Spring Boot 4 Microservices & REST APIs inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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, @Email on DTOs
Trigger with @Valid on request bodies; failures yield 400
Use @Validated for param-level validation
Nested objects and collections need their own @Valid

Perguntas Frequentes

A aula “Validação de beans com @Valid” é grátis?

Sim — o texto completo de “Validação de beans com @Valid” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Spring Boot 4 Microservices & REST APIs, atualize para CoddyKit PRO. O curso de Spring Boot 4 Microservices & REST APIs inclui 4 aulas no total.

O que vou aprender em “Validação de beans com @Valid”?

Valide corpos de requisição com anotações. Você pratica Spring Boot 4 Microservices & REST APIs com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Spring Boot 4 Microservices & REST APIs?

Nenhuma experiência prévia é necessária. Spring Boot 4 Microservices & REST APIs no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Validação de beans com @Valid”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Spring Boot 4 Microservices & REST APIs?

Sim. Cada aula de Spring Boot 4 Microservices & REST APIs inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Spring Boot 4 Microservices & REST APIs