Java国际化

使用java编写一个带GUI程序或者其他需要给用户传递文字信息的程序的时候,就很有可能需要用到国际化的知识,来总结一下。

所谓的国际化,就是使编写的程序可以适应不同的语言环境,比如,在中文环境下,可以与用户使用中文交互,在英文环境下则切换为英文。而这个切换过程不需要修改代码或者仅仅修改少量的代码。java给我们提供了这样的实现。

java文件国际化

我们通过将与界面显示有关系的资源提取出来到资源文件中,然后读取不同的资源文件来达到国际化的目的。在java中,这些是通过ResourceBundle这个类来实现的。

ResourceBundle分为两种,一种是ListResourceBundle,另一种是PropertyResourceBundle。下面介绍这两种ResourceBundle的使用方法:

首先列出demo工程的代码结构:

TestResourceBundle
|
|--src
    |
    |--kyu
        |
        |--bundle
        |    |
        |    |--ListResourceTranslator.java
        |    |
        |    |--PropertyResourceTranslator.java
        |    |
        |    |--ResourceTranslator.java
        |
        |--test
        |   |
        |   |--App.java
        |
        |--Errors_en_Us.java
        |
        |--Errors_zh_CN.java
        |
        |--Errors.java
        |
        |--Errors_en_Us.properties
        |
        |--Errors_zh_CN.properties
        |
        |--Errors.properties
        

PropertyResourceBundle

  1. 首先需要建立若干语言的properties文件: 自定义名语言代码国别代码.properties

比如:errors_en_US.properties, errors_zh_CN.properties

其中的语言代码和国别代码,分别是你要国际化的语言。需要几种语言,就添加几个properties文件。

国别代码

语言代码

通过打印java所支持的语言和国家查看:

private static void printLocal() {
        Locale[] localeList = Locale.getAvailableLocales();
        for (int i = 0; i < localeList.length; i++) {
            System.out.println(localeList[i].getDisplayCountry() + ": " + localeList[i].getCountry());
            System.out.println(localeList[i].getDisplayLanguage() + ": " + localeList[i].getLanguage());
        }
}
  1. 建立默认语言的properties文件:自定义名.properties

比如:errors.properties

当所需语言的properties文件不存在的时候就会默认读取这个文件中的内容

注意,资源文件都必须是ISO-8859-1编码,对于中文等非西方语系,可通过JDK自带的工具native2ascii进行处理,在Eclipse中也可以安装插件SimplePropertiesEditor来处理这类文件。

  1. 使用

ResourceTranslator.java

package kyu.bundle;

import java.util.Locale;
import java.util.ResourceBundle;

public abstract class ResourceTranslator {
    protected ResourceBundle bundle;
    protected Locale lc;
    protected static final String PROP_FILE = "kyu.errors";

    public String translate(String id) {
        return bundle.getString(id);
    }
}

PropertyResourceTranslator.java

package kyu.bundle;

import java.util.Locale;
import java.util.PropertyResourceBundle;
import java.util.ResourceBundle;

public class PropertyResourceTranslator extends ResourceTranslator{
    public PropertyResourceTranslator() {
        lc = Locale.getDefault();
        bundle = PropertyResourceBundle.getBundle(PROP_FILE, lc);
    }
    
    public PropertyResourceTranslator(String language, String country) {
        lc = new Locale(language, country);
        bundle = PropertyResourceBundle.getBundle(PROP_FILE, lc);
    }

}

App.java

package kyu.test;

import kyu.bundle.ListResourceTranslator;
import kyu.bundle.PropertyResourceTranslator;

public class App {
    public static void main(String[] args) {
        testPropertyResource();
    }

    private static void testPropertyResource() {
        PropertyResourceTranslator translatorDefault = new PropertyResourceTranslator();
        PropertyResourceTranslator translatorZH = new PropertyResourceTranslator("zh", "CN");
        PropertyResourceTranslator translatorEN = new PropertyResourceTranslator("en", "US");
        String def = translatorDefault.translate("ERROR-001");
        String zh = translatorZH.translate("ERROR-001");
        String en = translatorEN.translate("ERROR-001");
        
        System.out.println("test PropertyResourceBundle>>>>>>");
        System.out.println("default: " + def);
        System.out.println("zh: " + zh);
        System.out.println("en: " + en);
    }   
    
}

.properties文件内容:

Errors_en_Us.properties:
ERROR-001=error password

Errors.properties
ERROR-001=error password

Errors_zh_CN.properties
ERROR-001=密码错误

执行App.java的测试结果:

test PropertyResourceBundle>>>>>>
default: 密码错误
zh: 密码错误
en: error password

可以看到,通过指定Local构造函数的语言和国别代码,就能自动找到对应的.properties,并匹配其中的内容。

当使用Locale.getDefault()时,自动检测当前的系统环境,从而选择对应的语言。

