每个面向国际的语言都需要有自己的国际化解决方案,Java 从一开始就是用 Unicode
来处理所有的字符串,这让 Java 具备了国际化的一个重要特性。除了提供 Unicode
之外,Java 还需要解决不同区域的表示形式。
Locale
java.util
包中提供了 Locale
类用来处理不同的语言和区域上的国际化问题。使用 Locale
类可以定制一个区域的信息,而 Locale
类提供了如下构造方法来构造 Locale
对象。
public final class Locale implements Cloneable, Serializable {
// 从语言,国家和变体构造语言环境
public Locale(String language, String country, String variant) {
···
}
// 从语言和国家构造语言环境
public Locale(String language, String country) {
···
}
// 从语言代码构造语言环境
public Locale(String language) {
···
}
}
由构造方法可知,构造一个 Locale
,可以设置语言、国家或地区、和变体。语言是由 2 个或 3 个小写字母表示,例如 zh
、en
或 de
。这里可以查看 ISO-639-1
语言代码标识。
Locale
中预定义了大量的 Locale
语言,他们只设定了语言而没有设定国家,如下所示。
// 英语
public static final Locale ENGLISH = createConstant("en", "");
// 法语
public static final Locale FRENCH = createConstant("fr", "");
// 德语
public static final Locale GERMAN = createConstant("de", "");
// 意大利语
public static final Locale ITALIAN = createConstant("it", "");
// 日语
public static final Locale JAPANESE = createConstant("ja", "");
// 韩语
public static final Locale KOREAN = createConstant("ko", "");
// 汉语
public static final Locale CHINESE = createConstant("zh", "");
// 简体中文
public static final Locale SIMPLIFIED_CHINESE = createConstant("zh", "CN");
// 繁体中文
public static final Locale TRADITIONAL_CHINESE = createConstant("zh", "TW");
国家和地区也是由 2 个大小字母或 3 个数字表示,例如 CN
、US
或 DE
。这里可以查看 ISO-3166-1
中的国家或地区标识。
Locale
中也为各个国家预定义了 Locale
对象,如下所示。
// 法国
public static final Locale FRANCE = createConstant("fr", "FR");
// 德国
public static final Locale GERMANY = createConstant("de", "DE");
// 意大利
public static final Locale ITALY = createConstant("it", "IT");
// 日本
public static final Locale JAPAN = createConstant("ja", "JP");
// 韩国
public static final Locale KOREA = createConstant("ko", "KR");
// 中国
public static final Locale CHINA = SIMPLIFIED_CHINESE;
// 中华人名共和国
public static final Locale PRC = SIMPLIFIED_CHINESE;
// 台湾
public static final Locale TAIWAN = TRADITIONAL_CHINESE;
// 英国
public static final Locale UK = createConstant("en", "GB");
// 美国
public static final Locale US = createConstant("en", "US");
// 加拿大
public static final Locale CANADA = createConstant("en", "CA");
// 法国裔加拿大
public static final Locale CANADA_FRENCH = createConstant("fr", "CA");
// 表示根语言环境的常量
public static final Locale ROOT = createConstant("", "");
变体,用于指定各种杂项特性,如果有多个变量值,每个变量值都指示其自己的语义,则这些值应按重要性排序,并用下划线分隔。变体字段区分大小写。
Locale
除了构造方法可以构造 Locale
对象,Java SE 7 还提供了 forLanguageTag
静态方法来构建 Locale
对象,如下所示:
Locale zhChinese = Locale.forLanguageTag("zh-CN");
Locale twChinese = Locale.forLanguageTag("zh-TW");
System.out.println(zhChinese.getDisplayName());
System.out.println(twChinese.getDisplayName());
// 中文(中国)
// 中文(台湾)
Locale
中 setDefault
方法可以将更改默认地区,并使用 getDefault
方法获取当前的 Locale
对象,如下所示:
System.out.println(Locale.getDefault());
Locale.setDefault(Locale.US);
System.out.println(Locale.getDefault());
// zh_CN
// en-US
Locale
中提供的 getAvailableLocale
静态方法会返回由 JVM 所能够识别的所有 Locale
构成的数组。
ResourceBundle
使用 Locale
设置具体的语言和区域后,就可以使用 ResourceBundle
根据不同的 Locale
对资源进行加载。资源需要放在 resources
资源包中,并根据不同 Locale
设置对应的资源文件。如下所示,通过 ResourceBundle
类提供的 getBundle
静态方法,来根据 locale
自动绑定对应的资源文件。
Locale locale = Locale.CHINA;
ResourceBundle bundle = ResourceBundle.getBundle("i18n", locale);
查找一个具体的字符串,可以调用
String language = bundle.getString("language");
这里的资源文件的名称使用统一的命名规则,然后根据不同的区域,要标识其本地信息的附加部分。例如,一个资源包的命名是 i18n
,则与中文、英文环境相对应的资源如下图所示。
这里可以把默认资源放在一个没有后缀 i18n
文件中,然后 getBundle
方法定位 i18n_zh_CN
时,还会继续查找文件 i18n_zh
和默认文件 i18n
这两个文件,如果这些文件存在,它们在资源层次中会成为 i18n_zh_CN
的父文件。以后,当查找一个资源时,如果当前资源文件中没有找到,就会去查找其父资源文件。
后缀名为 .properties
的文件中,属性是采用 =
分隔的键值对的形式,如下所示:
language=中文
color=红色
ResourceBundle
是一个抽象类,如下所示。
public abstract class ResourceBundle {
...
}
继承了 ResourceBundle
的类有具体的实现类 PropertyResourceBundle
和抽象类 ListResourceBundle
。而 PropertyResourceBundle
是用来支持 ResourceBundle
读取 properties
资源文件的具体子类,但不需要直接使用 PropertyResourceBundle
,ResourceBundle.getBundle
会自动查找相应的属性文件,并创建一个引用它的 PropertyResourceBundle
。但是 properties
资源文件提供的值只能是字符串。
如果想提供以外的资源,需要继承 ListResourceBundle
抽象类并把所有资源放到一个对象数组中并提供查找功能,如下所示。
public class I18N extends ListResourceBundle {
@Override
protected Object[][] getContents() {
return new Object[][]{
{"color", "yellow" }
};
}
}
public class I18N_zh extends ListResourceBundle {
@Override
protected Object[][] getContents() {
return new Object[][]{
{"language", new String[]{"简体中文", "繁体中文"}}
};
}
}
public class I18N_zh_CN extends ListResourceBundle {
@Override
protected Object[][] getContents() {
return new Object[][]{
{"language", "简体中文"},
{"color", new String[]{"红色", "黄色", "黑色"} }
};
}
}
这里的类的命名规则也使用标准命名规则来命名。然后使用 getBundle
方法来加载对应的类:
ResourceBundle bundle = ResourceBundle.getBundle("I18N", Locale.forLanguageTag("zh-CN"));
System.out.println(bundle.getString("language"));
System.out.println(Arrays.toString(bundle.getStringArray("color")));
除此之外,资源包类也可以继承 ResourceBundle
类进行扩展,但是需要实现两个方法,一是枚举所有键,二是用给定的键查找相应的值:
Enumeration<String> getKeys();
Object handleGetObject(String key);
ResourceBundle
类的 getObject
方法会调用你提供的 handleGetObject
方法。
NumberFormat
java.text
包中的 NumberFormat
可以根据不同的 Locale
对数值进行格式化和解析。
使用 getNumberInstance
静态方法获取对数字进行格式化和解析的实例,然后将对应的数字进行格式化,看相应的 Locale
实例对应的格式化如何不同。
NumberFormat numberFormat = NumberFormat.getNumberInstance(Locale.SIMPLIFIED_CHINESE);
String result = numberFormat.format(2021.0731);
System.out.println(result);
结果是 2,021.073
,更换成美国、德国等的结果分别是 2,021.073
和 2.021,073
。当数字值为货币的时候,使用 getCurrencyInstance
静态方法,如下所示。
NumberFormat currencyFormat = NumberFormat.getCurrencyInstance(Locale.SIMPLIFIED_CHINESE);
String result = currencyFormat.format(2021.0731);
System.out.println(result);
结果是 ¥2,021.07
,更换成美国、德国等的结果分别是 $2,021.07
和 2.021,07 €
。
处理货币时,可以使用 Currency
类来控制货币,可以通过 Currency.getInstance
静态方法传入一个货币标识并返回 Currency
对象,然后调用 NumberFormat
中的 setCurrency
方法。下面的例子是给德国用户设置人民币的格式,如下所示。
NumberFormat currencyFormat = NumberFormat.getCurrencyInstance(Locale.SIMPLIFIED_CHINESE);
currencyFormat.setCurrency(Currency.getInstance("CNY"));
String result = currencyFormat.format(2021.0731);
System.out.println(result); // 2.021,07 CN¥
货币标识符由 ISO-4217
定义,下面就简单的介绍几种货币标识符。
货币值 | 标识符 | 货币值 | 标识符 |
---|---|---|---|
U.S.Dollar | USD | Chinese Renminbi(Yuan) | CNY |
Euro | EUR | Indian Rupee | INR |
British Pound | GBP | Russian Ruble | RUB |
Japanese Yen | JPY |
DateTimeFormatter
每个国家和地区对日期和时间的显示都不可能相同,Java SE 8 提供了 java.time.DateTimeFormatter
类来处理与 Locale
相关的日期和时间,格式化和解析出符合本地日期和时间的表示方法。如下所示,使用 DateTimeFormatter
中的 withLocale
设置不同的 Locale
。
DateTimeFormatter dateFormatter = DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL).withLocale(Locale.SIMPLIFIED_CHINESE);
之后,就可以格式化 LocaleDate
、LocaleDateTime
、LocaleTime
和 ZonedDateTime
了。
ZonedDateTime appointment = ZonedDateTime.now();
String formatted = formatter.format(appointment);
输出的结果是 2021年7月31日星期六
,更换成美国、德国的结果分别是 Saturday, July 31, 2021
和 Samstag, 31. Juli 2021
。输出一个地区的第一天时,可以通过 Locale
设置,如下所示。
DayOfWeek first = WeekFields.of(locale).getFirstDayOfWeek();
MessageFormat
一段消息中也会根据不同的 Locale
进行变更的可变数据,Java 提供了 java.text.MessageFormat
来对消息进行格式化。如下一段话:
String msg = "On {2}, {0} destroyed {1} houses and caused {3} of damage."
括号中的数字是占位符,可以通过 MessageFormat.format
静态方法使用实际的值来替换占位符。它是一个 varargs
方法,所以可以通过下面的方法提供参数:
String result = MessageFormat.format(msg, "a hurricane", 99, new GregorianCalendar(1999, 0, 1).getTime(), 10.0E8);
输出结果是:
On 1/1/99 12:00 AM, a hurricane destroyed 99 houses and caused 100,000,000 of damage.
上面的例子还可以为占位符提供可选的格式,将打印的内容变得更为精细。
On {2, date, long}, {0} destroyed {1} houses and caused {3, number, currency} of damage.
输出结果是:
On January 1, 1999, a hurricane destroyed 99 houses and caused $100,000,000 of damage.
一般来说,占位符索引后面可以跟一个 type
和一个 style
,它们之间用逗号隔开。
MessageFormat.format
静态方法使用当前的 Locale
对值进行格式化。要想用任意的 Locale
进行格式化,需要为这个类提供可以使用的 varargs
方法。你需要把将要格式化的值置于 Object[]
数组中,如下所示。
MessageFormat mf = new MessageFormat(pattern, locale);
String msg = mf.format(new Object[] {values});
欢迎关注公众号「海人为记」,期待与你共同进步!