讲讲Java的国际化

Java 国际化.png

每个面向国际的语言都需要有自己的国际化解决方案,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 个小写字母表示,例如 zhende。这里可以查看 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 个数字表示,例如 CNUSDE。这里可以查看 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());
// 中文(中国)
// 中文(台湾)

LocalesetDefault 方法可以将更改默认地区,并使用 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,则与中文、英文环境相对应的资源如下图所示。

14-1 资源文件存放区域.png

这里可以把默认资源放在一个没有后缀 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 资源文件的具体子类,但不需要直接使用 PropertyResourceBundleResourceBundle.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.0732.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.072.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);

之后,就可以格式化 LocaleDateLocaleDateTimeLocaleTimeZonedDateTime 了。

ZonedDateTime appointment = ZonedDateTime.now();
String formatted = formatter.format(appointment);

输出的结果是 2021年7月31日星期六,更换成美国、德国的结果分别是 Saturday, July 31, 2021Samstag, 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});

欢迎关注公众号「海人为记」,期待与你共同进步!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容