国际化(i18n)

转载

JEECG低代码 2022-04-13 17:32:19

文章标签 国际化 jeecg java快速开发平台 bundle 字符串 文章分类 代码人生

国际化开发概述

软件的国际化：软件开发时，要使它能同时应对世界不同地区和国家的访问，并针对不同地区和国家的访问，提供相应的、符合来访者阅读习惯的页面或数据。

国际化(internationalization)又称为i18n(读法为i18n，据说是因为internationalization(国际化)这个单词从i到n之间有18个英文字母，i18n的名字由此而来)

合格的国际化软件

软件实现国际化，需具备以下两个特征：

对于程序中固定使用的文本元素，例如菜单栏、导航条等使用的文本元素、或错误提示信息，状态信息等，需要根据来访者的地区和国家，选择不同语言的文本为之服务。
对于程序动态产生的数据，例如(日期，货币等)，软件应能根据当前所在的国家或地区的文化习惯进行显示。

固定文本元素的国际化

对于软件中的菜单栏、导航条、错误提示信息，状态信息等这些固定不变的文本信息，可以把它们写在一个properties文件中，并根据不同的国家编写不同的properties文件。这一组properties文件称之为一个资源包。

创建资源包和资源文件

一个资源包中的每个资源文件都必须拥有共同的基名。除了基名，每个资源文件的名称中还必须有标识其本地信息的附加部分。例如：一个资源包的基名是“MessageResource”，则与中文、英文环境相对应的资源文件名则为: “MessageResource_zh.properties” “MessageResource_en.properties”

国际化(i18n)_bundle

每个资源包都应有一个默认资源文件，这个文件不带有标识本地信息的附加部分。若ResourceBundle对象在资源包中找不到与用户匹配的资源文件，它将选择该资源包中与用户最相近的资源文件，如果再找不到，则使用默认资源文件。例如：MessageResource.properties。

资源文件的书写格式

资源文件的内容通常采用”关键字＝值”的形式，软件根据关键字检索值显示在页面上。一个资源包中的所有资源文件的关键字必须相同，值则为相应国家的文字。并且资源文件中采用的是properties格式文件，所以文件中的所有字符都必须是ASCII字码，属性(properties)文件是不能保存中文的，对于像中文这样的非ACSII字符，须先进行编码。

例如：

国际化的中文环境的properties文件：

国际化(i18n)_字符串_02

国际化的英文环境的properties文件：

国际化(i18n)_字符串_03

java提供了一个native2ascII工具用于将中文字符进行编码处理，native2ascII的用法如下所示：

国际化(i18n)_java快速开发平台_04

编程实现固定文本的国际化

在JavaAPI中提供了一个ResourceBundle类用于描述一个资源包，并且 ResourceBundle类提供了相应的方法getBundle，这个方法可以根据来访者的国家地区自动获取与之对应的资源文件予以显示。

ResourceBundle类提供了一个静态方法getBundle，该方法用于装载资源文件，并创建ResourceBundle实例：

Locale currentLocale = Locale.getDefault();
ResourceBundle myResources =ResourceBundle.getBundle(basename, currentLocale);

basename为资源包基名(且必须为完整路径)。
如果与该locale对象匹配的资源包子类找不到。一般情况下，则选用默认资源文件予以显示。

加载资源文件后，程序就可以调用ResourceBundle实例对象的getString方法获取指定的资源信息名称所对应的值。

