[강의] 스프링 MVC 2편 - 백엔드 웹 개발 핵심 기술 3

https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-2

스프링 MVC 2편 - 백엔드 웹 개발 활용 기술 - 인프런 | 강의

3. 메시지, 국제화

- 메시지, 국제화 소개

messages.properties라는 메세지 관리용 파일을 만들자

-> key값을 저장해놓고 불러와서 사용한다.

    변경할 일이 생기면 이 파일의 key를 변경함으로써 모두에 적용되게

 

messages_en.properties, messages_kor.properties 이렇게 사용하면 국제화도 가능

-> HTTP accept-language 해더 값을 사용하거나 사용자가 직접 언어를 선택하여 쿠키에 저장 하는 방법으로

 

스프링은 기본적인 메시지와 국제화 기능을 제공한다.

 

- 스프링 메시지 소스 설정

1. MessageSource(구현체 : ResourceBundleMessageSource)를 직접 빈으로 등록한다.

2. application.properties에 다음 설정

spring.messages.basename=messages,config.i18n.messages

basename의 기본값이 message이므로 굳이 작성하지 않고 messages_en.properties, messages_kor.properties 등록만 해도 잘 됨 

다른 내용은 application.properties 공식 문서 참고

 

messages.properties (기본값)

hello=안녕
hello.name=안녕 {0}

messages_en.properties

hello=hello
hello.name=hello {0}

 

- 스프링 메시지 소스 사용

 

MessageSource를 불러다가 사용하는 방법

@SpringBootTest
public class MessageSourceTest {
    @Autowired
    MessageSource ms;
    @Test
    void helloMessage() {
        String result = ms.getMessage("hello", null, null);
        assertThat(result).isEqualTo("안녕");
    }

    //no_code라는 건 없음 -> exception
    @Test
    void notFoundMessageCode() {
        assertThatThrownBy(() -> ms.getMessage("no_code", null, null))
                .isInstanceOf(NoSuchMessageException.class);
    }

    //default message를 설정해 줄 수 있음
    @Test
    void notFoundMessageCodeDefaultMessage() {
        String result = ms.getMessage("no_code", null, "기본 메시지", null);
        assertThat(result).isEqualTo("기본 메시지");
    }

    //messages 파일의 {0} 부분은 치환할 수 있는 부분, Spring으로 치환됨
    @Test
    void argumentMessage() {
        String result = ms.getMessage("hello.name", new Object[]{"Spring"}, null);
        assertThat(result).isEqualTo("안녕 Spring");
    }

    //한국일 때 -> default messages
    @Test
    void defaultLang() {
        assertThat(ms.getMessage("hello", null, null)).isEqualTo("안녕");
        assertThat(ms.getMessage("hello", null, Locale.KOREA)).isEqualTo("안녕");
    }

    //영어권일 때 -> messages_en
    @Test
    void enLang() {
        assertThat(ms.getMessage("hello", null,
                Locale.ENGLISH)).isEqualTo("hello");
    }
}

 

- 웹 애플리케이션에 메세지 적용하기

타임리프로 적용하기

th:text="#{page.addItem}"

??: 한국어가 깨지는데요..

- 웹 애플리케이션에 국제화 적용하기

그냥 하면 된다.

 

4. 검증1 - Validation

- 검증 요구사항

 

<요구사항: 검증 로직 추가>
타입 검증
가격, 수량에 문자가 들어가면 검증 오류 처리
필드 검증
상품명: 필수, 공백X
가격: 1000원 이상, 1백만원 이하
수량: 최대 9999
특정 필드의 범위를 넘어서는 검증
가격 * 수량의 합은 10,000원 이상

 

검증 로직을 벗어났다고 에러 페이지로 넘어가면 안됨,

유저에게 어디가 틀렸는지 알려줘야한다.

 

클라이언트 검증 vs 서버 검증
클라이언트 검증은 조작할 수 있으므로 보안에 취약하다.
서버만으로 검증하면, 즉각적인 고객 사용성이 부족해진다.
둘을 적절히 섞어서 사용하되, 최종적으로 서버 검증은 필수
API 방식을 사용하면 API 스펙을 잘 정의해서 검증 오류를 API 응답 결과에 잘 남겨주어야 함

 

- 검증 직접 처리 - 소개

상품 등록 폼에서 저장에 실패하면 오류 결과와 함께 상품 등록 폼으로 돌아오는

 

- 검증 직접 처리 - 개발

 

@PostMapping("/add")
    public String addItem(@ModelAttribute Item item, RedirectAttributes redirectAttributes, Model model) {

        //검증 오류 결과를 보관
        Map<String, String> errors = new HashMap<>();

        //검증 로직
        if (!StringUtils.hasText(item.getItemName())) {
            errors.put("itemName", "상품 이름은 필수입니다.");
        }
        if (item.getPrice() == null || item.getPrice() < 1000 || item.getPrice() >
                1000000) {
            errors.put("price", "가격은 1,000 ~ 1,000,000 까지 허용합니다.");
        }
        if (item.getQuantity() == null || item.getQuantity() >= 9999) {
            errors.put("quantity", "수량은 최대 9,999 까지 허용합니다.");
        }

        //특정 필드가 아닌 복합 룰 검증
        if (item.getPrice() != null && item.getQuantity() != null) {
            int resultPrice = item.getPrice() * item.getQuantity();
            if (resultPrice < 10000) {
                errors.put("globalError", "가격 * 수량의 합은 10,000원 이상이어야 합니다. 현재 값 = " + resultPrice);
            }
        }

        //검증에 실패하면 다시 입력 폼으로
        if (!errors.isEmpty()) {
            model.addAttribute("errors", errors);
            return "validation/v1/addForm";
        }

        //성공 로직
        Item savedItem = itemRepository.save(item);
        redirectAttributes.addAttribute("itemId", savedItem.getId());
        redirectAttributes.addAttribute("status", true);
        return "redirect:/validation/v1/items/{itemId}";
    }

검증해서 에러 메세지를 내는 코드이다.

model의 errors의 메세지를 html에 넣어준다.

<div class="field-error" th:if="${errors?.containsKey('itemName')}"
     th:text="${errors['itemName']}">

<input type="text" id="itemName" th:field="*{itemName}"
       th:class="${errors?.containsKey('itemName')} ? 'form-control field-error' : 'form-control'"

class를 바꿔 테마를 바꾸고 에러 메세지를 출력할 수 있다.

 

문제점:

타입 오류 처리가 되지 않는다. 컨트롤러까지 들어오기도 전에 예외가 발생한다.

뷰 템플릿에서 중복 처리가 많다.