还有一点要注意的是:

PropertyResourceBundle.getBundle(PROP_FILE, lc);

其中PROP_FILE,为properties文件的路径,此路径为properties文件的完整路径,即 所在完整包名.自定义名称

ListResourceBundle

ListResourceBundle的使用与PropertyResourceBundle的使用大同小异,不过是将properties文件换成了.java文件

ListResourceTranslator.java

package kyu.bundle;

import java.util.ListResourceBundle;
import java.util.Locale;

public class ListResourceTranslator extends ResourceTranslator{
    public ListResourceTranslator() {
        lc = Locale.getDefault();
        bundle = ListResourceBundle.getBundle(PROP_FILE, lc);
    }
    
    public ListResourceTranslator(String language, String country) {
        lc = new Locale(language, country);
        bundle = ListResourceBundle.getBundle(PROP_FILE, lc);
    }
}

ERRORS_en_US.java

package kyu;

import java.util.ListResourceBundle;

public class ERRORS_en_US extends ListResourceBundle{
    static final Object[][] contents = new String[][] { 
        { "ERROR-001", "error password" } 
    };

    public Object[][] getContents() {
        return contents;
    }
}

ERRORS_zh_CN.java

package kyu;

import java.util.ListResourceBundle;

public class ERRORS_zh_CN extends ListResourceBundle {
    static final Object[][] contents = new String[][] { 
        { "ERROR-001", "密码错误" } 
    };

    public Object[][] getContents() {
        return contents;
    }
}

继承了ListResourceBundle的类就相当于前面的properties文件,需要提供一个getContents()方法,返回对应的键值对。

同样的,要注意ListResourceBundle子类的命名规则,与properties文件相同,路径也与properties文件相同。

通过App.java的测试(将对应的bundle替换),可以得到相同的测试结果。

使用Eclipse对java文件进行国际化

在需要国际化的类文件上点击右键->Source->Externalize Strings...

出现窗口,Eclipse会自动检测类文件中的字符串,在窗口中可以选择相应的字符串,最后自动生成类似于上面的PropertyResourceTranslator.java和properties文件,完成国际化。

其原理与以上所讲的相同,故不再详细说明。

Eclipse RCP国际化

最近在使用Eclipse RCP这项技术开发程序,其中也有国际化相关的东西,总结下来。

Eclipse RCP and Plugin Internationalization - Tutorial

上面这篇文章详细的说明了Eclipse RCP工程中的国际化问题,可以作为一个备忘录。下面介绍一下eclipse rcp中比较常用到的国际化方式:

plugin.xml文件国际化

plugin.xml文件中保存了扩展点等相关的信息,当扩展点与界面UI相关时,就需要用到国际化

  1. 在工程的根目录下面建立一个plugin.properties资源文件,此文件类似于我们上面提到的errors.properties。当然,也可以建立plugin_zh.properties等文件,这些文件名中的plugin是可以自由定义的。

  2. 在 MANIFEST.MF文件中增加代码行:Bundle-Localization: plugin

    注意,这个plugin与上面的properties文件名保持一致。

  3. plugin.xml配置文件对资源文件进行引用时, 在引用的key前面加一个%,比如:

<view
    id="org.jkiss.dbeaver.core.databaseNavigator"
    category="org.jkiss.dbeaver.core.category"
    class="org.jkiss.dbeaver.ui.navigator.database.DatabaseNavigatorView"
    allowMultiple="false"
    icon="icons/databases.png"
    name="%view.database.navigator.title"/>
<view

类文件国际化

与前面所介绍的java类文件国际化相同,也可以通过选择类文件点击右键->Source->Externalize Strings...

Eclipse IDE会自动帮你完成国际化的一些工作,同样也生成了相关的类和properties文件,但不同的是,生成的类文件内容类似于:

package test;

import org.eclipse.osgi.util.NLS;

public class Messages extends NLS {
        private static final String BUNDLE_NAME
                = "test.messages"; //$NON-NLS-1$
        public static String View_0;
        public static String View_1;
        static {
                // initialize resource bundle
                NLS.initializeMessages(BUNDLE_NAME, Messages.class);
        }

        private Messages() {
        }
}

当然,我们也可以手动建立这些文件进行国际化操作~不再详细说明,可以通过观察IDE的行为进行我们手动的国际化操作

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

推荐阅读更多精彩内容

  • 背景知识 通讯的发达,使得世界各地交流越来越紧密。许多的软件产品也要面向世界上不同国家的用户。其中,语言障碍显然是...
    静默虚空阅读 4,468评论 0 0
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,099评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,355评论 6 343
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,293评论 18 399
  • 儿行千里母担忧!再遥远也不过相思漫漫,再漫长也不过柔柔绵情。似乎再坚硬也抵不过岁月的打磨。我不清楚身边的老人家年轻...
    檀芸果C阅读 117评论 0 2