본문으로 건너뛰기
Advertisement

6.4 Validation Groups (검증 그룹)

등록(생성) 시와 수정 시에 서로 다른 검증 규칙을 적용하고 싶을 때 Validation Groups를 사용합니다. 예: 등록 시에는 id 없음, 수정 시에는 id 필수.

작성 기준: Bean Validation (JSR 380), Spring

1. 그룹 인터페이스 정의​

public interface CreateGroup {}
public interface UpdateGroup {}
  • 빈 인터페이스만 두고 마커로 사용합니다.

2. 엔티티/DTO에 그룹 지정​

@Getter
@Setter
public class MemberDto {

    @NotNull(groups = UpdateGroup.class)
    private Long id;

    @NotBlank(groups = { CreateGroup.class, UpdateGroup.class })
    private String name;

    @NotBlank(groups = CreateGroup.class)
    @Size(min = 8, groups = CreateGroup.class)
    private String password;

    @Email(groups = { CreateGroup.class, UpdateGroup.class })
    private String email;
}
  • groups: 해당 제약이 적용되는 그룹. 여러 그룹에 같은 제약을 걸 수 있습니다.
  • UpdateGroup일 때만 id 필수, CreateGroup일 때만 password 필수·길이 검사 등으로 나눌 수 있습니다.

3. 컨트롤러에서 @Validated에 그룹 지정​

@PostMapping
public ResponseEntity<MemberDto> create(@Validated(CreateGroup.class) @RequestBody MemberDto dto) {
    return ResponseEntity.ok(memberService.create(dto));
}

@PutMapping("/{id}")
public ResponseEntity<MemberDto> update(
        @PathVariable Long id,
        @Validated(UpdateGroup.class) @RequestBody MemberDto dto) {
    dto.setId(id);
    return ResponseEntity.ok(memberService.update(dto));
}
  • @Validated(그룹.class) 로 “이 요청에서는 이 그룹만 검증”하도록 지정합니다.
  • @Valid 는 그룹을 지정하지 않으며, groups가 없는 제약만 동작합니다.

4. 그룹 순서 (GroupSequence)​

그룹을 순서대로 검증하려면 @GroupSequence를 사용합니다.

@GroupSequence({ FirstCheck.class, SecondCheck.class, MemberDto.class })
public interface OrderedChecks {}

public interface FirstCheck {}
public interface SecondCheck {}
  • FirstCheck 실패 시 SecondCheck는 실행되지 않습니다.
팁

등록/수정 DTO를 분리해 CreateRequest, UpdateRequest로 두고 각각 다른 검증을 거는 방식도 많이 씁니다. 그룹은 “한 DTO에 여러 용도”를 둘 때 유용합니다.

Advertisement
Advertisement