Struts 配置檔詳解與 MyEclipse 整合開發實戰

前言

本文說明 Struts 核心配置檔 struts-config.xml 各區段功能，並示範 MyEclipse 整合 Struts 開發流程：從專案建立、ActionForm 產生、驗證設定、到查詢功能實作。

struts-config.xml 結構總覽

<struts-config>
  <data-sources/>          <!-- JDBC 連線池 (建議改用 JNDI) -->
  <form-beans/>            <!-- ActionForm 定義 -->
  <global-exceptions/>     <!-- 全域例外對應 -->
  <global-forwards/>       <!-- 全域轉向 -->
  <action-mappings/>       <!-- 核心：Action 映射 -->
  <message-resources/>     <!-- 國際化訊息資源 -->
</struts-config>

MyEclipse 整合 Struts 開發步驟

1. 專案建立：右鍵專案 → MyEclipse → Add Struts Capabilities，設定預設資源檔
2. 自動產生：web.xml 註冊 ActionServlet、struts-config.xml 骨架、TLD 複製至 WEB-INF

實作查詢功能範例

資料庫結構

T_user
userId (PK, Char(10))   用戶ID
userName (Varchar(20))  用戶名

1. 建立 ActionForm (UserQueryForm)

• 繼承 org.apache.struts.action.ActionForm
• 屬性：userId、userName、results (List<User>)
• 產生 Getter/Setter
• 覆寫 reset() 清空屬性
• 選擇性覆寫 validate() 做前端格式檢查

2. 建立回傳 Bean (User)

public class User {
    private String userId;
    private String userName;
    // getter/setter
}

3. JSP 頁面 (userQuery.jsp)

<html:form action="/userQuery">
  用戶ID: <html:text property="userId"/>
  用戶名: <html:text property="userName"/>
  <html:submit property="submit" value="查詢"/>
</html:form>
<logic:present name="UserQueryForm" property="results">
  <logic:iterate id="user" name="UserQueryForm" property="results">
    <bean:write name="user" property="userId"/> - 
    <bean:write name="user" property="userName"/><br>
  </logic:iterate>
</logic:present>

4. Action 類別 (UserQueryAction)

• 繼承 org.apache.struts.action.Action
• execute() 內：取得 Form 資料 → 呼叫 Service/DAO 查詢 → 將 List<User> 存入 Form.results → 回傳 mapping.findForward("success")

5. struts-config.xml 註冊

<form-bean name="UserQueryForm" type="com.example.form.UserQueryForm"/>
<action path="/userQuery"
        type="com.example.action.UserQueryAction"
        name="UserQueryForm"
        scope="request"
        validate="false">
  <forward name="success" path="/userQueryResult.jsp"/>
</action>

命名規範建議 (團隊協作)

• 變數/屬性：camelCase (如 userId, userName)
• 類別：PascalCase (如 UserQueryForm)
• Action 路徑：小寫、多詞首字母大寫 (如 /userQuery, /editRecord)
• JSP 檔名：同 Action 路徑

總結

掌握 struts-config.xml 五大區段用途，善用 MyEclipse 產生樣板碼，遵循命名規範，即能高效開發 Struts 應用。後續可引入 Validator 框架、Tiles 模板、Service 層分離等進階技術。