메세지, 국제화

메세지

1. 메세지를 파일로 관리하는 기능(messages.properties 파일에서 관리)
2. 문자열을 하드코딩하지 않고 파일에 있는 값을 읽어와서 보여준다.

item=상품 
item.id=상품 ID 
item.itemName=상품명 
item.price=가격 
item.quantity=수량

<!-- 실제 사용 -->
<label for="itemName" th:text="#{item.itemName}"></label>

국제화

• 나라별로 메세지 파일을 관리해서 각 언어에 맞는 메세지 파일을 보여주는 기능.
• 유저가 접근한 나라를 확인하는 방법은
  • HTTP accept-language 헤더 값을 사용하거나
  • 사용자가 직접 언어를 선택하게 하고 쿠키 값을 이용하면 된다. -> LocaleResolver 사용
  • Locale이 en_US 의 경우 messages_en_US -> messages_en -> messages 순서로 찾는다.
    • 구체적인 것이 있으면 구체적인 것을 찾고, 없으면 디폴트를 찾는다고 이해하면 된다.

사용법

1. 직접등록

@Bean
public MessageSource messageSource() {
      ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
      messageSource.setBasenames("messages", "errors");
      messageSource.setDefaultEncoding("utf-8");
      return messageSource;
}

• basename : 메세지 파일의 이름을 지정한다
• setBasenames("messages") <- message.properties 파일을 사용하겠다는 뜻
• _en, _ko와 같이 파일이름에 언어정보를 주게 되면 국제화 기능을 적용할 수 있다. 만약 국제화 파일이 없다면 messages를 사용한다.
• 파일의 위치는 /resources 하위에 생성하면 된다
• 여러 파일을 한번에 지정할 수 있다. (messages, error, ... etc)

2. 스프링 부트 사용

스프링부트 사용시 자동으로 MessageSource을 빈으로 등록해줘서 직접 등록하지 않아도 된다.

// application.properties
spring.messages.basename=messages,config.i18n.messages (기본값 messages)

hello=안녕 
hello.name=안녕 {0} {1} {2} // 인자를 줄 수 있다

MessageSource 인터페이스를 사용해 메세지를 가져오는 방법

public interface MessageSource {
    // message code, 인자들, 코드없을때 나올 default message, locale
    String getMessage(String code, @Nullable Object[] args, @Nullable String
    defaultMessage, Locale locale);

    // message code, 인자들, locale
    String getMessage(String code, @Nullable Object[] args, Locale locale) throws
    NoSuchMessageException;
}

// 테스트 코드
@Test
void notFoundMessageCode() {
  assertThatThrownBy(() -> ms.getMessage("no_code", null, null))
  .isInstanceOf(NoSuchMessageException.class); // 메세지가 없으면 NoSuchMessageException
}

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

스프링의 국제화 메시지 선택

1. 스프링은 언어 선택시 기본으로 Accept-Language 헤더의 값을 사용한다.
2. LocaleResolver : Locale 선택 방식을 변경할 수 있도록 LocaleResolver 라는 인터페이스를 제공한다.
   • 스프링 부트는 기본으로 Accept-Language 를 활용하는 AcceptHeaderLocaleResolver 를 사용한다.
   • Accept-Language를 활용하고 싶지 않고 직접 선택하고 싶다면 LocaleResolver 의 구현체를 변경해서 쿠키나 세션 기반의 Locale 선택 기능을 사용할 수 있다

public interface LocaleResolver {
    Locale resolveLocale(HttpServletRequest request);
    void setLocale(HttpServletRequest request, @Nullable HttpServletResponse response, @Nullable Locale locale);
}

 

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