net.ymate.platform.commons.i18n.I18N Maven / Gradle / Ivy
/*
* Copyright 2007-2107 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.ymate.platform.commons.i18n;
import java.io.IOException;
import java.io.InputStream;
import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Properties;
import java.util.ResourceBundle;
import java.util.concurrent.ConcurrentHashMap;
import net.ymate.platform.base.YMP;
import net.ymate.platform.commons.util.RuntimeUtils;
import org.apache.commons.lang.StringUtils;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
/**
*
* I18N
*
*
* 国际化资源管理器；
*
*
* @author 刘镇([email protected])
* @version 0.0.0
*
*
* 版本号 动作 修改人 修改时间
*
*
*
* 0.0.0
* 创建类
* 刘镇
* 2013-4-14下午1:36:11
*
*
*/
public class I18N {
private static final Log _LOG = LogFactory.getLog(I18N.class);
protected static Map> __RESOURCES_CAHCES = new ConcurrentHashMap>();
protected static Locale __DEFAULT_LOCALE;
protected static II18NEventHandler __EVENT_HANDLER;
protected static boolean __IS_INITED;
protected static ThreadLocal __CURRENT_LOCALE = new ThreadLocal();
/**
* 初始化
*
* @param defaultLocale 默认语言，若为空则采用JVM默认语言
*/
public static void initialize(Locale defaultLocale) {
if (!__IS_INITED) {
__DEFAULT_LOCALE = defaultLocale == null ? Locale.getDefault() : defaultLocale;
__IS_INITED = true;
_LOG.info(I18N.formatMessage(YMP.__LSTRING_FILE, null, null, "ymp.commons.i18n_init", __DEFAULT_LOCALE));
}
}
/**
* @return 判断是否已初始化
*/
public static boolean isInited() {
return __IS_INITED;
}
/**
* 重置(清空)缓存资源
*/
public static void reset() {
if (__IS_INITED) {
__RESOURCES_CAHCES.clear();
}
}
/**
* @param eventHandler 设置事件监听处理器
*/
public static void setEventHandler(II18NEventHandler eventHandler) {
__EVENT_HANDLER = eventHandler;
}
/**
* @return 获取当前本地线程语言，若为空则返回默认
*/
public static Locale current() {
if (!__IS_INITED) {
throw new UnsupportedOperationException(I18N.formatMessage(YMP.__LSTRING_FILE, null, null, "ymp.commons.i18n_not_init"));
}
Locale _locale = __CURRENT_LOCALE.get();
if (_locale == null) {
if (__EVENT_HANDLER != null) {
_locale = __EVENT_HANDLER.loadCurrentLocale();
}
}
return _locale == null ? __DEFAULT_LOCALE : _locale;
}
/**
* @param locale
* @return 修改当前线程语言设置，不触发事件，并返回修改结果
*/
public static boolean set(Locale locale) {
if (locale != null && !current().equals(locale)) {
__CURRENT_LOCALE.set(locale);
return true;
}
return false;
}
/**
* 修改当前线程语言设置并触发onLocaleChanged事件
*
* @param locale
*/
public static void change(Locale locale) {
if (set(locale)) {
if (__EVENT_HANDLER != null) {
__EVENT_HANDLER.onLocaleChanged(locale);
}
}
}
/**
* @param resourceName 资源名称
* @param key 键值
* @return 加载资源并提取key指定的值
*/
public static String load(String resourceName, String key) {
return load(resourceName, key, "");
}
/**
* @param resourceName 资源名称
* @param key 键值
* @param defaultValue 默认值
* @return 加载资源并提取key指定的值
*/
public static String load(String resourceName, String key, String defaultValue) {
Map _cache = __RESOURCES_CAHCES.get(current());
Properties _prop = _cache != null? _cache.get(resourceName) : null;
if (_prop == null) {
if (__EVENT_HANDLER != null) {
try {
List _localeResourceNames = resourceNames(current(), resourceName);
InputStream _inputStream = null;
for (String _localeResourceName : _localeResourceNames) {
_inputStream = __EVENT_HANDLER.onLoadProperties(_localeResourceName);
if (_inputStream != null) {
break;
}
}
if (_inputStream == null) {
for (String _localeResourceName : _localeResourceNames) {
_inputStream = I18N.class.getClassLoader().getResourceAsStream(_localeResourceName);
if (_inputStream != null) {
break;
}
}
}
if (_inputStream != null) {
_prop = new Properties();
_prop.load(_inputStream);
}
if (_prop != null && !_prop.isEmpty()) {
if (_cache == null) {
__RESOURCES_CAHCES.put(current(), new ConcurrentHashMap());
}
__RESOURCES_CAHCES.get(current()).put(resourceName, _prop);
}
} catch (IOException e) {
_LOG.warn("", RuntimeUtils.unwrapThrow(e));
}
}
}
String _returnValue = null;
if (_prop != null) {
_returnValue = _prop.getProperty(key, defaultValue);
}
return StringUtils.defaultIfEmpty(_returnValue, defaultValue);
}
/**
* @param locale
* @param resourceName
* @return 拼装资源文件名称集合
*/
protected static List resourceNames(Locale locale, String resourceName) {
List _names = new ArrayList();
_names.add(resourceName + ".properties");
String _localeKey = (locale == null) ? "" : locale.toString();
if (_localeKey.length() > 0) {
resourceName += ("_" + _localeKey);
}
_names.add(0, resourceName += ".properties");
return _names;
}
/**
* 销毁
*/
public static void destroy() {
if (__IS_INITED) {
__RESOURCES_CAHCES.clear();
__IS_INITED = false;
}
}
/**
* @param name
* @param locale
* @param loader
* @return
*/
public static ResourceBundle getBundle(String name, Locale locale, ClassLoader loader) {
if (loader != null) {
return ResourceBundle.getBundle(name, (locale == null ? Locale.getDefault() : locale), loader);
}
return ResourceBundle.getBundle(name, (locale == null ? Locale.getDefault() : locale));
}
/**
* @param bundleName
* @param locale
* @param loader
* @param msgKey
* @param args
* @return
*/
public static String formatMessage(String bundleName, Locale locale, ClassLoader loader, String msgKey, Object...args) {
return formatMessage(getBundle(bundleName, locale, loader).getString(msgKey), args);
}
/**
* @param msg
* @param args
* @return 格式化消息字符串与参数绑定
*/
public static String formatMessage(String msg, Object...args) {
if (args != null && args.length > 0) {
return MessageFormat.format(msg, args);
}
return msg;
}
}