String value =  myResources.getString(“key");

范例：根据国家地区自动获取与之对应的资源文件。

public class Demo1 {

    public static void main(String[] args) {

        // 根据资源包基名和语言环境加载对应的语言资源文件
        ResourceBundle bundler = ResourceBundle.getBundle("cn.itcast.resource.MessageResource",Locale.CANADA);

        String username = bundler.getString("username");
        String password = bundler.getString("password");

        System.out.println(username);
        System.out.println(password);
    }

}

运行结果：

国际化(i18n)_字符串_05

在WEB应用中实现固定文本的国际化

如下所示：

<%@page import="java.util.Locale"%>
<%@page import="java.util.ResourceBundle"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>国际化的页面</title>
</head>
<body>
    <a href="/day12/login.jsp?language=zh">中文（网页）</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    <a href="/day12/login.jsp?language=en">English（pages）</a>

    <%
        String language = request.getParameter("language");
        if(language == null || language.equals("")) {
            language = "zh";
        }   
        Locale locale = new Locale(language); // Locale代表当前语言地区和国家

        ResourceBundle bundle = ResourceBundle.getBundle("cn.itcast.resource.MessageResource",locale);
    %>
    <form action="">
        <%=bundle.getString("username") %><input type="text" name="username"><br/>
        <%=bundle.getString("password") %><input type="password" name="password"><br/>
        <input type="submit" value="<%=bundle.getString("submit") %>">
    </form>
</body>
</html>

运行结果：

国际化(i18n)_jeecg_06

同样一个页面，在不同语言环境的浏览器下显示出了不同的语言文字效果，这样就实现了固定文本的国际化。

动态数据的国际化

数值，货币，时间，日期等数据由于可能在程序运行时动态产生，所以无法像文字一样简单地将它们从应用程序中分离出来，而是需要特殊处理。Java中提供了解决这些问题的API类(位于java.util包和java.text包中)

Locale类

Locale实例对象代表一个特定的地理、政治、文化区域。

一个 Locale对象本身不会验证它代表的语言和国家地区信息是否正确，只是向本地敏感的类提供国家地区信息，与国际化相关的格式化和解析任务由本地敏感的类去完成。(若JDK中的某个类在运行时需要根据Locale对象来调整其功能，这个类就称为本地敏感类)

DateFormat类(日期格式化)

DateFormat类可以将一个日期/时间对象格式化为表示某个国家地区的日期/时间字符串。

DateFormat类除了可按国家地区格式化输出日期外，它还定义了一些用于描述日期/时间的显示模式的int型的常量，包括FULL, LONG, MEDIUM, DEFAULT, SHORT，实例化DateFormat对象时，可以使用这些常量，控制日期/时间的显示长度。

例如，对于日期/时间“2005年9月15日下午4时41分20秒”，如设置了DateFormat的显示模式，则日期/时间显示样式分别为：

SHORT模式完全是数字的，在中文环境下显示为“05-9-15 下午4:41”；在英文环境下为“9/15/05 4:41 PM”。
MEDIUM模式比SHORT模式长些，在中文环境显示为“2005-9-15 16:41:20”；在英文环境下显示为“Sep 15, 2005 4:41:20 PM”。
LONG模式比MEDIUM模式更长一些，在中文环境下显示为“2005年9月15日下午04时41分20秒”；在英文环境下显示为“September 15, 2005 4:41:20 PM CST”。
FULL模式指定日期/时间的完整格式，在中文环境下显示为“2005年9月15日星期四下午04时41分20秒 CST”；在英文环境下，这个日期/时间显示为“Thursday, September 15, 2005 4:41:20 PM CST”。

实例化DateFormat类

实例化DateFormat类有九种方式，以下三种为带参形式，下面列出的三种方式也可以分别不带参，或只带显示样式的参数。

getDateInstance(int style, Locale aLocale)
：以指定的日期显示模式和本地信息来获得DateFormat实例对象，该实例对象不处理时间值部分。
getTimeInstance(int style, Locale aLocale)
：以指定的时间显示模式和本地信息来获得DateFormat实例对象，该实例对象不处理日期值部分。
getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)
：以单独指定的日期显示模式、时间显示模式和本地信息来获得DateFormat实例对象。

DateFormat对象的方法

format：将date对象格式化为符合某个本地环境习惯的字符串。
parse：将字符串解析为日期/时间对象。
注意：parse和format完全相反，一个是把date时间转化为相应地区和国家的显示样式，一个是把相应地区的时间日期转化成date对象，该方法在使用时，解析的时间或日期要符合指定的国家、地区格式，否则会抛异常。

DateFormat对象通常不是线程安全的，每个线程都应该创建自己的 DateFormat实例对象。

DateFormat使用范例

