JAVA中ResourceBundle （读取国际化资源文件）使用详解

刺骨的言语ヽ痛彻心扉 2023-06-15 11:02 33阅读 0赞

这个类主要用来解决国际化和本地化问题。国际化和本地化可不是两个概念，两者都是一起出现的。可以说，国际化的目的就是为了实现本地化。比如对于“取消”，中文中我们使用“取消”来表示，而英文中我们使用“cancel”。若我们的程序是面向国际的（这也是软件发展的一个趋势），那么使用的人群必然是多语言环境的，实现国际化就非常有必要。而ResourceBundle可以帮助我们轻松完成这个任务：当程序需要一个特定于语言环境的资源时（如 String），程序可以从适合当前用户语言环境的资源包（大多数情况下也就是.properties文件）中加载它。这样可以编写很大程度上独立于用户语言环境的程序代码，它将资源包中大部分（即便不是全部）特定于语言环境的信息隔离开来。

这使编写的程序可以：

轻松地本地化或翻译成不同的语言  
一次处理多个语言环境  
以后可以轻松进行修改，以便支持更多的语言环境  
说的简单点，这个类的作用就是读取资源属性文件（properties），然后根据.properties文件的名称信息（本地化信息），匹配当前系统的国别语言信息（也可以程序指定），然后获取相应的properties文件的内容。

使用这个类，properties需要遵循一定的命名规范，一般的命名规范是： 自定义名语言代码国别代码.properties，如果是默认的，直接写为：自定义名.properties。

比如：

myres\_en\_US.properties   
myres\_zh\_CN.properties

myres.properties

当在中文操作系统下，如果myres\_zh\_CN.properties、myres.properties两个文件都存在，则优先会使用myres\_zh\_CN.properties，当myres\_zh\_CN.properties不存在时候，会使用默认的myres.properties。

没有提供语言和地区的资源文件是系统默认的资源文件。

资源文件都必须是ISO-8859-1编码，因此，对于所有非西方语系的处理，都必须先将之转换为Java Unicode Escape格式。转换方法是通过JDK自带的工具native2ascii.

ResourceBundle的类层次结构

PropertyResourceBundle将本地化的文本存储于Java property文件中。

从ResourceBundle中获取值

获取ResourceBundle实例后可以通过下面的方法获得本地化值。  
getObject(String key);  
getString(String key);  
getStringArray(String key);  
还可以通过keySet()方法获取所有的key。Set keys = bundle.keySet();  
其它ResourceBundle 方法可以通过查看文档获得。  
测试及验证

新建4个属性文件  
my\_en\_US.properties：cancelKey=cancel

my\_zh\_CN.properties：cancelKey=\\u53D6\\u6D88（取消）

my\_zh.properties：cancelKey=\\u53D6\\u6D88zh（取消zh）

my.properties：cancelKey=\\u53D6\\u6D88default（取消default）

获取bundle  
ResourceBundle bundle = ResourceBundle.getBundle("res", new Locale("zh", "CN"));  
1  
其中new Locale(“zh”, “CN”)提供本地化信息，上面这行代码，程序会首先在classpath下寻找my\_zh\_CN.properties文件，若my\_zh\_CN.properties文件不存在，则取找my\_zh.properties，如还是不存在，继续寻找my.properties,若都找不到就抛出异常。

代码

> import javax.annotation.Resource;  
> import java.util.Locale;  
> import java.util.ResourceBundle;
> 
>   
> public class Main \{
> 
>     public static void main(String args\[\]) \{  
>         ResourceBundle bundle = ResourceBundle.getBundle("my", new Locale("zh", "CN"));  
>         String cancel = bundle.getString("cancelKey");  
>         System.out.println(cancel);
> 
>         bundle = ResourceBundle.getBundle("my", Locale.US);  
>         cancel = bundle.getString("cancelKey");  
>         System.out.println(cancel);
> 
>         bundle = ResourceBundle.getBundle("my", Locale.getDefault());  
>         cancel = bundle.getString("cancelKey");  
>         System.out.println(cancel);
> 
>         bundle = ResourceBundle.getBundle("my", Locale.GERMAN);  
>         cancel = bundle.getString("cancelKey");  
>         System.out.println(cancel);  
>         bundle = ResourceBundle.getBundle("my");  
>         for (String key : bundle.keySet()) \{  
>             System.out.println(bundle.getString(key));  
>         \}  
>     \}  
> \}  
>   
>   
> 输出结果

取消   
cancel   
取消   
取消   
取消

说明：前面三个分别按照zh\_CN,US,默认的结果输出，第四个由于我们未定义GERMAN属性文件，这时ResourceBundle为我们提供了一个fallback（也就是一个备用方案），这个备用方案就是根据当前系统的语言环境来得到的本地化信息。所以若是找不到GERMAN的，之后就会去找CHINA了，所以找到了res\_zh\_CH.properties这个资源包。最后一个是若有多个属性文件，可以按照Map的形式遍历，获得属性文件内的各个值。

public class PropertiesFileUtil \{

private ResourceBundle rb = null;

public PropertiesFileUtil(String bundleFile) \{  
        rb = ResourceBundle.getBundle(bundleFile);  
    \}

public String getValue(String key) \{  
        return rb.getString(key);  
    \}

public static void main(String\[\] args) \{

//加了 \\\\之后,会自动从根资源文件中取config.properties,config\_zh\_CN.properties等资源文件,不加\\\\,要和java文件放在一起  
        PropertiesFileUtil p = new PropertiesFileUtil("\\\\config");  
        System.out.println(p.getValue("remitRate"));  
    \}  
\}