這篇文章假定你已經具備 JSP、Servlet、HTML、XML 與 XSLT 的基礎知識。在接下來的內容裡,我會示範如何運用 XSLT 樣式表與 XML 字典,為網站內容做出一套可擴充的多語系(i18n)解決方案。
要動態呈現並國際化網站上的資訊,一直是個棘手的問題。舉例來說,一個 HTML 頁面裡往往藏著大量需要翻譯成目標語言的按鈕與標籤文字。傳統上,我們可以透過編碼、撰寫 Servlet 或 JSP,或乾脆為每一種語言準備一份獨立頁面來達成翻譯。然而一旦內容來源是動態產生的,這些做法的成本與複雜度就會迅速失控。
好消息是,多數網站應用處理的資料本身就是 XML 格式(連 HTML 頁面也能視為 XML)。因此,我們得以借助既有的 XML 轉換機制(例如 XSLT),依據目標語言動態替換文字。但如果只用 XSLT,每增一組語言配對就得再寫一份樣式表,維護起來非常痛苦。真正的解法,是打造一份「字典驅動」的通用 XSLT 樣式表,用來控制可翻譯文字的動態替換。由於只要提供一本新字典,就能把同一份樣式表套用到全新語境,这种做法大幅降低了國際化的成本與複雜度,也讓字典得以重複使用,為翻譯文字建立一個集中管理的位置。
圖 1:使用通用 XSLT 樣式表
至於轉換的執行位置則有彈性:可以在 Servlet、JSP 或瀏覽器端進行。舉例來說,Internet Explorer 5.0 就能自行處理 XSLT 轉換,把部分運算推到用戶端以提升效能。但 WAP 手機、Palm Pilot 這類裝置並不具備此能力,因此在這些情境下,轉換就必須在 Servlet 或 JSP 中完成。
設計通用樣式表的關鍵,在於寫出一份能套用到各種情境、且不直接綁定任何特定標記語言(HTML、WML 或其他)的樣式表。這份通用樣式表負責把「國際化資訊如何呈現」的基礎功能封裝起來,之後再透過其他樣式表加以擴充或包含。它遵循以下規則:
在需要國際化的 HTML/XML 文件中,每一個要翻譯的元素——像是按鈕、標籤或文字——都必須標上 nlsid 屬性,其值作為查詢 XML 字典的索引鍵。樣式表會替字典建立索引、以 nlsid 的值找出對應鍵值、比對字典中目前的語言,再取出已翻譯的文字,然後把它覆寫或插入到元素內容中。若樣式表在字典裡找不到 nlsid 指定的鍵,它就直接把元素原有的內容(如果該元素帶有預設內容)複製到新文件裡。清單 1 展示了實作這條規則的通用樣式表。樣式表會接收兩個參數:一個用來指定要使用的 XML 字典,另一個則指定偏好的目標語言。
XML 字典的結構如下:根元素是 locale,其子元素是字典中的鍵,可透過 nlsid 屬性的值來索引;每個鍵底下再放著帶有譯文、以語言代碼命名的子元素。你可以為應用程式的每一頁、每一個區塊各定義一本字典,也可以讓整個應用共用一本,甚至跨多個應用程式共用同一本 XML 字典。清單 2 是一本登入畫面的字典範例,收錄了英文與德文兩種語言。
清單 2:登入畫面的字典
<?XML version='1.0'?>
<locale>
<userid>
<en-us>User Name</en-us>
<de>Benutzername</de>
</userid>
<passWord>
<en-us>PassWord</en-us>
<de>Passwort</de>
</passWord>
<logonbutton>
<en-us>Logon</en-us>
<de>Anmelden</de>
</logonbutton>
</locale>
如前所述,任何需要翻譯的元素都得標上 nlsid 屬性,而元素本身可以帶、也可以不帶預設語言。清單 3a 是「帶有預設語言」的標籤元素寫法,清單 3b 則是「沒有預設語言」的樣子,清單 3c 則示範套用通用樣式表後的結果。在這個例子裡,瀏覽器傳來的首選語言是德文,並採用清單 2 定義的字典。
清單 3a:在 HTML 文件中定義帶有預設語言的元素
<label id="useridLabel" nlsid="userid">User Name</label>
或者
清單 3b:在 HTML 文件中定義不帶預設語言的元素
<label id="useridLabel" nlsid="userid"/>
清單 3c:轉換結果
<label id="useridLabel" nlsid="userid">Benutzername</label>
Internet Explorer、Netscape Navigator 這類瀏覽器都允許使用者設定首選語言,而 Servlet 或 JSP 可以從 HTTP 請求的 Accept-Language 標頭中讀取使用者的偏好語言。要讓網站國際化,流程其實很單純:把首選語言當作參數傳給 XSLT 樣式表、把字典檔設為另一個參數、對 HTML/XML 文件執行轉換,最後輸出國際化後的內容即可。
舉例來說,Servlet 裡可能包含類似清單 4 的程式碼,用來處理 HTML 頁面的翻譯。
清單 4:HTML 頁面的翻譯
public void doGet (HttpServletRequest req, HttpServletResponse res) throws
ServletException, IOException {
.......
XSLTProcessor processor =
org.apache.xalan.xslt.XSLTProcessorFactory.getProcessor();
processor.setStylesheetParam("currentLocale",
req.getHeader("Accept-Language"));
processor.setStylesheetParam("dictionary-file","'nls.XML'");
processor.process(new
org.apache.xalan.xslt.XSLTInputSource("HtmlToBeTranslated.XML"),
new
org.apache.xalan.xslt.XSLTInputSource("NLSStyleSheet.xsl"),
new
org.apache.xalan.xslt.XSLTResultTarget(OutputStreamForVIEw));
.......
}
本文示範了如何結合 XSLT 與 XML 字典,打造一套可擴充的網站國際化解決方案。採用這種做法,不僅大幅減少開發人員需要維護的程式碼,也能避免把資源字串硬編碼後散落在各個應用程式之中。更重要的是,你只需維護單一份頁面來源,而不必為十幾、二十幾種語言各寫一份相同的頁面;同時,字典還能在眾多應用程式之間自由重複使用。