【0】README
1) 本文部分文字描述转自 core java volume 2 , 旨在理解 java国际化——资源包 的基础知识 ;
2) 本文源代码idea 转自: (利用properties 文件进行国际化)https://docs.oracle.com/javase/tutorial/i18n/resbundle/propfile.html 和 (利用.class 文件进行国际化)https://docs.oracle.com/javase/tutorial/i18n/resbundle/list.html
【1】java国际化——资源包相关
1)problem+solution
- 1.1)problem: 当本地化一个应用时, 可能会有大量的消息字符串, 按钮标签和其它的东西需要被翻译;
- 1.2)solution: 你会希望在外部定义消息字符串, 通常称之为资源。 在java中, 需要使用属性文件来设定字符串资源,并为其它类型的资源实现相应的类; (干货——java 资源的定义)
【2】定位资源包
1)当本地化一个应用时,会制造出很多资源包。每个包都是一个属性文件或者是一个描述了与 locale 相关的项的类。对于每一个包, 都要为所有你想要支持的 locale 提供相应的版本;
2)想要对这些包使用一种统一的命名规则: (干货——资源包统一命名规则)
2.1)包名语言国家;
2.2)包名_语言;
来命名所有和语言相关的资源。
2.3)最后,作为后备, 可以把默认资源放到一个没有后缀的文件中;
2.3.1)可以用下面的命令加载一个包:
ResourceBundle resource = ResourceBundle.getBundle(bundleName, currentLocale);
2.3.2) getBundle 方法试图加载匹配当前 locale 定义的语言和国家的包。如果失败, 通过依次放弃国家和语言来继续进行查找, 然后同样的查找被应用于默认的 locale;
- 2.3.3)最后, 如果还不行的话就去查看默认的包文件, 如果这也失败了, 就抛出一个异常 MissingResourceException;
3)也就是说, getBundle 方法试图加载以下的包: (干货—— getBundle 方法试图加载包名的顺序)
(1)包名当前locale的语言当前Locale的国家_当前Locale的变量;
(2)包名当前locale的语言当前Locale的国家;
(3)包名_当前locale的语言;
(4)包名默认locale的语言默认Locale的国家_默认Locale的变量;
(5)包名默认locale的语言默认Locale的国家;
(6)包名_默认locale的语言;
(7)包名;
4)总之, java 的资源包机制会自动定位与给定的locale 匹配得最好的项。
- 4.1)可以很容易地吧越来越多的本地化信息加到已有的程序中: 你需要做的只是增加额外的资源包;
【2】利用属性文件进行国际化
1)对字符串进行国际化是很直接的, 你可以吧字符串放到一个属性文件中, 典型的 属性文件内容如下: (干货——属性文件引入原因——为了对字符串进行国际化,需要定义属性文件)
computeButton=Rechnen
colorName=black
defaultPaperSize=210X297
1.1)然后利用以上提到的规则去命名你的属性文件;
MyprocStrings.properties
MyprocStrings_en.properties
MyprocStrings_de_DE.properties1.2)你可以直接加载包:如
ResourceBundle bundle = ResourceBundle.getBundle(“MyProcStrings”, locale);
1.3)要查找一个具体的字符串,可以调用:
string str = bundle.getString(“colorName”);Warning)
- W1)存储属性的文件都是ASCII文件, 如果你需要将 Unicode 字符放到属性文件中, 那么请用\uxxxx 编码方式对它们进行编码。
- W2)你可以使用 native2ascii 工具来产生这些文件;
2)看个利用.properties文件进行国际化的荔枝:
- 2.1)for souce code, please visit : https://github.com/pacosonTang/core-java-volume/tree/master/coreJavaAdvanced/chapter5/ResourceBundle_Properties
- 2.2)key source code at a glance:
public class PropertiesDemo
{
// 显示与给定Locale相关的.properties文件中的key对应的value
static void displayValue(Locale locale, String key)
{
ResourceBundle labels = ResourceBundle.getBundle("LabelBundle", locale);
String value = labels.getString(key);
System.out.println("locale = " + locale.getDisplayName() +
", key = " + key + ", value = " + value);
}
// 迭代与给定Locale相关的.properties文件中的keys
static void iterateKeys(Locale locale)
{
ResourceBundle labels = ResourceBundle.getBundle("LabelBundle", locale);
Enumeration<String> keys = labels.getKeys();
while(keys.hasMoreElements())
{
String key = keys.nextElement();
String value = labels.getString(key);
System.out.println("locale = " + locale.getDisplayName() +
", key = " + key + ", value = " + value);
}
}
public static void main(String[] args)
{
Locale.setDefault(Locale.ENGLISH);
Locale[] supportedLocales =
{
Locale.CHINA,
Locale.GERMAN,
Locale.ENGLISH
};
System.out.println("=== the output of method displayValue is as follows: ===\n");
for (int i = 0; i < supportedLocales.length; i++)
{
displayValue(supportedLocales[i], "s2");
}
System.out.println();
System.out.println("=== the output of method iterateKeys is as follows: ===\n");
iterateKeys(supportedLocales[0]);
}
}
2.3)relative printing results as follows:
【3】利用包类进行国际化
1) 为了提供字符串外的资源,需要定义类, 它必须扩展于 ResourceBundle 类, 应该使用标准的命名规则来命名你的类, 如:(干货——资源绑定类引入原因——为了对字符串外的资源进行国际化,需要定义资源绑定类)(干货——包类的命名规则)
MyprogResources.java
MyprogResources_en.java
MyprogResources_de_DE.java
2)你可以使用 与 加载属性文件相同的getBundle 方法来加载这个类: (干货——加载资源绑定类与资源包的方法相同,即getBuddle)
ResourceBundle bundle = ResourceBundle .getBundle(“MyprogResources”, locale);
Warning) 当搜索包时, 如果在类中的包和在属性文件中的包中都存在匹配, 优先选择类中的包;
3)每一个资源绑定类都实现了一个查询表。
3.1)你需要为每一个你想定位的设置都提供一个关键字字符串, 使用这个字符串来提取相应的设置, 如;
Color background = (Color) bundle.getObject(“background”);
double[] papersize = (double[]) bundle.getObject(“defaultSize”);3.2)使用资源绑定类的最简单方法就是 继承 ListReourceBundle类; (干货——使用资源绑定类的最简单方法就是 继承 ListReourceBundle类)
- 3.3)ListReourceBundle: 让你把所有资源都放到一个对象数组并提供查找功能, 请遵循以下框架代码:
public class bundleName_language_country extends ListResourceBundle
{
private static final Object[][] contents =
{
{key1, value1];
{key1, value1];
…
}
public Object[][] getContents() { return contents ; }
}
4)看个荔枝:
public class ProgramResource_de extends ListResourceBundle
{
private static final Object[][] contents =
{
{"background",Color.black];
{"defaultPaperSize", new double[]{210, 297}}
...
}
public Object[][] getContents() { return contents ; }
}
**5)**或者, 你的资源绑定类可以扩展 ResourceBundle 类。 然后需要实现两个方法, 一个是枚举所有键,二是用给定的键查找相应的值:
Enumeration<String> getKeys();
Object handleGetObject(String key);
ResourceBundle 类的 getObject 方法会调用你提供的 handleGetBundle 方法;
6)看个利用.class文件进行国际化的荔枝:
- 6.1)for souce code, please visit : https://github.com/pacosonTang/core-java-volume/tree/master/coreJavaAdvanced/chapter5/ResourceBundle_Class
- 6.2)key source code at a glance:
public class ListResourceBundleDemo
{
// 显示与给定Locale相关的.properties文件中的key对应的value
static void displayValue(Locale locale)
{
ResourceBundle stats = ResourceBundle.getBundle("com.corejava.chapter573.StatsBundle", locale);
Integer gdp = (Integer) stats.getObject("GDP");
Integer population = (Integer) stats.getObject("Population");
Double literacy = (Double)stats.getObject("Literacy");
System.out.println("locale = " + locale.getDisplayName() +
", gdp = " + gdp + ", population = " + population + ", literacy = " + literacy);
}
public static void main(String[] args)
{
Locale.setDefault(Locale.US);
Locale[] locales =
{
new Locale("en", "CA"),
new Locale("de", "DE"),
new Locale("zh", "CN")
};
for (int i = 0; i < locales.length; i++)
{
displayValue(locales[i]);
}
}
}
- 6.3)relative printing results as follows: