Struts 1.x 開發環境搭建與 HelloWorld 完整實戰

一、開發工具與版本選型

經典 Struts 1.x 開發棧包含：JDK 1.4.2、Eclipse 3.x、Struts 1.2.x、Tomcat 5.0.x、Ant 1.6.x，以及 Lomboz、XMLBuddy、Checkstyle 等 Eclipse 插件。雖然版本較舊，但環境搭建邏輯對理解 MVC 架構演進仍具參考價值。

二、環境變數與插件配置

1. 系統環境變數

• JAVA_HOME、TOMCAT_HOME、ANT_HOME
• Path 追加 %JAVA_HOME%\bin、%TOMCAT_HOME%\bin、%ANT_HOME%\bin

2. Eclipse 關鍵插件配置

• Lomboz：設定 JDK Tools.jar 與 Server Definitions，支援 J2EE 專案建立與伺服器整合。
• Tomcat Plugin：指定 Tomcat version、Tomcat home，JVM Settings 必須指向 JDK 而非 JRE（編譯 JSP 需 tools.jar）。

三、建立測試專案驗證環境

1. 新建 Lomboz J2EE Project，命名 Test。
2. Web Module 命名 myTest，Targeted Server 選 Apache Tomcat v5.0.x。
3. 新增 Source Folder src，專案輸出路徑設為 Test/myTest/WEB-INF/classes。
4. Lomboz J2EE View 中 Deploy myTest，啟動 Tomcat，瀏覽器訪問 https://localhost:8080/myTest 顯示 Welcome 即成功。

四、Struts HelloWorld 手把手實作

1. 複製核心庫與配置文件

• struts/lib/*.jar → WEB-INF/lib/
• struts/lib/*.dtd, *.tld, *.xml → WEB-INF/
• 右鍵專案 → Lomboz J2EE > Add WEB-INF/lib jars to classpath

2. 配置 web.xml - ActionServlet 前端控制器

<servlet>
    <servlet-name>action</servlet-name>
    <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
    <init-param>
        <param-name>config</param-name>
        <param-value>/WEB-INF/struts-config.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>action</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

3. 編寫 struts-config.xml - 動作映射與轉發

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config SYSTEM "struts-config_1_2.dtd">
<struts-config>
    <action-mappings>
        <action path="/my" forward="/HelloWorld.jsp"/>
    </action-mappings>
    <controller processorClass="org.apache.struts.action.RequestProcessor" contentType="text/html"/>
</struts-config>

此配置將 /my.do 直接轉發至 HelloWorld.jsp，無需 Action 類，適合靜態頁面跳轉測試。

五、常見坑點與驗證清單

• JSP 編碼與 web.xml <page-encoding> 一致（建議 UTF-8）。
• Tomcat 插件 JVM 必須指向 JDK，否則 JSP 編譯報錯 tools.jar not found。
• struts-config.xml DTD 宣告需與 Struts 版本匹配，否則啟動報解析錯誤。

完成上述步驟，即可跑通最精簡的 Struts 1.x 請求流程，為後續 FormBean、Action、驗證、國際化等進階功能打下基礎。