使用DateFormat格式化输出日期。

public class Demo2 {

    /*
     * 使用DateFormat格式化输出日期
     */
    public static void main(String[] args) {

        Date date = new Date();

        // DateFormat df = DateFormat.getDateInstance(DateFormat.SHORT, Locale.CHINA); // 16-8-8
        // DateFormat df = DateFormat.getDateInstance(DateFormat.MEDIUM, Locale.CHINA); // 2016-8-8
        // DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.CHINA); // 2016年8月8日
        // DateFormat df = DateFormat.getDateInstance(DateFormat.FULL, Locale.CHINA); // 2016年8月8日 星期一
        DateFormat df = DateFormat.getDateInstance(DateFormat.DEFAULT, Locale.CHINA); // 2016-8-8
        String str = df.format(date);
        System.out.println(str);

        df = DateFormat.getTimeInstance(DateFormat.LONG, Locale.CHINA);
        System.out.println(df.format(date));

        df = DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.SHORT, Locale.CHINA);
        System.out.println(df.format(date));

        // 得到默认的DateFormat
        df = DateFormat.getInstance();
        System.out.println(df.format(date));
    }

}

使用DateFormat反向把一个字符串格式化成一个日期对象。

public class Demo3 {

    /*
     * 使用DateFormat反向把一个字符串格式化成一个日期对象
     */
    public static void main(String[] args) throws ParseException {

        String str = "2016年8月8日 星期一 下午5:57";

        DateFormat df = DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.SHORT, Locale.CHINA);
        Date date = df.parse(str);
        System.out.println(date);
    }

}

运行结果为：Mon Aug 08 17:57:00 CST 2016

注意：把相应地区的时间日期转化成date对象时，解析的时间或日期要符合指定的国家、地区格式，否则会抛异常。如下面所示的代码就会抛异常：

public class Demo3 {

    /*
     * 使用DateFormat反向把一个字符串格式化成一个日期对象
     */
    public static void main(String[] args) throws ParseException {

        String str = "2016年8月8日 星期一 下午5:57";

        DateFormat df = DateFormat.getDateTimeInstance(DateFormat.SHORT, DateFormat.SHORT, Locale.CHINA);
        Date date = df.parse(str);
        System.out.println(date);
    }

}

会抛异常如下：

Exception in thread "main" java.text.ParseException: Unparseable date: "2016年8月8日 星期一 下午5:57"

NumberFormat类(数字格式化)

NumberFormat类可以将一个数值格式化为符合某个国家地区习惯的数值字符串，也可以将符合某个国家地区习惯的数值字符串解析为对应的数值。

NumberFormat类的方法：

format方法：将一个数值格式化为符合某个国家地区习惯的数值字符串。
parse方法：将符合某个国家地区习惯的数值字符串解析为对应的数值。

实例化NumberFormat类时，可以使用locale对象作为参数，也可以不使用，下面列出的是使用参数的。

getNumberInstance(Locale locale)
：以参数locale对象所标识的本地信息来获得具有多种用途的NumberFormat实例对象。
getIntegerInstance(Locale locale)
：以参数locale对象所标识的本地信息来获得处理整数的NumberFormat实例对象。
getCurrencyInstance(Locale locale)
：以参数locale对象所标识的本地信息来获得处理货币的NumberFormat实例对象。
getPercentInstance(Locale locale)
：以参数locale对象所标识的本地信息来获得处理百分比数值的NumberFormat实例对象。

范例：

public class Demo4 {

    public static void main(String[] args) throws ParseException {

        int price = 18; // $18 ￥18
        // NumberFormat nf = NumberFormat.getCurrencyInstance(Locale.CHINA); // ￥18.00
        // NumberFormat nf = NumberFormat.getCurrencyInstance(Locale.US); // $18.00
        // NumberFormat nf = NumberFormat.getCurrencyInstance(Locale.JAPAN); // ￥18
        NumberFormat nf = NumberFormat.getCurrencyInstance(Locale.FRANCE); // 18,00 €
        System.out.println(nf.format(price));

        String s = "18,00 €";
        nf = NumberFormat.getCurrencyInstance(Locale.FRANCE);
        System.out.println(nf.parse(s).doubleValue()); // 18.0

        double d = 0.1;
        nf = NumberFormat.getPercentInstance();
        System.out.println(nf.format(d)); // 10%

    }

}

