java国际化——资源包

【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.properties
1.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对应的valuestatic 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文件中的keysstatic 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对应的valuestatic 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: