Spring-国际化信息01-基础知识

简介: Spring-国际化信息01-基础知识

概述


假设我们开发一个支持多国语言的Web应用系统,要求能够根据客户端系统的语言类型返回对应的界面。


这是典型的i18n国际化问题。 简单的来讲就是为每种语言提供一套相应的资源文件,并以规范化命名的方式保存在特定的目录中,由系统自动根据客户端语言选择合适的资源文件。


基础知识


概述


国际化信息也称为本地化信息。

一般需要两个条件才可以确定一个特定类型的本地化信息

  1. 语言类型
  2. 国家/地区类型


比如中文本地化信息既有中国大陆地区的中文,又有中国台湾、中国香港地区的中文,还有新加坡地区的中文。


Java通过java.util.Locale类表示一个本地化对象,它允许通过语言参数和国家/地区参数创建一个确定的本地化对象。


语言参数使用ISO标准语言代码标识,由ISO-639标准定义,每种语言由两位小写字母表示。标准语言代码信息可参考: http://www.loc.gov/standards/iso639-2/php/English_list.php


国家/地区参数也由标准的ISO国家/地区代码标识,由ISO-3166标准定义,每个国家/地区由两个大写字母标识。详情请参考:https://www.iso.org/obp/ui/#search/code/


比如:


20170811014306860.jpg


20170811021303327.jpg


代码已托管到Github—> https://github.com/yangshangwei/SpringMaster


20170811014649378.jpg


java.util.Locale


java.util.Locale是表示语言和国家/地区信息的本地化类,它是创建国际化应用的基础。

请看下面的几个创建本地化对象的实例:

package com.xgj.ioc.i18n.locale;
import java.util.Locale;
public class LocaleTest {
    public static void main(String[] args) {
        // (1)带有语言和国家/地区信息的本地化对象
        Locale locale1 = new Locale("zh", "CN");
        System.out.println("Locale(\"zh\", \"CN\"):" + locale1);
        // (2)只带有语言信息的本地化对象
        Locale locale2 = new Locale("zh");
        System.out.println("Locale(\"zh\"):" + locale2);
        // (3)等同于Locale("zh", "CN")
        Locale locale3 = Locale.CHINA;
        System.out.println("Locale.CHINA:" + locale3);
        // (4)等同于Locale("zh")
        Locale locale4 = Locale.CHINESE;
        System.out.println("Locale.CHINESE:" + locale4);
        // (5)获取本地系统默认的本地化对象
        Locale locale5 = Locale.getDefault();
        System.out.println("Locale.getDefault():" + locale5);
    }
}


运行结果:

Locale("zh", "CN"):zh_CN
Locale("zh"):zh
Locale.CHINA:zh_CN
Locale.CHINESE:zh
Locale.getDefault():zh_CN


用户既可以同时制定语言和国家/地区参数来定义一个本地化对象,如(1)

也可以仅通过语言参数定义一个泛本地化对象,如(2)

Locale类中通过静态常量定义可一些常用的本地化对象,可以直接引用常量返回本地化对象,如(3)(4)。 具体可查看Locale源码

此外用户还可以获取系统默认的本地化对象,如(5)


如果用户希望改变系统默认的本地化设置,可以在启动JVM时通过命令参数指定


java -Duser.language=en -Duser.regin=US LocaleTest


在IDE中,可以如下设置

20170811015302416.jpg


运行一下:

Locale("zh", "CN"):zh_CN
Locale("zh"):zh
Locale.CHINA:zh_CN
Locale.CHINESE:zh
Locale.getDefault():en_US


可以看到Locale.getDefault() 已经是 en_US了。


本地化工具类


JDK的java.util包中提供了几个支持本地化的格式化操作工具类,比如NumberFormat、DateFormat、MessageFormat。

下面我们来看下具体的用法


NumberFormat / DateFormat

package com.xgj.ioc.i18n.tools;
import java.text.DateFormat;
import java.text.NumberFormat;
import java.util.Date;
import java.util.Locale;
public class FormatToolTest {
    public static void main(String[] args) {
        // 中文本地化信息
        Locale locale = Locale.CHINA;
        NumberFormat numberFormat = NumberFormat.getCurrencyInstance(locale);
        double amt = 123456.78;
        System.out.println(numberFormat.format(amt));
        // 英文本地化信息
        Locale locale2 = Locale.US;
        NumberFormat nFormat = NumberFormat.getCurrencyInstance(locale2);
        double amt2 = 123456.78;
        System.out.println(nFormat.format(amt2));
        // 英文本地化信息
        Locale locale3 = new Locale("en", "US");
        Date date = new Date();
        // 按照本地化的方式对日期进行格式化操作
        DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.MEDIUM,
                locale3);
        System.out.println(dateFormat.format(date));
        // 中文本地化信息
        Locale locale4 = new Locale("zh", "CN");
        Date date2 = new Date();
        // 按照本地化的方式对日期进行格式化操作
        DateFormat dateFormat2 = DateFormat.getDateInstance(DateFormat.MEDIUM,
                locale4);
        System.out.println(dateFormat2.format(date2));
    }
}


运行结果:

¥123,456.78
$123,456.78
Aug 10, 2017
2017-8-10


MessageFormat


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

package com.xgj.ioc.i18n.tools;
import java.text.MessageFormat;
import java.util.GregorianCalendar;
import java.util.Locale;
public class MessageFormatToolTest {
    public static void main(String[] args) {
        // (1)格式化信息串
        String pattern1 = "{0},你好!你与{1}支付了货款{2}元";
        String pattern2 = "At {1,time,short} on {1,date,long},{0} paid {2,number,currency}";
        // (2)用于动态替换占位符的参数
        Object[] params = { "XiaoGongJiang", new GregorianCalendar().getTime(),200 };
        // (3)使用默认的本地化对象格式化信息
        String msg1 = MessageFormat.format(pattern1, params);
        // (4)使用指定的本地化对象格式化信息
        MessageFormat messageFormat = new MessageFormat(pattern2, Locale.US);
        String msg2 = messageFormat.format(params);
        System.out.println(msg1);
        System.out.println(msg2);
    }
}


运行结果

XiaoGongJiang,你好!你与17-8-10 下午2:04支付了货款200元
At 2:04 PM on August 10, 2017,XiaoGongJiang paid $200.00


分析:


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


pattern2格式化信息串比较复杂一些,除参数位置索引外,还指定了参数的类型和样式。从pattern2中可以看出格式化信息串的语法是很灵活的,一个参数甚至可以出现在两个地方:如{1,time,short}表示从第二个入参中获取时间部分的值,显示为短样式时间;而{1,date,long}表示从第二个入参中获取日期部分的值,显示为长样式时间


在(2)处,定义了用于替换格式化占位符的动态参数,这里,我们使用到了JDK5.0自动装包的语法,否则必须采用封装类表示基本类型的参数值。


在(3)处,通过MessageFormat的format()方法格式化信息串。它使用了系统默认的本地化对象,由于我们是中文平台,因此默认为Locale.CHINA


在(4)处,我们显式指定MessageFormat的本地化对象。


ResourceBoundle


如果应用系统中某些信息需要支持国际化功能,则必须为希望支持的不同本地化类型分别提供对应的资源文件,并以规范的方式进行命名。


国际化资源文件的命名规范规定资源名称采用以下的方式进行命名:


<资源名>_<语言代码>_<国家/地区代码>.properties


其中,语言代码和国家/地区代码都是可选的.


<资源名>.properties命名的国际化资源文件是默认的资源文件,即某个本地化类型在系统中找不到对应的资源文件,就采用这个默认的资源文件.


<资源名>_<语言代码>.properties命名的国际化资源文件是某一语言默认的资源文件,即某个本地化类型在系统中找不到精确匹配的资源文件,将采用相应语言默认的资源文件。


实例


20170811031403824.jpg

我们命名资源名称为“resource”。 提供两个国际化信息配置文件

  • 语言为英文,国家为美国,与其对应的本地化资源文件命名为resource_en_US.properties。 内容为:
greeting.common=How are you?
greeting.morning=Good Morning!
greeting.afternoon=Good Afternoon!


  • 语言为中文,国家/地区为中国大陆,与其对应的本地化资源文件为resource_zh_ CN.properties 。 内容为:
greeting.common=\u4F60\u597D\u5417\uFF1F
greeting.morning=\u4E0A\u5348\u597D\uFF01
greeting.afternoon=\u4E0B\u5348\u597D\uFF01


本地化不同的同一资源文件,虽然属性值各不相同,但属性名却是相同的,这样应用程序就可以通过Locale对象和属性名精确调用到某个具体的属性值了。


注意:上面中文的本地化资源文件内容采用了特殊的编码表示中文字符,这是因为资源文件对文件内容有严格的要求:只能包含ASCII字符。所以必须将非ASCII字符的内容转换为Unicode代码的表示方式。


如上面中文的resource_zh_CN.properties资源文件的三个属性值分别是“你好吗?”、“上午好!”和“下午好!”三个中文字符串对应的Unicode代码串。


中文本地化资源文件两种转换方式


如果在应用开发时,直接采用Unicode代码编辑资源文件是很不方便的,所以,通常我们直接使用正常的方式编写资源文件,在测试或部署时再采用工具进行转换。


JDK的native2ascii工具


JDK在bin目录下为我们提供了一个完成此项功能的native2ascii工具,它可以将中文字符的资源文件转换为Unicode代码格式的文件


命令格式如下

native2ascii [-reverse] [-encoding 编码] [输入文件 [输出文件]]


CMD,进入 native2ascii所在的目录,执行:

native2ascii -encoding utf-8 D:\workspace\workspace-sts\SpringMaster\src\main\resources\i18n\resource_zh_CN.properties 
IDE自带的支持

对于IDE来讲,无须安装任何插件就自然支持资源属性文件的这种编辑方式,比如我用的Spring Tool Suits,输入中文,自动转换为Unicode。


如果应用程序中拥有大量的本地化资源文件,直接通过传统的File操作资源文件显然太过笨拙。Java为我们提供了用于加载本地化资源文件的方便类java.util.ResourceBoundle。

来看下实例:

结合上面的项目结构,加载i18n目录下的名为resource资源文件。

package com.xgj.ioc.i18n.resourceBoundle;
import java.util.Locale;
import java.util.ResourceBundle;
public class ResourceBoundleTest {
    public static void main(String[] args) {
        ResourceBundle resBundle = ResourceBundle.getBundle("i18n/resource",
                Locale.getDefault());
        System.out.println(resBundle.getString("greeting.common"));
        System.out.println(resBundle.getString("greeting.morning"));
        System.out.println(resBundle.getString("greeting.afternoon"));
        ResourceBundle resBundle2 = ResourceBundle.getBundle("i18n/resource",
                Locale.US);
        System.out.println(resBundle2.getString("greeting.common"));
        System.out.println(resBundle2.getString("greeting.morning"));
        System.out.println(resBundle2.getString("greeting.afternoon"));
    }
}

resBundle加载了默认的本地化资源文件,因为是中文平台,所以是对应中国大陆中文的resource_zh_CN.properties资源文件。

resBundle2 加载了对应美国英语本地化的resource_en_US.properties资源文件。

运行结果:

你好吗?
上午好!
下午好!
How are you?
Good Morning!
Good Afternoon!

ResourceBundle加载资源的顺序


ResourceBundle在加载资源时,如果指定的本地化资源文件不存在,它按以下顺序尝试加载其他的资源:本地系统默认本地化对象对应的资源→默认的资源。


举例:

假设我们使用ResourceBundle.getBundle(“i18n/resource”,Locale.CANADA)加载加拿大的本地资源文件,由于不存在resource_en_CA.properties资源文件,它将尝试加载resource_zh_CN.properties的资源文件(中文平台,默认是中文本地化资源文件),假设resource_zh_CN.properties资源文件也不存在,它将继续尝试加载resource.properties的资源文件,如果这些资源都不存在,将抛出java.util.MissingResourceException异常。


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


在上面的资源文件中,属性值都是一般的字符串,它们不能结合运行时的动态参数构造出灵活的信息,而这种需求是很常见的。要解决这个问题,只须使用带占位符的格式化串作为资源文件的属性值并结合使用MessageFormat就可以满足要求了。


下面我们来改造下资源文件,通过格式化串让问候语更具个性化:


fmt_resource_en_US.properties:

greeting.common=How are you {0}?,today is {1}
greeting.morning=Good Morning {0}! now is {1,time,short}
greeting.afternoon=Good Afternoon {0}! now is {1,date,long}

fmt_resource_zh_CN.properties:

greeting.common=\u4F60\u597D\u5417{0}\uFF1F\u3002\u4ECA\u5929\u662F{1}
greeting.morning=\u65E9\u4E0A\u597D{0}\uFF01\u73B0\u5728\u662F{1,time,short}
greeting.afternoon=\u4E0B\u5348\u597D{0}\uFF01\u73B0\u5728\u662F{1,date,long}


下面使用ResourceBoundle和MessageFormat来操作资源文件

package com.xgj.ioc.i18n.resourceBoundle;
import java.text.MessageFormat;
import java.util.GregorianCalendar;
import java.util.Locale;
import java.util.ResourceBundle;
public class ResourceBoundleWithFormatTest {
    public static void main(String[] args) {
        // 加载本地资源
        ResourceBundle reBundle1 = ResourceBundle.getBundle(
                "i18n/fmt_resource", Locale.CHINA);
        ResourceBundle reBundle2 = ResourceBundle.getBundle(
                "i18n/fmt_resource", Locale.US);
        Object[] params = { "XiaoGongJiang", new GregorianCalendar().getTime() };
        // 用本地化对象进行格式化
        String greetingCommonCH = new MessageFormat(
                reBundle1.getString("greeting.common"), Locale.CHINA)
                .format(params);
        String greetingMorningCH = new MessageFormat(
                reBundle1.getString("greeting.morning"), Locale.CHINA)
                .format(params);
        String greetingAfternoonCH = new MessageFormat(
                reBundle1.getString("greeting.afternoon"), Locale.CHINA)
                .format(params);
        System.out.println(greetingCommonCH);
        System.out.println(greetingMorningCH);
        System.out.println(greetingAfternoonCH);
        String greetingCommonEN = new MessageFormat(
                reBundle2.getString("greeting.common"), Locale.US)
                .format(params);
        String greetingMorningEN = new MessageFormat(
                reBundle2.getString("greeting.morning"), Locale.US)
                .format(params);
        String greetingAfternoonEN = new MessageFormat(
                reBundle2.getString("greeting.afternoon"), Locale.US)
                .format(params);
        System.out.println(greetingCommonEN);
        System.out.println(greetingMorningEN);
        System.out.println(greetingAfternoonEN);
    }
}


运行结果:

你好吗XiaoGongJiang?。今天是17-8-10 下午3:44
早上好XiaoGongJiang!现在是下午3:44
下午好XiaoGongJiang!现在是2017年8月10日
How are you XiaoGongJiang?,today is 8/10/17 3:44 PM
Good Morning XiaoGongJiang! now is 3:44 PM
Good Afternoon XiaoGongJiang! now is August 10, 2017


相关文章
|
Java 测试技术 微服务
微服务——SpringBoot使用归纳——Spring Boot中的项目属性配置——少量配置信息的情形
本课主要讲解Spring Boot项目中的属性配置方法。在实际开发中,测试与生产环境的配置往往不同,因此不应将配置信息硬编码在代码中,而应使用配置文件管理,如`application.yml`。例如,在微服务架构下,可通过配置文件设置调用其他服务的地址(如订单服务端口8002),并利用`@Value`注解在代码中读取这些配置值。这种方式使项目更灵活,便于后续修改和维护。
298 0
|
8月前
|
安全 算法 Java
在Spring Boot中应用Jasypt以加密配置信息。
通过以上步骤,可以在Spring Boot应用中有效地利用Jasypt对配置信息进行加密,这样即使配置文件被泄露,其中的敏感信息也不会直接暴露给攻击者。这是一种在不牺牲操作复杂度的情况下提升应用安全性的简便方法。
1363 10
|
9月前
|
人工智能 安全 Java
Spring Boot yml 配置敏感信息加密
本文介绍了如何在 Spring Boot 项目中使用 Jasypt 实现配置文件加密,包含添加依赖、配置密钥、生成加密值、在配置中使用加密值及验证步骤,并提供了注意事项,确保敏感信息的安全管理。
1481 1
|
开发框架 前端开发 网络协议
Spring Boot结合Netty和WebSocket,实现后台向前端实时推送信息
【10月更文挑战第18天】 在现代互联网应用中,实时通信变得越来越重要。WebSocket作为一种在单个TCP连接上进行全双工通信的协议,为客户端和服务器之间的实时数据传输提供了一种高效的解决方案。Netty作为一个高性能、事件驱动的NIO框架,它基于Java NIO实现了异步和事件驱动的网络应用程序。Spring Boot是一个基于Spring框架的微服务开发框架,它提供了许多开箱即用的功能和简化配置的机制。本文将详细介绍如何使用Spring Boot集成Netty和WebSocket,实现后台向前端推送信息的功能。
3709 1
|
Java 微服务 Spring
微服务——SpringBoot使用归纳——Spring Boot中的项目属性配置——少量配置信息的情形
在微服务架构中,随着业务复杂度增加,项目可能需要调用多个微服务。为避免使用`@Value`注解逐一引入配置的繁琐,可通过定义配置类(如`MicroServiceUrl`)并结合`@ConfigurationProperties`注解实现批量管理。此方法需在配置文件中设置微服务地址(如订单、用户、购物车服务),并通过`@Component`将配置类纳入Spring容器。最后,在Controller中通过`@Resource`注入配置类即可便捷使用,提升代码可维护性。
259 0
|
监控 JavaScript 数据可视化
建筑施工一体化信息管理平台源码,支持微服务架构,采用Java、Spring Cloud、Vue等技术开发。
智慧工地云平台是专为建筑施工领域打造的一体化信息管理平台,利用大数据、云计算、物联网等技术,实现施工区域各系统数据汇总与可视化管理。平台涵盖人员、设备、物料、环境等关键因素的实时监控与数据分析,提供远程指挥、决策支持等功能,提升工作效率,促进产业信息化发展。系统由PC端、APP移动端及项目、监管、数据屏三大平台组成,支持微服务架构,采用Java、Spring Cloud、Vue等技术开发。
579 7
|
JavaScript Java 数据安全/隐私保护
基于SpringBoot+Vue毕业生信息招聘平台系统【源码+论文+演示视频+包运行成功】_基于spring vue的校园招聘系统源码(2)
基于SpringBoot+Vue毕业生信息招聘平台系统【源码+论文+演示视频+包运行成功】_基于spring vue的校园招聘系统源码
488 0
基于SpringBoot+Vue毕业生信息招聘平台系统【源码+论文+演示视频+包运行成功】_基于spring vue的校园招聘系统源码(2)
|
Java Spring 自然语言处理
Spring 框架里竟藏着神秘魔法?国际化与本地化的奇妙之旅等你来揭开谜底!
【8月更文挑战第31天】在软件开发中,国际化(I18N)与本地化(L10N)对于满足不同地区用户需求至关重要。Spring框架提供了强大支持,利用资源文件和`MessageSource`实现多语言文本管理。通过配置日期格式和货币符号,进一步完善本地化功能。合理应用这些特性,可显著提升应用的多地区适应性和用户体验。
279 0
|
存储 Java UED
Spring Boot中的国际化处理
Spring Boot中的国际化处理
1179 0
|
JavaScript Java 关系型数据库
基于SpringBoot+Vue毕业生信息招聘平台系统【源码+论文+演示视频+包运行成功】_基于spring vue的校园招聘系统源码(1)
基于SpringBoot+Vue毕业生信息招聘平台系统【源码+论文+演示视频+包运行成功】_基于spring vue的校园招聘系统源码
659 0