springframework mvc i18n(국제화) and localization(지역화=현지화)

Spring 2019. 6. 27. 14:44

국제화와 지역화

위키백과 내용 - 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를 통해서 언어를 변경할 경우 사용 아래와 같은 설정 상태면 

    • <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

Posted by 파이팅야
,

티스토리툴바