Package com.easydesk.localization

Class DefaultEasyDeskLocalizationService

java.lang.Object

com.easydesk.localization.DefaultEasyDeskLocalizationService

All Implemented Interfaces:

EasyDeskLocalizationService, AutoCloseable

public class DefaultEasyDeskLocalizationService
extends Object
implements EasyDeskLocalizationService, AutoCloseable

EasyDeskLocalizationService 의 기본 구현 - ResourceBundle 기반.

Fulcrum 의 SimpleLocalizationServiceImpl/DefaultLocalizationService/LocaleTokenizer (Apache License 2.0) 의 동작을 그대로 옮겨 왔다:

• 요청한 bundle 에 key 가 없으면 설정된 나머지 bundle 들에서 차례로 찾는다.
• 요청 locale 의 bundle 이 없으면 기본 국가/언어를 붙여 보고, 그래도 없으면 기본 locale 의 bundle 을 쓴다.
• format 은 MessageFormat 으로 인자를 채운다.

추가된 동작: 요청한 locale 의 어느 bundle 에도 key 가 없으면 (번역 누락) 기본 locale 의 값을 쓴다 (LocalizationConfig.fallbackToDefaultLocale(boolean) 로 끌 수 있다). 달라진 점: Avalon/Turbine/servlet 의존성이 없고, bundle cache 는 요청 locale 기준의 thread-safe map 이며, locale 문자열은 ko-KR 뿐 아니라 ko_KR 형식도 받는다.

Spring 에서는 LocalizationConfiguration 이 bean 으로 만들고, Spring 밖에서는 Localization.getService() 로 같은 instance 를 쓴다. Java 9+ 의 ResourceBundle 은 .properties 를 UTF-8 로 읽는다.

Author:

YounghoCho

Field Summary

Fields inherited from interface com.easydesk.localization.EasyDeskLocalizationService

ACCEPT_LANGUAGE

Constructor Summary

Constructors

Constructor	Description
DefaultEasyDeskLocalizationService()	기본 설정(LocalizationConfigImpl)으로 만든다.
DefaultEasyDeskLocalizationService(LocalizationConfig config)

Method Summary

Modifier and Type	Method	Description
void	close()	cache 를 비운다 (Spring bean 의 destroy method).
String	format(LocalizableMessage message, Locale locale)	LocalizableMessage(key + parameters) 를 기본 bundle 로 format 한다.
String	format(String bundleName, Locale locale, LocalizableKey key, Object... args)
String	format(String bundleName, Locale locale, String key, Object... args)
String	format(Locale locale, LocalizableKey key, Object... args)	기본 bundle
ResourceBundle	getBundle()
ResourceBundle	getBundle(String bundleName)
ResourceBundle	getBundle(String bundleName, String languageHeader)
ResourceBundle	getBundle(String bundleName, Locale locale)
String[]	getBundleNames()
String	getDefaultBundleName()
String	getDefaultCountry()
String	getDefaultLanguage()
Locale	getDefaultLocale()
Locale	getLocale(String header)	Fulcrum LocaleTokenizer 와 같은 규칙: ',' 로 나누고 ';q=' 값이 큰 순서 (같으면 먼저 나온 것).
String	getString(LocalizableKey key)
String	getString(String key)	기본 bundle / 기본 locale
String	getString(String bundleName, Locale locale, LocalizableKey key)
String	getString(String bundleName, Locale locale, String key)	bundleName 에서 key 를 찾고, 없으면 나머지 bundle 들에서 차례로 찾는다.
String	getString(Locale locale, LocalizableKey key)
String	getString(Locale locale, String key)	기본 bundle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DefaultEasyDeskLocalizationService

public DefaultEasyDeskLocalizationService()

기본 설정(LocalizationConfigImpl)으로 만든다.

DefaultEasyDeskLocalizationService

public DefaultEasyDeskLocalizationService(LocalizationConfig config)

Method Details

