java locale.us_JAVA实现国际化

## 1 Java国际化的思路

Java程序的国际化的思路是将程序中的标签、提示等信息放在资源文件中，程序需要支持哪些国家、语言环境，就对应提供相应的资源文件。资源文件是key-value对，每个资源文件中的key是不变的，但value则随不同国家、语言改变。

Java程序的国际化主要通过如下三个类完成：

Ø java.util.ResourceBundle：用于加载一个国家、语言资源包。

ResourceBundle 加载资源的顺序是这样的，以指定了美国地区的资源文件为例：

1. 尝试加载指定的本地化资源文件(xxx_en_US.properties)。

2. 尝试加载本地系统默认的资源文件(xxx_zh_CN.properties)。

3. 尝试加载默认的资源文件(xxx.properties) 。

4. 以上资源文件都不存在，则抛出 java.util.MissingResourceException。

Ø java.util.Locale：用于封装一个特定的国家/区域、语言环境。


Ø java.text.MessageFormat：用于格式化带占位符的字符串。

为了实现程序的国际化，必须先提供程序所需要的资源文件。资源文件的内容是很多key-value对。其中key是程序使用的部分，而value则是程序界面的显示字符串。

资源文件的命名可以有如下三种形式：

Ø baseName _ language _country.properties

Ø baseName _language.properties

Ø baseName.properties

**其中baseName是资源文件的基本名，用户可以自由定义。而language和country都不可随意变化，必须是Java所支持的语言和国家。**

## 本地化工具类

### 2.1 NumberFormat

NumberFormat 可以按照本地化的方式来操作货币金额：

```

public class LocaleTest {

Locale chinaLocale;

Locale americaLocale;

@BeforeClass

public void init() {

chinaLocale = new Locale("zh", "CN");

americaLocale = new Locale("en", "US");

}

@Test

public void numberFormat() {

final double money = 2972.29d;

NumberFormat format = NumberFormat.getCurrencyInstance(chinaLocale);

System.out.println("中国：" + format.format(money));

NumberFormat format2 = NumberFormat.getCurrencyInstance(americaLocale);

System.out.println("美国：" + format2.format(money));

}

}

```

输出结果：

> 中国：￥2,972.29

美国：$2,972.29

### 2.2 DateFormat

使用 getDateInstance(int style,Locale aLocale) 方法格式化日期。

style：时间样式。

aLocale：本地化对象。

```

Date date=new Date();

DateFormat format=DateFormat.getDateInstance(DateFormat.MEDIUM, chinaLocale);

System.out.println("中国：" +format.format(date));

DateFormat format2=DateFormat.getDateInstance(DateFormat.MEDIUM, americaLocale);

System.out.println("美国：" +format2.format(date));

```

输出结果：

> 中国：2018-5-23

美国：May 23, 2018

### 2.3 MessageFormat

MessageFormat 在 NumberFormat 和 DateFormat 的基础上，提供了更强大的占位符格式化功能，支持时间 、 货币 、 数字以及对象属性的格式化操作 。

```

//定义占位符参数

Object[] params={"Jack",new GregorianCalendar().getTime(),238.2E5};

String pattern1="{0}，您好！您的账户在 {1} 收到 {2} 元";

System.out.println(MessageFormat.format(pattern1,params));//使用默认本地化对象

String pattern2="{0}，hello！Your account have received {2,number,currency} at {1," +

"time,short} on " +

"{1,date,long}";

System.out.println(new MessageFormat(pattern2,Locale.US).format(params));//使用指定的本地化对象

```

> Jack，您好！您的账户在 18-5-23 下午3:18 收到 23,820,000 元

Jack，hello！Your account have received $23,820,000.00 at 3:18 PM on May 23, 2018

pattern1 是简单形式的格式化信息串，通过 {n} 占位符来指定动态参数的替换位置索引，{0} 表示第一个参数， {1} 表示第二个参数，以此类推 。

pattern2 格式化信息串除了参数位置索引外，还指定了参数的类型和样式 。 这种语法很灵活，比如一个参数可以出现在多处：如 {1,time,short} 表示从第二个入参中获取时间部分的值，显示为短样式时间；而 {1,date,long} 表示从第二个入参中获取日期部分的值，显示为长样式时间。

## 2 Java支持的语言和国家

事实上，Java不可能支持所有国家和语言，如需要获取Java所支持的语言和国家，可调用Locale类的getAvailableLocale方法获取，该方法返回一个Locale数组，该数组里包含了Java所支持的语言和国家。

下面的程序简单地示范了如何获取Java所支持的国家和语言：

```

public class LocaleList

{

public static void main(String[] args)

{

//返回Java所支持的全部国家和语言的数组

Locale[] localeList = Locale.getAvailableLocales();

//遍历数组的每个元素，依次获取所支持的国家和语言

for (int i = 0; i < localeList.length ; i++ )

{

//打印出所支持的国家和语言

System.out.println(localeList[i].getDisplayCountry() + "=" + locale

List[i].getCountry()+ " " + localeList[i].getDisplayLanguage()

+ "=" + localeList[i].getLanguage());

}

}

}

```

通过该程序，我们就可以获得Java程序所支持的国家/语言环境。

### 在资源文件中使用格式化字符串

