[Spring] Bean Validation

HS_Developer

✧ Daily Backend Log

글쓰기 관리홈

Today :
Yesterday :

Backend/🌱 Spring

[Spring] Bean Validation

HS0601 2025. 7. 28. 19:53

Bean Validation란?
입력된 값이 유효한지 검사하는 도구
클라이언트가 입력한 값이 비어있거나 형식이 잘못됐거나 범위에서 벗어나면 백엔드가 걸러내고 에러메시지를 알려줘야 함

왜 필요한가

검증을 안하면?

사용자 입력값이 DB에 이상하게 들어가거나

서버가 아예 터지거나

예외(에러)가 발생해서 앱이 먹통이 됨

검증하면?

잘못된 입력은 미리 걸러서 사용자에게 피드백

서버는 안전하게 작동됨

Bean Validation 적용 흐름

입력값 -> DTO 객체로 바인딩됨
-> 검증 어노테이션(@NotBlank 등)이 붙여있음
-> 스프링이 자동으로 검사
-> 오류 나면 BindingResult에 담김
-> Controller에서 오류 처리

예제코드 바로가잣~

1) DTO만들기

// SignUpRequestDto.java
package com.example.demo.dto;

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import org.hibernate.validator.constraints.Range;
import lombok.Getter;

@Getter
public class SignUpRequestDto {
	// null, "", " " 전부 안 됨
    @NotBlank(message = "이름은 필수입니다.") 
    private String name;
	// null이면 안 됨
    @NotNull(message = "나이는 필수입니다.") 
     // 숫자 범위 제한
    @Range(min = 1, max = 120, message = "나이는 1~120 사이여야 합니다.")
    private Integer age;
}

필요한 이유는

클라이너트가 빈 값이나 잘못된 값을 보내도 우리가 if문으로 매번 검사하지 않아도 자동으로 검사해줌

2) Controller 만들기

// BeanValidationController.java
package com.example.demo.controller;

import com.example.demo.dto.SignUpRequestDto;
import jakarta.validation.Valid;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.PostMapping;

@Slf4j
@Controller
public class BeanValidationController {

    @PostMapping("/signup")
    public String signup(
		    //  @Valid → 이 DTO를 자동검증
            @Valid SignUpRequestDto requestDto,  
             //  검증 결과를 담는 객체 (무조건 DTO 다음에 위치)
            BindingResult bindingResult, 
            //  Thymeleaf 템플릿에 데이터 넘기기용
            Model model  
    ) {
        if (bindingResult.hasErrors()) {
            //  검증 에러가 발생하면 여기로 옴
            log.info("에러 발생: {}", bindingResult.getAllErrors());
             // error.html 반환
            return "error";
        }

        // 유효성 통과한 경우
        model.addAttribute("name", requestDto.getName());
        model.addAttribute("age", requestDto.getAge());
		 // complete.html 반환
        return "complete";
    }
}

왜 @Valid 랑 BindingResult가 있어야 할까?

@Valid가 검증을 수행하고 그 결과를 BindingResult 가 담기 때문
오류가 있으면 if(bindingResult.hasError())조건문이 true가 돼서 에러 페이지로 보냄

3) 템플릿

<!-- complete.html -->
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>회원가입 완료</title>
</head>
<body>
    <h1>회원가입 성공!</h1>
    <p>이름: <span th:text="${name}"></span></p>
    <p>나이: <span th:text="${age}"></span></p>
</body>
</html>

빈 검증이 작동하려면 필요한 조건

조건	설명
@Valid	DTO에 붙어서 해당 객체를 검증하라고 지시
BindingResult	검증결과를 저장함. 없으면 스프링이 예외 터뜨림
spring-boot-starter-validation	이 의존성이 있어야 전체 검증 기능이 작동함 (Gradle에 포함되어 있어야 함)

주의사항 정리

@Valid 뒤에는 무조건 BindingResult 붙어야 함 -> 안그러면 에러남
바인딩이 안 되는 타입(예: age에 문자가 들어올 경우)은 @Valid적용 자체가 안됨-> BindingResult에 에러로만 남음
DTO필드마다 어노테이션을 꼭 써줘야 검증이 적용됨

핵심 문법 정리

1) 의존성 추가(build.gradle)

implementation 'org.springframework.boot:spring-boot-starter-validation'

2) DTO에서 검증 어노테이션 사용하기

@Getter
public class SignUpRequestDto{
	@NotBlank(massage="이름은 필수입니다.") //null, ""," " 불가능
	private String name;

	@NotNull(message="나이는 필수입니다.")//null 불가능
	@Range(min=1, max=120, message="나이는 1~120 사이여야 합니다.");
	private Integer age;

}

문자열이면 @NotBlank
숫자면 @NotNull
범위제한 @Range

3) Controller에서 검증처리 문법

@PostMapping("/signup")
public String signup{
	  @Valid SignUpRequestDto dto,        // 1. 검증할 DTO
        BindingResult bindingResult,        // 2. 검증 결과 저장 (순서 중요!)
        Model model                         // 3. Thymeleaf에 데이터 넘기기
) {
		if(bindingResult.hasError){
			//에러 있으면 여기서 처리
			return "error";
		}
		//정상처리
		model.addAttribute("name",dto.getName());
		model.addAttribute("age",dto.getAge());
	}
}

저작자표시 변경금지 (새창열림)

'Backend > 🌱 Spring' 카테고리의 다른 글

[Spring]Filter (0)	2025.07.29
[Spring] filter실습까지 진행한 후 이해한 내용 정리 (1)	2025.07.29
[Spring]의존관계 주입(DI) (2)	2025.07.28
[Spring]Spring Bean (2)	2025.07.28
[Spring] Layered Architecture (3)	2025.07.26

현재글[Spring] Bean Validation

일	월	화	수	목	금	토
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30

HS_Developer

[Spring] Bean Validation

'Backend > 🌱 Spring' 카테고리의 다른 글

'Backend/🌱 Spring'의 다른글

티스토리툴바

[Spring] Bean Validation

'Backend > 🌱 Spring' 카테고리의 다른 글

'Backend/🌱 Spring'의 다른글

관련글

티스토리툴바