Struts 開發環境搭建與 HelloWorld 完整實戰筆記

開發環境棧

環境變量配置

JAVA_HOME=C:\jdk1.4.2
TOMCAT_HOME=C:\tomcat5
ANT_HOME=C:\ant
PATH=%JAVA_HOME%\bin;%TOMCAT_HOME%\bin;%ANT_HOME%\bin;%PATH%

Eclipse 插件關鍵設置

• Lomboz：JDK Tools.jar 路徑、Server Definitions (Tomcat 5.0)
• Tomcat Plugin：Tomcat Version、Tomcat Home、JVM Settings (必須指向 JDK 而非 JRE)

項目創建與部署驗證

1. 新建 Lomboz J2EE Project: Test
2. 添加 Web Module: myTest
3. Targeted Server: Apache Tomcat v5.0.x
4. 添加 Source Folder: src
5. 設置輸出路徑: Test/myTest/WEB-INF/classes
6. Lomboz J2EE View → Deploy myTest
7. 啟動 Tomcat，訪問 https://localhost:8080/myTest 顯示 Welcome 頁

Struts HelloWorld 實戰

1. 複製 Struts 庫文件

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

2. 配置 web.xml

<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>

4. 創建 HelloWorld.jsp

<%@ page contentType="text/html;charset=UTF-8" %>
<html><body>
<h1>Hello World from Struts!</h1>
</body></html>

5. 驗證

重新部署，訪問 https://localhost:8080/myTest/my.do 應轉發顯示 HelloWorld.jsp。

常見問題排查

• 404：檢查 url-pattern、action path、JSP 路徑是否一致
• ClassNotFound：確認 JAR 已複製到 WEB-INF/lib 並加入 classpath
• JSP 編譯錯誤：Tomcat JVM 必須指向 JDK (含 tools.jar)，非 JRE
• 中文亂碼：JSP 頁面指令、web.xml、struts-config.xml 統一 UTF-8

總結

本文記錄了從零搭建 Struts 1.x 開發環境、創建項目、配置核心文件到運行第一個 Action 的完整流程。掌握這套基礎流程，是進一步學習 ActionForm、Validator、Tiles、Module 等進階特性的前提。