使用带占位符的格式化串作为资源文件的属性值并结合使用 MessageFormat 就可以在运行时动态地构造出灵活的信息啦O(∩_∩)O~

修改之前的资源文件，加入格式化串。

params_en_US.properties：

```

index.greeting=欢迎您 {0}，现在时间 {1}

```

params_zh_CN.properties：

```

index.greeting=Welcome {0}，current time is {1}

```

调用代码：

```

Object[] params = {"Jack", new GregorianCalendar().getTime()};

ResourceBundle rb1 = ResourceBundle.getBundle("i18n/params", Locale.CHINA);

System.out.println("中国：" + new MessageFormat(rb1.getString("index.greeting"), Locale

.CHINA)

.format(params));

ResourceBundle rb2 = ResourceBundle.getBundle("i18n/params", Locale.US);

System.out.println("美国：" + new MessageFormat(rb2.getString("index.greeting"), Locale

.US)

.format(params));

```

输出结果：

> 中国：欢迎您 Jack，现在时间 18-5-25 下午7:53

美国：Welcome Jack，current time is 5/25/18 7:53 PM

## 3 完成程序国际化

对于如下最简单的程序：

```

public class RawHello{

public static void main(String[] args){

System.out.println("Hello World");

}

}

```

这个程序的执行结果也很简单：肯定是打印出简单的“Hello World”字符串，不管在哪里执行都不会有任何改变！为了让该程序支持国际化，则肯定不能让程序直接输出“Hello World”的字符串，这种写法直接输出一个字符串常量，永远不会有任何改变。为了让程序可以输出不同的字符串，此处绝不可使用该字符串常量。

为了让上面输出的字符串常量可以改变，我们将需要输出的各种字符串(不同国家/语言环境对应不同的字符串)定义在资源包中。

我们为上面程序提供如下两个文件：

第一个文件：mess_zh_CN.properties，该文件的内容为：

#资源文件的内容是key-value对。

hello=你好！

第二个文件：mess_en_US.properties，该文件的内容为：

#资源文件的内容是key-value对。

hello=Welcome You!

对于包含非西欧字符的资源文件，Java提供了一个工具来处理该文件：native2ascii，这个工具可以在%JAVA_HOME%/bin路径下找到。使用该工具的语法格式如下：

native2ascii 源资源文件 目的资源文件

如果我们在命令窗口输入如下指令：

#使用native2ascii命令处理mess_zh_CN.properties文件，生成aa.properties文件

native2ascii mess_zh_CN.properties aa.properties

上面的命令将生成一个aa.properties文件，该文件才是我们需要的资源文件，该文件看上去包含很多乱码，其实是非西欧字符的UNICODE编码方式，这完全正常。将该文件重命名为mess_zh_CN.properties即可。

我们看到这两份文件文件名的baseName是相同的：mess。前面已经介绍了资源文件的三种命名方式，其中baseName后面的国家、语言必须是Java所支持的国家、语言组合。

将上面的Java程序修改成如下形式：

public class Hello

{

public static void main(String[] args)

{

//取得系统默认的国家/语言环境

Locale myLocale = Locale.getDefault();

//根据指定国家/语言环境加载资源文件

ResourceBundle bundle = ResourceBundle.getBundle("mess" , myLocale);

//打印从资源文件中取得的消息

System.out.println(bundle.getString("hello"));

}

}

上面程序中的打印语句不再是直接打印“Hello World”字符串，而是打印了从资源包中读取的信息。如果在中文环境下运行该程序，将打印“你好！”；如果我们在“控制面板”将机器的语言环境设置成美国，然后再次运行该程序，将打印“Welcome You!”字符串。

通过上面的简单程序，我们可以体会到Java程序的国际化是多么简单！

从上面程序可以看出：如果我们希望程序完成国际化，只需要将不同国家/语言(Locale)的提示信息分别以不同文件存放。例如简体中文的语言资源文件就是Xxx_zh_CN.properties文件，而美国英语的语言资源文件就是Xxx_en_US.properties文件。

Java程序国际化的关键类是ResourceBundle，它有一个静态方法：getBundle(String baseName , Locale locale);该方法将根据Locale加载资源文件，而Locale封装了一个国家、语言，例如简体中文的环境可以用简体中文的Locale代表，美国英语的环境可以用美国英语的Locale代表。

从上面资源文件的命名中可以看出，不同语言、国家环境的资源文件的baseName是相同的，即baseName为mess的资源文件有很多个，不同国家、语言环境对应不同的资源文件。

例如通过如下代码来加载资源文件：

//根据指定国家/语言环境加载资源文件

ResourceBundle bundle = ResourceBundle.getBundle("mess" , myLocale);

上面代码将会加载baseName为mess的系列资源文件的其中之一，到底加载其中的哪个，则取决于myLocale，对于简体中文的Locale，则加载mess_zh_CN.properties文件。

一旦加载了该文件后，该资源文件的内容就是多个key-value对，程序就根据key来获取指定信息，例如获取key为hello的消息，该消息是“你好！”——这就是Java程序国际化的过程。

如果对于美国英语的Locale，则加载mess_en_US.properties，该文件中的key为hello的消息是“Welcome You!”。

Java程序国际化的关键类是ResourceBundle和Locale，ResourceBundle来根据不同Loacle加载语言资源文件，再根据指定key取得已加载语言资源文件中的字符串即可。