背景:企业项目中,往往面对国际的。针对不同地区语言,ResourceBundle主要用来处理本地化资源和国际化资源的问题,向用户展示合理的界面显示。
ResourceBundle
官方解释:一堆有着相同前缀名称但有着不同语言后缀名称的属性文件的集合,且至少包含2个有着相似前缀名称的属性文件。
用途:从适合当前用户语言环境的资源包,一适应不同语言环境,后期提示语均在配置文件中,修改便捷。
配合Locale使用:查询Java所支持的国家和语言,方便查询强制化Local属性。
package study;
import java.util.Locale;
import java.util.ResourceBundle;
public class Test {
public static void main(String[] args) {
Locale[] localeList = Locale.getAvailableLocales();
//遍历数组的每个元素,依次获取所支持的国家和语言
for (int i = 0; i < localeList.length ; i++ )
{
System.out.println(localeList[i].getCountry()+ "( "+localeList[i].getDisplayCountry() +") "
+localeList[i].getLanguage()+"("+localeList[i].getDisplayLanguage()+")");
}
}
加载顺序
优先级:本地化资源(默认)>加载系统默认>加载默认的资源文件。
不存在:java.util.MissingResourceException。
本地资源构建:新建myconfig.properties相关文件
myconfig.properties:local=default
myconfig_zh_CN.properties:local=zh_CN
myconfig_en_US.properties:local=en_US
package study;
import java.util.Locale;
import java.util.ResourceBundle;
public class Test {
public static void main(String[] args) {
//取得系统默认的国家/语言环境
System.out.println("=================");
//获取本地语言地区属性
System.out.println("default:"+Locale.getDefault());
//加载默认src下,但是不能读取其他文件加载,本class在src.study下,所以需要加前缀。
ResourceBundle resourceBundle0 = ResourceBundle.getBundle("study.myconfig");
System.out.println(resourceBundle0.getString("local"));
System.out.println("=================");
//中文测试
Locale locale1 = new Locale("zh", "CN");
ResourceBundle resourceBundle1 = ResourceBundle.getBundle("study.myconfig",locale1);
System.out.println(resourceBundle1.getString("local"));
System.out.println("=================");
//英文测试
Locale locale2 = new Locale("en", "US");
ResourceBundle resourceBundle2 = ResourceBundle.getBundle("study.myconfig",locale2);
System.out.println(resourceBundle2.getString("local"));
System.out.println("=================");
//德文测试,但不存在该语言的Properties
Locale locale3 = new Locale("de", "GR");
ResourceBundle resourceBundle3 = ResourceBundle.getBundle("study.myconfig",locale3);
System.out.println(resourceBundle3.getString("local"));
}
测试结果:顺序:对于中国用户:中国>默认。英国用户:英国>默认。 德国:中国>默认(德国不存在,但是不是直接走默认,而是先走中国,中国是本地化资源!!!)
特别:
1.属性key-value,若上级资源中没有key,则去下级资源中寻找。
2.优先走本地化资源文件。若不存在,则走不带后缀文件,本地化资源文件不等于默认不带后缀的配置文件。
删除myconfig_zh_CN.properties:
顺序:对于中国用户:默认。英国用户:英国>默认。 德国:默认(德国不存在,但是不是直接走默认,而是先走中国,中国是本地化资源!!!)
其他注意:
报错:Can't find bundle for base name myconfig, locale xx_XX。查找文件路径是否正确。
- 直接配置,src下读取,但是内部文件夹,需要前缀读取。
- src路径下的文件在编译后会放到WEB-INF/clases路径下(默认的classpath)
- 直接放到WEB-INF下的话,是不在classpath下的
编码:
底层读取Properties文件是根据字节流的形式,防止中文乱码,建议配置文件存在中文等,使用Unicode字符集进行配置。
源码片段:
else if (format.equals("java.properties")) {
final String resourceName = toResourceName0(bundleName, "properties");
if (resourceName == null) {
return bundle;
}
final ClassLoader classLoader = loader;
final boolean reloadFlag = reload;
InputStream stream = null;
try {
stream = AccessController.doPrivileged(
new PrivilegedExceptionAction<InputStream>() {
public InputStream run() throws IOException {
InputStream is = null;
if (reloadFlag) {
URL url = classLoader.getResource(resourceName);
if (url != null) {
URLConnection connection = url.openConnection();
if (connection != null) {
// Disable caches to get fresh data for
// reloading.
connection.setUseCaches(false);
is = connection.getInputStream();
}
}
} else {
is = classLoader.getResourceAsStream(resourceName);
}
return is;
}
});
} catch (PrivilegedActionException e) {
throw (IOException) e.getException();
}
经验
1.可以通过只配置myconfig.properties来全局变量,不配置其他语言文件。
2.企业项目中,配合PropertyUtils,设置map.properties,不打包,当国际化各个配置文件找不到相应提示,提供一个类别管理的报错。
3.编码问题请使用Unicode字符集输入,可以使用在线转码工具也可以配合java自带的native2ascii.exe
4.配合NumberFormat ,DateFormat进行String处理
补充
Properties补充:
https://www.cnblogs.com/alfredinchange/p/5384760.html
ResourceBundle运行会自行将配置文件打包,也可以根据情况自己配合idea打包:https://segmentfault.com/a/1190000016496715
Spring相关:https://blog.csdn.net/u010882791/article/details/83756717