學 XML 最有效的路徑,是從簡單的實作切入、大膽動手、循序漸進。XML 的妙處只有在開發過程中才能真正體會,光讀規格是學不会的。所以第一步,永遠是把開發環境建起來。
本文示範一套以 Java 為基礎的環境。範例雖然在 Windows 上實作,但這裡用到的工具在 Linux 與 Windows 上都能跑,用法也大同小異;而且除了 Sun 的 JRE 之外,其餘全是 open source 軟體,任何人都可以自由使用,甚至重新發行(JRE 也可免費下載使用,只是沒有原始碼)。
整套環境包含七個必要元件與兩個加分項:
建議使用 Sun 的 JRE 1.3。安裝後(以下假設裝在 C:\JRE1.3),需要設定三個環境變數:
JAVA_HOME = C:\JRE1.3
CLASSPATH = .;C:\JRE1.3\lib\rt.jar
PATH = %PATH%;C:\JRE1.3\bin
Windows 95/98/Me 請把這些設定寫進 Autoexec.bat 後重新開機;Windows NT/2000 直接在「我的電腦 / 內容」裡設定即可。注意要裝的是 JRE,不是 JDK。
推薦 IBM 的 jikes,一個效率相當出色的 open source Java 編譯器。下載解壓後會得到一個 jikes.exe,把它放進 PATH 裡的任一目錄(例如 C:\JRE1.3\bin)即可。
寫個最經典的測試程式確認可用:
// hello.java
public class hello {
public static void main(String[] args) {
System.out.print("hello, world!\n");
}
}
jikes hello.java
能產生出 hello.class,就代表編譯器就緒了。
推薦 Jakarta 的 Tomcat 3.2.1,下載 jakarta-tomcat-3.2.1.zip 後解壓(以下假設放在 C:\tomcat),並設定環境變數:
TOMCAT = C:\tomcat
要讓 Tomcat 改用 jikes 編譯 JSP,需要動一點手腳:
lib 目錄下的 parser.jar、jaxp.jar、webserver.jar 加入 CLASSPATH 並使其生效。src\org\apache\tomcat\context\WebXMLReader.java,把下面這行的註解拿掉,然後用 jikes 重新編譯:
// sw.addInitParam("JSPCompilerPlugin", "org.apache.jasper.compiler.JikesJavaCompiler");
webserver.jar,把剛編譯出的 WebXMLReader*.class 覆蓋掉 org\apache\tomcat\context 下的同名檔案,再重新打包:
mkdir t
cd t
jar xvf ..\webserver.jar
:: 覆蓋 class 檔後重新打包
jar cf webserver.jar .
webserver.jar 取代 Tomcat 原本的檔案。conf 目錄下的 web.xml,把這段被註解掉的設定解除註解:
<init-param>
<param-name>JSPCompilerPlugin</param-name>
<param-value>org.apache.jasper.compiler.JikesJavaCompiler</param-value>
</init-param>
bin 目錄下的 tomcat.bat,把全部的 tools.jar 換成 rt.jar。接著執行 startup.bat 啟動,瀏覽器拜訪 https://localhost:8080,如果 JSP 與 Servlet 範例都能編譯執行,Tomcat 就算裝好了。停止服務用 shutdown.bat。
在 Windows NT/2000 下也可以把 Tomcat 註冊成服務:編輯 conf\wrapper.properties,把 wrapper.tomcat_home 與 wrapper.java_home 設為 Tomcat 與 JRE 的實際路徑,並把 tools.jar 全部替換為 rt.jar,然後執行:
jk_nt_service -I Tomcat wrapper.properties :: 安裝服務
jk_nt_service -R Tomcat :: 移除服務
服務預設是手動啟動,可在服務屬性中改成自動啟動。
推薦 Jakarta Taglibs 裡的 XSL Taglib。下載解壓後,把 xsl-examples.war 與 xsl-doc.war 複製到 Tomcat 的 webapps 目錄,重啟 Tomcat,拜訪 https://localhost:8080/xsl-examples/ 並執行 apply.jsp;若正常顯示一個多表格頁面,就代表可用。文件在 https://localhost:8080/xsl-doc/。
接下來就能開始寫自己的 XML 處理程式了。例如在 Tomcat 的 server.xml 中新增一個 Context:
<Context path="/JSPXML"
docBase="path-to-your-work-directory"
crossContext="false"
debug="0"
reloadable="true" >
</Context>
把 path-to-your-work-directory 換成你的開發目錄,並把 webapps/xsl-examples 下的內容整包複製過去當作起點即可。
做完步驟 3 與 4,你手上其實已經有兩個可用的 XML Parser:Tomcat 本身使用的 Sun JAXP(parser.jar + jaxp.jar),以及 XSL Taglib 使用的 Apache Xerces(xerces.jar)。這幾個檔案都能在 Tomcat 目錄下找到。
建議使用 Xerces:它當時已支援 XML Schema,而且是 open source。當然這純屬個人偏好,Sun 的實作同樣優秀。關鍵是別同時掛兩個 Parser——選定之後把它的 jar 加進 CLASSPATH,之後就能在 Java 程式中用 DOM 或 SAX 的 API 處理 XML 了。
這一步並非必要,因為伺服器端已經能用 XSL Taglib 把 XML 轉成 HTML 再送出,任何瀏覽器都能看。但裝一個能跑 XSLT 的瀏覽器對學習很有幫助;而且未來若瀏覽器端 XSLT 普及,伺服器甚至可以省下這道工序,直接送 XML + XSL 過去,大幅減輕後端負擔——畢竟做 XSLT 轉換並不輕鬆。
這裡推薦 Mozilla 0.8,理由有三:
安裝方式:下載 Mozilla 0.8 並以 .exe 安裝(0.8.1 在安裝 XSLT 模組後有無法啟動的問題,因此當時建議停留在 0.8)。啟動後拜訪 Mozilla 的 XSLT 專案頁,點擊 Install 按鈕安裝 TransforMiiX 模組,重新啟動,再點開 simple example 比對結果——若顯示的畫面與 look like 連結一致,XSLT 就生效了。
這一步更談不上必要。聽說現在還有人用 vi 寫 HTML 頁面嗎?還真有,而且功力深厚。實質上任何編輯器都能拿來寫 XML;但若你習慣所見即所得的環境,可以考慮:
推薦 Struts。它是 Jakarta 的子專案,目標是打造一個基於 MVC 設計模式的 JSP Framework。在 Struts 的框架內開發,能有效分離 Web 應用程式的表示層與實作層,提高程式碼的重用性——這也就是所謂的 Model 2 開發模式。
下載 jakarta-struts-1.0-b1.zip 解壓後,把 struts-example.war 與 struts-documentation.war 複製到 Tomcat 的 webapps 目錄,重啟 Tomcat,拜訪 https://localhost:8080/struts-example/ 執行 MailReader;能正常完成註冊流程就代表可用。文件在 https://localhost:8080/struts-documentation/。想進一步了解如何在自有開發目錄中使用 Struts,直接看它附帶的文件最可靠。
最簡單的做法是透過 mod_jk 建立連接。假設 Apache 已安裝完成,下載 mod_jk.zip 並解壓取得 mod_jk.dll,複製到 Apache 安裝目錄的 modules 資料夾,然後修改 httpd.conf:
Include C:/tomcat/conf/mod_jk.conf-auto
JkMount /*.do ajp12
DirectoryIndex index.html index.jsp
ServerName localhost
其中 C:/tomcat 換成你的 Tomcat 實際路徑。重新啟動 Apache,拜訪 https://localhost/examples/;若能正常列出 JSP 與 Servlet 目錄,兩者的連接就成功了。
說了這麼多,其實不過是整理內務。環境備齊之後,接下來才是真正的 XML 開發。實務上還有一點值得提醒:本文的版本號與下載網址都屬於當時的技術時空,如今 JRE、Tomcat、Mozilla 的版本早已更迭,Mozilla 的 TransforMiiX 也已走入歷史。真正需要沿用的,是這套「JRE → 編譯器 → 容器 → taglib → parser → 瀏覽器」的分層思維,而不是具體的版本號。