Bean Validation

표준 JSR-380 프레임워크 및 Jakarta Bean Validation 3.0

JSR 380

• JSR 380은 Jakarta EE 및 JavaSE의 일부인 빈 유효성 검사를 위한 Java API의 사양입니다. 이렇게 하면 @NotNull, @Min 및 @Max와 같은 annotations을 사용하여 빈의 속성이 특정 기준을 충족하는지 확인할 수 있습니다.

• 이 버전은 Hibernate-Validator 8.0.0을 제공하는 Spring Boot 3.x가 사용되므로 Java 17 이상이 필요합니다.

• 또한 stream, Optional Improvements ,modules, private interface methods 등과 같이 Java 9 이상에 도입된 많은 새로운 기능을 지원합니다.

Dependencies

• spring-boot-starter-validation (latest version)

• hibernate-validator 8.0.0 Final

Standard JSR annotations

• @NotNUll

  • Annotation이 달린 속성 값이 null 아닌지 확인합니다.

• @AssertTrue

  • Annotation이 달린 속성 값이 참인지 확인합니다.

• @Size

  • Annotation이 달린 속성 값의 크기가 min속성과 max속성 상이에 있는지 확인합니다. String,Collection,Map 및 배열 속성에 적용할 수 있습니다.

• @Min

  • Annotation 속성의 value 속성보다 작지 않는 값이 있는지 확인합니다.

• @Max

  • Annotation 속성의 value 속성보다 크지 않은 값이 있는지 확인합니다.

• @Email

  • Annotation 속성이 유효한 이메일 주소인지 확인합니다.

Additional annotations

• @NotEmpty

  • 속성이 null이거사 비어 있지 않은지 확인합니다. String, Collection, Map 또는 Array 값에 적용할 수 있습니다.

• @NotBlank

  • 텍스트 값에만 적용할 수 있으며 속성이 null 또는 whitespace이 아닌지 확인합니다.

• @Positive and @PositiveOrZero

  • 숫자 값에 적용하고 값이 양수인지 또는 0을 포함하여 양수인지 확인합니다.

• @Negative and @NegativeOrZero

  • 숫자 값에 적용되며 값이 완전히 음수인지 또는 0을 포함하여 음수인지 확인합니다.

• @Past 및 @PastOrPresent

  • 날짜 값이 과거 또는 현재를 포함한 과거인지 확인합니다. Java 8에 추가된 날짜 유형을 포함하여 날짜 유형에 적용할 수 있습니다.

• @Future 및 @FutureOrPresent

  • 날짜 값이 미래인지 또는 현재를 포함한 미래인지 확인합니다.

Creating a Composed Constraint

@NotNull
@Pattern(regexp = ".*\\d.*", message = "must contain at least one numeric character")
@Length(min = 6, max = 32, message = "must have between 6 and 32 characters")
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = {})
public @interface ValidAlphanumeric {

    String message() default "field should have a valid length and contain numeric character(s).";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};
}

@ReportAsSingleViolation

• 단일 ConstraintViolation을 반환하도록 유효성 검사를 진행한다.

@ConstraintComposition(CompositionType.OR)

• 적어도 하나의 제약조건을 만족 하는지 확인한다.

@SupportedValidationTarget(ValidationTarget.ANNOTATED_ELEMENT)

• 메서드의 반환 값을 확인한다.

Reference

Java Bean Validation Basics | BaeldungBaeldung

Constraint Composition with Bean Validation | BaeldungBaeldung