{{{
#!html
JSP 支援多國語系
Tomcat + JSP + i18n + taglib + utf-8 轉碼法
}}}
[[PageOutline]]
= update =
* 2011/09/15 補充 utf 8 轉碼法
= 環境 =
* sun java jdk 6
* tomcat 6
* 參數說明
|| ＄_tomcat_ || 代表你放tomcat的路徑。如 /opt/tomcat/ ||
|| ＄_project_ || 代表你的project 名稱。如：i18n ||
|| ＄_workspace_ || 代表你Eclipse該專案所放置的路徑。如：/home/myname/workspace/ ||
* '''以下提供兩種實做的方法，第一種是直接放到 tomcat 下的目錄下；第二種方法用Eclipse 輔助編輯與即時編譯 ，可擇一實做'''
= 說明 =
開發jps上的i18n，基本上要準備的有 （Tomcat + JSP + i18n + taglib）
並且將內容分成三大部份，1. i18n函式庫設定 2. 多國語系參數properties檔 3. JSP 程式碼
== 1. i18n函式庫設定 ==
首先要把 i18n 的taglibs-i18n.jar 包找到，放到我們要引用的tomcat 專案目錄中，用 taglibs-i18n.tld 描述這個jar ，而web.xml 則要告訴tomcat 要用到的 taglibs-i18n.tld 與 http://jakarta.apache.org/taglibs/i18n-1.0 建立連結。
如此，則i18n與taglib 的環境則準備好了
=== web.xml ===
|| Tomcat || ＄_tomcat_/webapps/＄_project_/WEB-INF/web.xml ||
|| Eclipse || ＄_workspace_/＄_project_/WebContent/WEB-INF/web.xml ||
{{{
#!xml
i18n
index.html
index.htm
index.jsp
http://jakarta.apache.org/taglibs/i18n-1.0
/WEB-INF/taglibs-i18n.tld
}}}
=== taglibs-i18n.tld ===
|| Tomcat || ＄_tomcat_/webapps/＄_project_/WEB-INF/taglibs-i18n.tld ||
|| Eclipse || ＄_workspace_/＄_project_/WebContent/WEB-INF/taglibs-i18n.tld ||
[http://trac.nchc.org.tw/cloud/raw-attachment/wiki/waue/2010/0805/taglibs-i18n.tld (可下載附件)]
=== taglibs-i18n.jar ===
|| Tomcat || ＄_tomcat_/webapps/＄_project_/WEB-INF/lib/taglibs-i18n.jar ||
|| Eclipse || ＄_workspace_/＄_project_/WebContent/WEB-INF/lib/taglibs-i18n.jar ||
[http://trac.nchc.org.tw/cloud/raw-attachment/wiki/waue/2010/0805/taglibs-i18n.jar (可下載附件)]
== 2. 多國語系參數properties檔 ==
多國語系目前較好的用法是，我們設計一個 jps 檔，當他out.print 的時候是用參數的方法印出，而參數的語系則交由使用者或程式來決定
因此，同一個參數 test1 ，我們需要 i18n_en.properties 來定義英文版本；i18n_zh_TW.properties 來定義中文版本；...依此類推
這個範例中，為了專案程式碼目錄的整潔度而言，將properties 檔放到 org/mytest/ 下，若看官想放其他目錄，需注意與jsp檔 程式碼的搭配。
=== i18n_en.properties ===
|| Tomcat || ＄_tomcat_/webapps/＄_project_/WEB-INF/classes/org/mytest/i18n_en.properties ||
|| Eclipse || ＄_workspace_/＄_project_/src/org/mytest/i18n_en.properties ||
{{{
#!text
test1 = Hello world
test2 = Now you can let jsp i18n using i18n taglib!
}}}
=== i18n_zh_TW.properties ===
|| Tomcat || ＄_tomcat_/webapps/＄_project_/WEB-INF/classes/org/mytest/i18n_zh_TW.properties ||
|| Eclipse || ＄_workspace_/＄_project_/src/org/mytest/i18n_zh_TW.properties ||
{{{
#!text
test1 = 你好！世界
test2 = 你現在已經能讓你的JSP使用I18N的taglib跟世界接軌囉！
}}}
== 3. JSP 程式碼 ==
=== index.jsp ===
|| Tomcat || ＄_tomcat_/webapps/＄_project_/index.jsp ||
|| Eclipse || ＄_workspace_/＄_project_/WebContent/index.jsp ||
{{{
#!java
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"
import="java.io.*,java.text.*,java.util.*,javax.servlet.jsp.*" %>
<%@ taglib uri="http://jakarta.apache.org/taglibs/i18n-1.0" prefix="i18n" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
Examples of I18N Custom Tag Library
Tag Usage
This page displays all key/value pairs in the bundle.
locale = <%= pageContext.getResponse().getLocale() %>
charset = <%= pageContext.getResponse().getCharacterEncoding() %>
WebApp translations
<%
Locale locale = new Locale("zh","");
%>
<%
locale = new Locale("en","");
%>
}}}
== 結果 ==
http://localhost:8080/＄_project_/index.jsp
{{{
#!html
Examples of I18N Custom Tag Library
Tag Usage
This page displays all key/value pairs in the bundle.
locale = zh_TW
charset = UTF-8
WebApp translations
| 1 | 你好！世界 |
| 2 | 你現在已經能讓你的JSP使用I18N的taglib跟世界接軌囉！ |
}}}
= utf-8 轉碼工具 =
== 網頁工具 ==
* 網頁轉碼工具 [http://www.tool.la/UTF-8/]
文字資訊轉檔
== java 工具 ==
* java 的自帶工具
此方法為整份文件轉檔的好招
先建立中文properties 檔（取名為 lang_zh_TW.properties.temp）
=== 中->碼 ===
中文 => utf8碼 （歡 -> \u5c1a）
{{{
/usr/lib/jvm/java-6-sun/bin/native2ascii lang_zh_TW.properties.temp lang_zh_TW.properties
}}}
則 lang_zh_TW.properties 完成
=== 碼->中 ===
之後若要修改，可用還原指令：
utf8碼 => 中文 （\u5c1a -> 歡）
{{{
/usr/lib/jvm/java-6-sun/bin/native2ascii -reverse lang_zh_TW.properties lang_zh_TW.properties.temp
}}}