國際化是使程序具有足夠的靈活性、能在世界上任何地區運行的過程。國際化所要求的必然結果是地方化――使一個程序能夠運行在特定地區的過程。本文嘗試用一個簡單的例子來演示Java用戶界面本地化。Java語言內核基於Unicode3.0(Java 1.4)提供了對不同國家和不同語言文字的內部支持,由於先天的原因,Java對於國際化的支持遠遠要比C/C++來的優越。
在我看來本地化必須滿足以下的三個條件:
1、程序必須能讀、寫和操作本地化的文本。
2、程序在顯示日期和時間、使數字格式化以及排序子串時,必須符合地方習慣。(通過java.text包裡面的類可以實現這些要求)
3、所有用戶可見的文本都能在運行時獲得,而不是直接寫入程序中。(通過java.util包裡的ResourceBundle類和他的子類可以實現這些要求。)
實現這三個方面可以真正實現程序的國際化。
首先讓我們來了解一下地區。地區代表一個地理上、政治上或文化上的區域。在Java中,地區由java.util.Locale類表示。地區常常以一種語言來定義,該語言則由其標准的小寫雙字母代碼表示。(例如:en代表英國,fr代表法國,zh代表中國),但有時候語言是不能代表一個地區的,那就要在語言後面再加上一個國家或該國家的地域(例如:en_US代表美國,zh_TW)。Locale類保存著一個靜態的默認地區,它可以用Locale.setDefault()和Locale.getDefault()來設置和查詢。一個程序可以生成和使用任意數目的非默認Locale對象。
讓我們再來看一下Unicode字符編碼。Java使用Unicode的字符編碼,其本身就是邁向國際化的一大步。Unicode編碼其每個字符都占兩個字節。用\u****的形式表示。Unicode的字符可以等價於其他編碼的字符(例如:從\u0020到\u007E的字符等價於ASCII和ISO8859-1字符的0x20到0x7E)。
本文主要是對用戶界面地方化,由於我使用的是資源束!所以有必要對資源束作一下解釋。
為定義一束地方化的資源,你需要生成一個ResourceBundle(資源束)的子類並且提供handleGetObject()和getKeys()方法的定義。為了在程序中使用來自ResourceBundle的地方化資源,就需要先調用靜態的getBundle()方法,用getBundle()獲得一個ResourceBundle對象,然後再用getObject()方法去按照名字來查找資源。當然也可以使用getString()簡單的把getObject()的返回值分配給一個String對象。GetBundle()方法采用basename_language_country_variait----沒找到的話->basename_language_country----沒找到的話->basename_language----沒找到的話->basename(默認資源文件)的算法尋找合適的資源。如果以上都沒找到的話,則會拋出一個MissingResourceException異常。
現在我們來看一個簡單的例子,如何使Java程序用戶界面地方化的。
首先我們的程序需要查找特定Locale對象關聯的資源包,所以應該定義一個Local對象,來獲取本地默認的地區!然後可以調用ResourceBundle的getBundle方法,並將locale對象作為參數傳入。
清單一:
Locale locale = Locale.getDefault(); //獲取地區:默認
//獲取資源束。如未發現則會拋出MissingResourceException異常
ResourceBundle bundle = ResourceBundle.getBundle("Properties.Dorian",locale);
清單一中的”Properties.Dorian”代表Properties包下以Dorian命名的默認資源文件。這樣就可以使用資源文件了!讓我們來看看資源文件是如何定義的。
清單二:
Title=\u4e2d\u56fd;
red.label=\u7ea2\u8272;
green.label=\u7eff\u8272;
blue.label=\u84dd\u8272;
清單三:
# 文件Dorian_en_US.properties,是美國地區的資源束
# 它覆蓋了默認資源束
Title=America;
red.label=Red;
green.label=Green;
blue.label=Blue ;
清單一和二定義了一個默認資源文件,和美國地區的資源文件。其中等號左邊的字符串表示主鍵,它們是唯一的。為了獲得主鍵對應的值,你可以調用ResourceBundle類的getString方法,並將主鍵作為參數。此外,文件中以“#”號開頭的行表示注釋行。需要注意的是清單二中的“\u4e2d\u56fd”,它是字符“中國”的Unicode字符碼。是使用Java自帶的native2ascii工具轉換的(native2ascii in.properties out.properties),這是為了不在程序界面中產生亂碼。
清單四:
cmdRed.setText(bundle.getString("red.label"));
cmdBlue.setText (bundle.getString("blue.label"));
cmdGreen.setText (bundle.getString("green.label"));
清單二中的cmdRed、cmdBlue、cmdGreen 為按鈕。bundle.getString("red.label")為得到資源文件中主鍵是red.label的值。
好了到此為止Java程序用戶界面的本地化就是這麼簡單。不過,要提醒你的是在為用戶界面事件編寫事件監聽器代碼時,要格外小心。請看下面這段代碼。
清單五:
public class MyApplet extends Japplet implements ActionListener{
public void init(){
JButton cancelButton=new JButton(“Cancel”);
CancelButton.addActionListener(this);
...
}
public void actionPerformed(ActionEvent e){
String s=e.getActionCommand();
if(arg.equals(“Cancel”);
doCancel();
else ……
}
}
如果你對清單五的代碼不進行本地化,她就可能會運行的很好。但當你的按鈕被本地化為中文時,“Cancel”變為了“取消”。這時就會出現你不願意看到的問題。下面有三個方法可以消除這個潛在的問題!
1> 使用內部類而不使用獨立的actionPerformed程序。
2> 使用引號而不使用標簽來標識組件。
3> 使用name屬性來標識組件
本例稍後的代碼就是采用第一種方法來消除這個問題的。
清單六:完整的代碼
//:MyNative.java
/**
Copyright (c) 2003 Dorian. All rights reserved
@(#)MyNative.java 2003-12-21
@author Dorian
@version 1.0.0
visit http://www.Dorian.com/Java/
*/
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import java.util.*;
/**
這是一個將Java程序界面地方化的例子本例采用讀取屬性文件來達到目的
@see java.util.Locale;
@see java.util.ResourceBundle;
@see java.util.MissingResourceException;
*/
public class MyNative{
public static void main(String[] args){
JFrame frame = new MyNativeFrame();
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setResizable(false);
frame.setVisible(true); // Pop the window up.
}
}
class MyNativeFrame extends JFrame{
public MyNativeFrame(){
Locale locale = Locale.getDefault();//獲取地區:默認
//獲取資源束。如未發現則會拋出MissingResourceException異常
//"Properties.Dorian"為在Properties下以Dorian為文件名的默認屬性文件
ResourceBundle bundle = ResourceBundle.getBundle("Properties.Dorian",locale);
setTitle(bundle.getString("Title"));//通過getString()的返回值來設置Title
setSize(WIDTH,HEIGHT); // Set the window size.
panel=new MyNativePanel();
Container contentPane=getContentPane();
contentPane.add(panel);
//通過獲取資源束中*.label的值對三個按鈕設置其Label
panel.setCmdRed(bundle.getString("red.label"));
panel.setCmdBlue(bundle.getString("blue.label"));
panel.setCmdGreen(bundle.getString("green.label"));
}
private MyNativePanel panel;
private static final int WIDTH=400;
private static final int HEIGHT=100;
}
class MyNativePanel extends JPanel{
public MyNativePanel(){
layout=new BorderLayout();
setLayout(layout);
txt=new JTextField(50);
add(txt,layout.CENTER);
cmdRed=new JButton();
cmdBlue=new JButton();
cmdGreen=new JButton();
panel.add(cmdRed);
panel.add(cmdBlue);
panel.add(cmdGreen);
add(panel,layout.SOUTH);
cmdRed.addActionListener(new ActionListener(){
public void actionPerformed(ActionEvent e){
String s = e.getActionCommand();
txt.setBackground(Color.red);
txt.setText(s);
}
});
cmdBlue.addActionListener(new ActionListener(){
public void actionPerformed(ActionEvent e){
String s = e.getActionCommand();
txt.setBackground(Color.blue);
txt.setText(s);
}
});
cmdGreen.addActionListener(new ActionListener(){
public void actionPerformed(ActionEvent e){
String s = e.getActionCommand();
txt.setBackground(Color.green);
txt.setText(s);
}
});
}
public void setCmdRed(String s){
cmdRed.setText(s);
}
public void setCmdBlue(String s){
cmdBlue.setText(s);
}
public void setCmdGreen(String s){
cmdGreen.setText(s);
}
JPanel panel=new JPanel();
BorderLayout layout;
private JTextField txt;
private JButton cmdRed,cmdBlue,cmdGreen;
}
//~
資源文件:
# Dorian.properties是默認的"Dorian"資源束文件。
# 作為中國人,我用自己的地區作為默認
Title=\u4e2d\u56fd
red.label=\u7ea2\u8272
green.label=\u7eff\u8272
blue.label=\u84dd\u8272
# 文件Dorian_en_US.properties,是美國地區的資源束
# 它覆蓋了默認資源束
Title=America
red.label=Red
green.label=Green
blue.label=Blue
# 文件Dorian_zh_CN.properties,是中國大陸地區的資源束
# 這個文件沒有任何資源定義,從默認中國資源束繼承
以下是這個程序運行後的截屏!