Github 소스코드

🔎 간단한 시나리오

경우에 따라 폼은 비슷하지만 검증 로직이나 검증 메시지를 다르게 해야 할 수 있습니다.

상품 등록 폼과 상품 수정 폼이 있다고 가정해볼께요.
상품 등록 폼의 경우 상품의 수량을 100개 이하로 입력하지 못하게 하고 상품 수정 폼의 경우 수량의 제한이 없다고 한다면 서로 다른 검증로직이 동작해야 됩니다.

두 가지 방법을 알아보겠습니다.

• Groups를 사용
• 폼 객체 분리

---

🔎 Groups

상품 등록 폼과 상품 수정 폼에 groups를 적용하여 검증 로직을 분리해볼께요.

두 개 인터페이스를 정의합니다.
구분을 위한 인터페이스이기 때문에 내용은 필요 없습니다.

• ItemSaveRequest
• ItemUpdateRequest
  

Item 클래스를 정의합니다.

• groups를 이용해서 등록시(ItemSaveRequest)와 수정시(ItemUpdateRequest) 적용될 검증로직을 구분하였습니다.

@Data
public class Item {

    @NotNull(groups = {ItemUpdateRequest.class})
    private Long id;
    
    @NotEmpty(message = "상품명을 입력해주세요.")
    private String itemName;

    @NotNull
    @Range(min=1000, max=1000000)
    private Integer price;

    @NotNull
    @Range(min=100, groups = {ItemSaveRequest.class})
    private Integer quantity;
}

Controller 측에서 어떤 구분자를 사용할지 명시해주어야 합니다.

• @Validated의 value파라미터에 구분자(인터페이스)를 지정합니다.

@Slf4j
@Controller
@RequestMapping("/test")
public class TestController {

    @GetMapping
    public String form(@ModelAttribute Item item) {
        return "form";
    }

    @PostMapping
    public String add(
            @Validated(value = ItemSaveRequest.class) @ModelAttribute Item item, BindingResult bindingResult) {

        if (bindingResult.hasErrors()) {
            log.info("binding result = {}", bindingResult);
            return "form";
        }

        log.info("****** 비즈니스로직 수행 ********");

        return "form";
    }

    @PostMapping
    public String edit(
            @Validated(value = ItemUpdateRequest.class) @ModelAttribute Item item, BindingResult bindingResult) {

        if (bindingResult.hasErrors()) {
            log.info("binding result = {}", bindingResult);
            return "form";
        }
        
        log.info("****** 비즈니스로직 수행 ********");

        return "form";
    }

}

이렇게 groups를 이용하면 한 객체로 폼마다 다른 검증로직을 적용시킬 수 있습니다.

🔎 폼 객체 분리

위처럼 아주 간단한 예제의 경우 groups를 이용해서 객체에서 검증로직을 구분할 수 있지만 실제로 적용하기는 힘든 경우가 많습니다.

현재 예제에서는 도메인 객체(Entity)를 폼 데이터와 그대로 매핑시켜 사용하고 있습니다. 하지만 실제 복잡한 프로젝트의 경우 도메인 객체를 벗어나는 많은 부가적인 정보가 한 번에 넘어올 것 입니다. 그렇기 때문에 도메인 객체에 groups를 적용하는 것은 좋은 방법은 아닙니다.

가장 좋은 방법은 해당 폼에 딱 맞춰진 객체를 정의하여 매핑시키는 것 입니다.
결국 폼 객체를 도메인 객체로 변환하는 과정이 필요하겠지만 복잡한 폼 데이터를 딱 맞게 받을 수 있다는 장점과 검증의 용이성을 챙기는 것 입니다.

폼마다 딱 맞는 폼 객체를 정의하여 복잡한 상황에도 대처 가능하도록 합시다. !

---

인프런 김영한님의 스프링 MVC 2편 을 수강하고 정리한 내용입니다.