MessageFormat(动态文本)

如果一个字符串中包含了多个与国际化相关的数据，可以使用MessageFormat类对这些数据进行批量处理。

例如：

At 12:30 pm on jul 3,1998, a hurricance destroyed 99 houses and caused $1000000 of damage.

以上字符串中包含了时间、数字、货币等多个与国际化相关的数据，对于这种字符串，可以使用MessageFormat类对其国际化相关的数据进行批量处理。

MessageFormat类如何进行批量处理呢？

MessageFormat类允许开发人员用占位符替换掉字符串中的敏感数据（即国际化相关的数据）。
MessageFormat类在格式化输出包含占位符的文本时，messageFormat类可以接收一个参数数组，以替换文本中的每一个占位符。

模式字符串与占位符

例如：

At 12:30 pm on jul 3,1998, a hurricance destroyed 99 houses and caused $1000000 of damage.

该语句对应的模式字符串即为：

At {0} on {1},a destroyed {2} houses and caused {3} of damage.

字符串中的{0}、{1}、{2}、{3}就是占位符。

格式化模式字符串

At 12:30 pm on jul 3,1998, a hurricance destroyed 99 houses and caused $1000000 of damage.

该语句对应的模式字符串还可编写为：

On {0}, a hurricance destroyed {１} houses and caused {２} of damage.

现在来格式化以上模式字符串。

实例化MessageFormat对象，并装载相应的模式字符串。
使用format(object obj[])格式化输出模式字符串，参数数组中指定占位符相应的替换对象。

范例：

public class Demo5 {

    public static void main(String[] args) {
        // 模式字符串
        String pattern = "On {0}, a hurricance destroyed {1} houses and caused {2} of damage.";
        // 实例化MessageFormat对象，并装载相应的模式字符串
        MessageFormat format = new MessageFormat(pattern, Locale.CHINA);
        Object[] params = {new Date(), 99, 1000000};
        // 格式化模式字符串，参数数组中指定占位符相应的替换对象
        String message = format.format(params);
        System.out.println(message);
    }

}

运行结果：On 16-8-18 上午9:01, a hurricance destroyed 99 houses and caused 1,000,000 of damage.

还可以将模式字符串编写在资源文件中，如下：

国际化(i18n)_java快速开发平台_07

代码如下：

public class Demo6 {
    public static void main(String[] args) {
        ResourceBundle bundle = ResourceBundle.getBundle("cn.itcast.resource.MessageResource", Locale.CHINA);
        String pattern = bundle.getString("message");

        MessageFormat format = new MessageFormat(pattern, Locale.CHINA);
        Object[] params = {new Date(), 99, 100000000};
        String message = format.format(params);
        System.out.println(message);
    }
}

运行结果为：在16-8-18 上午9:16，一场大风摧毁了99所房子，导致了100,000,000钱的损失！！！

占位符的三种书写方式

占位符有三种方式书写方式：

{argumentIndex}：0-9之间的数字，表示要格式化对象数据在参数数组中的索引号。
{argumentIndex,formatType}：参数的格式化类型。
{argumentIndex,formatType,FormatStyle}：格式化的样式，它的值必须是与格式化类型相匹配的合法模式、或表示合法模式的字符串。

范例：

public class Demo6 {
    public static void main(String[] args) {

        String pattern = "At {0, time, short} on {0, date}, a destroyed {1} houses and caused {2, number, currency} of damage.";
        MessageFormat format = new MessageFormat(pattern, Locale.US);
        Object[] params = {new Date(), 99, 100000000};
        String message = format.format(params);
        System.out.println(message);

    }
}

运行结果为：At 9:06 AM on Aug 18, 2016, a destroyed 99 houses and caused $100,000,000.00 of damage.

以上就是JavaWeb开发中国际化的总结内容。