[스프링 MVC - 2편] 메시지, 국제화

지현·2021년 12월 30일

스프링

목록 보기

24/32

메시지, 국제화 소개

메세지

하드코딩 되어있는 단어들을 별도의 파일에서 관리하도록 하는 기능
메세지를 관리하는 곳에서 내용을 변경하면 한번에 모든 파일에 변경된 내용이 적용됨

국제화

메시지에서 설명한 메시지 파일을 각 나라별로 별도로 관리하면 서비스를 국제화할 수 있음
한국에서 접근한 것인지 영어에서 접근한 것인지는 인식하는 방법은 HTTP accept-language 헤더 값을 사용하거나 사용자가 직접 언어를 선택하도록 하고, 쿠키 등을 사용해서 처리

스프링 메시지 소스 설정

스프링은 기본적인 메시지 관리 기능을 제공
메시지 관리 기능을 사용하려면 스프링이 제공하는 MessageSource 를 스프링 빈으로 등록해야 함
스프링 부트를 사용하면 스프링 부트가 MessageSource 를 자동으로 스프링 빈으로 등록

스프링 부트 메시지 소스 설정
application.properties

spring.messages.basename=messages

스프링 부트 메시지 소스 기본 값
MessageSource를 스프링 빈으로 등록하지 않고, 스프링 부트와 관련된 별도의 설정을 하지 않으면 messages라는 이름으로 기본 등록됨
나머지 옵션은 여기서 확인

메세지 만들기

messages.properties :기본 값으로 사용
messages_en.properties : 영어 국제화 사용

messages.properties

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

파라미터 받는 것도 가능

스프링 메시지 소스 사용

@SpringBootTest
public class MessageSourceTest {

    @Autowired
    MessageSource ms;

    @Test
    void helloMessage(){
        String result = ms.getMessage("hello", null, null);
        assertThat(result).isEqualTo("안녕");
    }

}

ms.getMessage(code, args, locale)
locale 정보가 없으면 basename에서 설정한 기본 이름 메시지 파일을 조회

    @Test
    void notFoundMessageCode(){
        assertThatThrownBy(()->ms.getMessage("no_code",null,null))
                .isInstanceOf(NoSuchMessageException.class);
    }

    @Test
    void notFoundMessageCodeDefaultMessage(){
        String result=ms.getMessage("no_code",null,"기본 메시지",null);
        assertThat(result).isEqualTo("기본 메시지");
    }

메시지가 없는 경우에는 NoSuchMessageException 발생
메시지가 없어도 세번째 매개변수로 기본 메시지(defaultMessage)를 사용하면 기본 메시지가 반환

    @Test
    void argumentMessage(){
        String message=ms.getMessage("hello.name", new Object[]{"Spring"},null);
        assertThat(message).isEqualTo("안녕 Spring");
    }