close

public void close()

cache 를 비운다 (Spring bean 의 destroy method). Localization 에 등록되어 있으면 등록도 해제한다.

Specified by:

close in interface AutoCloseable

getDefaultLanguage

public String getDefaultLanguage()

Specified by:

getDefaultLanguage in interface EasyDeskLocalizationService

getDefaultCountry

public String getDefaultCountry()

Specified by:

getDefaultCountry in interface EasyDeskLocalizationService

getDefaultLocale

public Locale getDefaultLocale()

Specified by:

getDefaultLocale in interface EasyDeskLocalizationService

getDefaultBundleName

public String getDefaultBundleName()

Specified by:

getDefaultBundleName in interface EasyDeskLocalizationService

Returns:

첫 번째 bundle 이름 (없으면 빈 문자열)

getBundleNames

public String[] getBundleNames()

Specified by:

getBundleNames in interface EasyDeskLocalizationService

getBundle

public ResourceBundle getBundle()

Specified by:

getBundle in interface EasyDeskLocalizationService

getBundle

public ResourceBundle getBundle(String bundleName)

Specified by:

getBundle in interface EasyDeskLocalizationService

getBundle

public ResourceBundle getBundle(String bundleName,
 Locale locale)

Specified by:

getBundle in interface EasyDeskLocalizationService

Parameters:

bundleName - null 이면 기본 bundle

locale - null 이면 기본 locale

getBundle

public ResourceBundle getBundle(String bundleName,
 String languageHeader)

Specified by:

getBundle in interface EasyDeskLocalizationService

getLocale

public Locale getLocale(String header)

Fulcrum LocaleTokenizer 와 같은 규칙: ',' 로 나누고 ';q=' 값이 큰 순서 (같으면 먼저 나온 것).

Specified by:

getLocale in interface EasyDeskLocalizationService

Returns:

가장 우선순위가 높은 locale. 비었거나 해석할 수 없으면 기본 locale

getString

public String getString(String bundleName,
 Locale locale,
 String key)
                 throws MissingResourceException

Description copied from interface: EasyDeskLocalizationService

bundleName 에서 key 를 찾고, 없으면 나머지 bundle 들에서 차례로 찾는다.

Specified by:

getString in interface EasyDeskLocalizationService

Throws:

MissingResourceException - 어느 bundle 에도 key 가 없을 때

getString

public String getString(String key)

Description copied from interface: EasyDeskLocalizationService

기본 bundle / 기본 locale

Specified by:

getString in interface EasyDeskLocalizationService

getString

public String getString(Locale locale,
 String key)

Description copied from interface: EasyDeskLocalizationService

기본 bundle

Specified by:

getString in interface EasyDeskLocalizationService

getString

public String getString(String bundleName,
 Locale locale,
 LocalizableKey key)
                 throws MissingResourceException

Specified by:

getString in interface EasyDeskLocalizationService

Throws:

MissingResourceException

getString

public String getString(LocalizableKey key)

Specified by:

getString in interface EasyDeskLocalizationService

getString

public String getString(Locale locale,
 LocalizableKey key)

Specified by:

getString in interface EasyDeskLocalizationService

format

public String format(String bundleName,
 Locale locale,
 String key,
 Object... args)

Specified by:

format in interface EasyDeskLocalizationService

format

public String format(String bundleName,
 Locale locale,
 LocalizableKey key,
 Object... args)

Specified by:

format in interface EasyDeskLocalizationService

format

public String format(Locale locale,
 LocalizableKey key,
 Object... args)

Description copied from interface: EasyDeskLocalizationService

기본 bundle

Specified by:

format in interface EasyDeskLocalizationService

format

public String format(LocalizableMessage message,
 Locale locale)

Description copied from interface: EasyDeskLocalizationService

LocalizableMessage(key + parameters) 를 기본 bundle 로 format 한다.

Specified by:

format in interface EasyDeskLocalizationService