국제화와 지역화

위키백과 내용 - https://ko.wikipedia.org/wiki/%EA%B5%AD%EC%A0%9C%ED%99%94%EC%99%80_%EC%A7%80%EC%97%AD%ED%99%94

국제화와 현지화는 출판물이나 하드웨어 또는 소프트웨어 등의 제품을 언어 및 문화권 등이 다른 여러 환경에 대해 사용할 수 있도록 지원하는 것을 의미한다. 이때 국제화는 제품 자체가 여러 환경을 지원할 수 있도록 제품을 설계하는 것을 의미하며, 현지화는 제품을 각 환경에 대해 지원하는 것을 의미한다.

최자의 보물창고 블로그 내용(신빙성은 적을 수 있음) - https://jwchoi85.tistory.com/tag/internationalization

컴퓨터에서 국제화와 현지화 라는것은, 다른 언어와 지역적인 차이들을 소프트웨어에 적용시킨다는 것을 말합니다. 국제화라는 것은 여러가지 다른 언어와 지역적 차이들을 기술적인 변경 없이 소프트웨어에 적용할 수 있도록 설계하는 과정을 말합니다. 현지화 라는 것은 국제화가 된 소프트웨어에 특정 지역이나 언어에 대해서 지역특색의 컴포넌트를 추가한다거나 번역을해서 적용시키는 것을 말합니다

LocaleResolver 종류

• AceeptHeaderLocaleResolver (default)
  
  • 브라우저의 언어값으로 사용하는 것
  • HTTP 'Accept-Language' header값을 사용하는것
  • setLocale()메소르드를 지원하지 않음 사용하면 UnsupportedOperationException 발생함.

  • Locale aceeptHeaderLocale = new HttpServletRequest().getLocale();

• CookieLocaleResolver
  • 쿠키 기반의 로케일 정도를 사용하는 것
    

  • <bean id="localeResolver"
        class="org.springframework.web.servlet.i18n.CookieLocaleResolver" >
        <property name="cookieName" value="clientlanguage"/>
        <property name="cookieMaxAge" value="100000"/>
        <property name="cookiePath" value="web/cookie"/>
    </bean>

  • 속성 설명

    프로퍼티	설 명
    cookieName	사용할 쿠키 이름
    cookieDomain	쿠키 도메인
    cookiePath	쿠키 경로, 기본값은 "/"이다.
    cookieMaxAge	쿠키 유효 시간 (second), -1로 지정하면 브라우저를 닫을 때 쿠키를 지우겠다는 것
    cookieSecure	보안 쿠키 여부, 기본값은 false 이다.

  • 만약 저장된 쿠키값이 없어서 특정값으로 세팅하고자 한다면 defaultLocale 파라미터값을 세팅하면 된다.

  • SessionLocaleResolver나 CookieLocaleResolver에 defaultLocale이 없다면 브라우저의 언어설정(AceeptHeaderLocaleResolver)을 따르게 된다.
  • CookieLocaleResolver에 보면 몇가지 추가 세팅할 수 있는 값이 있음
    • languageTagCompliant - Specify whether this resolver's cookies should be compliant with BCP 47 language tags instead of Java's legacy locale specification format. The default is false. Note: This mode requires JDK 7 or higher. Set this flag to true for BCP 47 compliance on JDK 7+ only.  
    • 위키백과의 내용과 같이 ko-KR과 같이 '_'가 아닌 '-'를 붙여서 표현하는 방식으로 쿠키값을 심을지 여부값 이다. true값이 되면 'ko-KR', 'en-US'와 같이 '-'가 들어간 형태로 cookieValue값이 세팅된다. springframework 내부적으로는 'ko_KR' 형식으로 사용하고 쿠키값(cookieValue)만 변경됨.
      • languageTagCompliant 값에 따른 parsing하는 코드
        • (isLanguageTagCompliant() ? Locale.forLanguageTag(locale) : StringUtils.parseLocaleString(locale))
    • Cookie 관련 정보(CookieGenerator class를 상속받아 cookie관련 설정값을 추가로 세팅 할 수 있음)
      • HttpOnly (CookieGenerator.cookieHttpOnly에 있는 값을 상속받음.) - javascript에서 document.cookie로 cookie값을 조작할 수 없도록 하고 웹서버에서만 cookie값을 조작할 수 있도록 할지 여부 값, 참고 링크 https://nsinc.tistory.com/121
      • secure (CookieGenerator.cookieSecure 에 있는 값을 상속받음) - HTTPS가 아닌 통신에서는 쿠키를 전송하지 않을지 여부 값. 참고 링크 https://nsinc.tistory.com/121
