对于有国际化要求的应用系统,通俗地说,就是多语言版本的软件啦,我们要为每一种语言提供一套相应的资源文件,并按照规范化的命名方式保存在规定的目录中,然后由系统根据客户端的选择,来选定适合的资源文件。
国际化信息也称为本地化信息 。 Java 通过 java.util.Locale
类来表示本地化对象,它通过 “语言类型” 和 “国家/地区” 来创建一个确定的本地化对象 。
语言参数使用 ISO 标准语言代码来表示,这是由 ISO-639 标准定义的,每种语言由两位小写字母表示 。 语言代码列表请点击这里。
国家/地区参数也由标准的 ISO 国家/地区代码标识,具体是由 ISO-3166 标准定义,每个国家/地区参数都是由两个大写字母标识 的。 国家/地区代码列表请点击这里。
1 java.util.Locale
java.util.Locale 是表示语言和国家/地区信息的本地化类,它是创建国际化应用的基础 。
它有这些常用的实例化方式:
方式 | 说明 | 示例 |
---|---|---|
Locale(String language, String country) | 根据语言和国家/地区参数,来创建对象。 | new Locale("zh",“CN”) |
Locale(String language) | 只根据语言参数,来创建对象。 | new Locale("zh") 相当于 new Locale("zh",“CN”) |
使用静态的 Locale | Locale 定义了各个国家的静态 Locale。 | Locale.CHINA |
获取本地默认的对象 | - | Locale.getDefault(); |
注意:如果希望改变系统默认的本地化设置,那么可以在启动 JVM 时通过命令参数来指定:-Duser.language=en -Duser.region=US
。
2 本地化工具类
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}
表示从第二个入参中获取日期部分的值,显示为长样式时间。
3 java.util.ResourceBundle
为了国际化,我们需要为不同的本地化类型分别提供对应的资源文件,并以规范的方式进行命名 。命名格式为:
<资源名>_<语言代码>_<国家/地区代码>.properties
- 语言代码和国家/地区代码都是可选的。
-
< 资源名 >.properties
命名的文件是默认的资源文件,即某个本地化类型在系统中找不到对应的资源文件,就采用这个默认的资源文件。 -
< 资源名 >_< 语言代码 >.properties
命名的国际化资源文件是某一语言默认的资源文件,即某个本地化类型在系统中找不到精确匹配的资源文件时,将采用相应语言默认的资源文件 。
假设我们需要国际化主页信息,资源文件名为 "content",那么中国的本地化资源文件名就为 content_zh_CN.properties
;美国的本地化资源文件名为 content_en_US.properties
。
content_zh_CN.properties 内容:
index.greeting=\u6B22\u8FCE\u60A8
中文的本地化资源文件内容采用了特殊的编码来表示中文字符,这是因为资源文件只能使用 ASCII 字符 。 所以必须将非 ASCII 字符的内容转换为 Unicode 代码的表示方式 。
在过去可以使用 JDK 自带的 native2ascii 工具来进行转换,在 IDEA 中可以通过设置直接编写中文内容,然后系统就会实现自动转换啦:
eclipse 中也有类似的功能。
设置之后的效果:
index.greeting=欢迎您
content_en_US.properties 内容:
index.greeting=Welcome
Java提供了用于加载本地化资源文件的类 java.util.ResourceBundle
。
把刚才创建的不同语言的配置文件,放在 resources/i18n 下:
示例:
final String baseName = "i18n/content";
final String key = "index.greeting";
System.out.println("中国:"+ResourceBundle.getBundle(baseName,
Locale.CHINA).getString(key));
System.out.println("美国:"+ResourceBundle.getBundle(baseName,
Locale.US).getString(key));
输出结果:
中国:欢迎您
美国:Welcome
ResourceBundle 加载资源的顺序是这样的,以指定了美国地区的资源文件为例:
- 尝试加载指定的本地化资源文件(xxx_en_US.properties)。
- 尝试加载本地系统默认的资源文件(xxx_zh_CN.properties)。
- 尝试加载默认的资源文件(xxx.properties) 。
- 以上资源文件都不存在,则抛出
java.util.MissingResourceException
。
4 在资源文件中使用格式化字符串
使用带占位符的格式化串作为资源文件的属性值并结合使用 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