• SessionLocaleResolver
  • 세션 기반의 로케일 정보를 사용하는 것

  • request가 가지고 있는 session에 있는 값을 가지고 오는 것
    <bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver" />

  • 설정 예

  • <beans:bean id="localeResolver"     class="org.springframework.web.servlet.i18n.SessionLocaleResolver">     <beans:property name="defaultLocale" value="ko" /> </beans:bean>

  • SessionLocaleResolver나 CookieLocaleResolver에 defaultLocale이 없다면 브라우저의 언어설정을 따르게 된다.

• FixedLocaleResolver
  • 웹 요청과 상관없이 defaultLocale 속성값을 사용는 것

  • FixedLocaleResolver는 setLocale() 메소드를 지원하지 않음 호출하면  UnsupportedOperationException이 발생함.

Locale 변경시

• LocaleResolver를 이용한 Locale 변경

  • LocaleResolver를 빈으로 등록했다면, 컨트롤러에서 LocaleResolver를 이용해서 Locale을 변경할 수 있게 된다. 예를 들어 다음과 같이 LocaleResolver를 설정했다고 하자.

  • <bean class="com.xxx.test.controller.LocaleChangeController">         <property name="localeResolver" ref="localeResolver" /> </bean> <bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver" />

     

    이 경우, 컨트롤러 클래스는 다음과 같이 LocaleResolver의 setLocale() 메서드를 호출해서 클라이언트의 웹 요청을 위한 Locale을 변경할 수 있다.

  • import org.springframework.web.servlet.LocaleResolver; @Controller public class LocaleChangeController {     private LocaleResolver localeResolver;     @Inject     public void setLocaleResolver(LocaleResolver localeResolver) {         this.localeResolver = localeResolver;     }       @RequestMapping("/changeLocale")     public String change(@RequestParam("language") String language, HttpServletRequest request, HttpServletResponse response) {         // Locale locale = (isLanguageTagCompliant() ? Locale.forLanguageTag(locale) : StringUtils.parseLocaleString(locale))  // <-- CookieLocaleResolver를 사용 하는 경우         Locale locale = new Locale(language);   // <-- cookie가 아닌 다른 LocaleResolver를 사용하는 경우           // LocaleResolver localeResolver = RequestContextUtils.getLocaleResolver(request); // <-- DI를 받지 않고 현재 request에서 LocaleResolver를 가져올 수 도 있음.           localeResolver.setLocale(request, response, locale);         return "redirect:/index.jsp";     } }

    LocaleResolver를 이용해서 Locale을 변경하면, 이후 요청에 대해서는 지정한 Locale을 이용해서 메시지 등을 로딩하게 된다.

    ResolverContextUtils는 현재 request에서 LocaleResolver를 가져올 수 있음.

• LocaleChangeInterceptor를 사용하는 경우
  • org.springframework.web.servlet.i18n.LocaleChangeInterceptor는 url를 통해서 언어를 변경할 경우 사용 아래와 같은 설정 상태면 
    • http://localhost/home/?lang=ko
    • http://localhost/home/?lang=en

  • <mvc:interceptors>     <beans:bean id="localeChangeInterceptor" class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">     <beans:property name="paramName" value="lang" />     </beans:bean> </mvc:interceptors>

https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/web/servlet/LocaleResolver.html