Struts 2 入門實戰（一）：核心配置文件詳解與第一個Action實現

Struts 2 架構核心：Filter分發器模式

不同於Struts 1的ActionServlet，Struts 2 採用Filter攔截器作為核心控制器：

<!-- web.xml 核心配置 -->
<filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

• StrutsPrepareAndExecuteFilter：雙階段Filter，Prepare階段初始化配置/Action上下文，Execute階段執行Action
• 默認攔截*.action或無後綴請求，靜態資源放行
• 每請求創建一個Action實例 → 線程安全 (Struts 1共享Action需同步)

struts.xml 核心配置詳解

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
    "https://struts.apache.org/dtds/struts-2.5.dtd">

<struts>
    <!-- 常量配置 -->
    <constant name="struts.devMode" value="true" />        <!-- 開發模式：熱加載、詳細錯誤 -->
    <constant name="struts.ui.theme" value="simple" />     <!-- UI主題 -->
    <constant name="struts.action.extension" value="action,"/> <!-- 支持.action和無後綴 -->
    
    <!-- 包配置：Action分組，支持繼承 -->
    <package name="default" namespace="/" extends="struts-default">
        
        <!-- Action定義 -->
        <action name="hello" class="com.example.HelloAction" method="execute">
            <!-- 結果映射：邏輯視圖名 → 物理資源 -->
            <result name="success">/hello.jsp</result>
            <result name="input">/error.jsp</result>
            <result name="json" type="json">  <!-- JSON結果類型 -->
                <param name="root">data</param>
            </result>
        </action>
        
        <!-- 通配符映射：/user/*  ->  UserAction.{1} -->
        <action name="user/*" class="com.example.UserAction" method="{1}">
            <result name="list">/user/list.jsp</result>
            <result name="edit">/user/edit.jsp</result>
        </action>
        
    </package>
    
    <!-- 模塊化配置：包含子配置文件 -->
    <include file="struts-admin.xml"/>
    <include file="struts-api.xml"/>
</struts>

關鍵屬性深度解析

Action 實現類：POJO風格 (無需實現接口)

package com.example;

import com.opensymphony.xwork2.ActionSupport; // 提供validate、i18n、錯誤處理
import java.util.Date;

public class HelloAction extends ActionSupport {
    
    // 屬性驅動：自動接收請求參數
    private String username;
    private int age;
    private Date birthDate; // 類型轉換自動處理
    
    // 業務數據：供結果頁面展示
    private String message;
    private User user;
    
    @Override
    public String execute() throws Exception {
        // 業務邏輯
        if ("admin".equals(username)) {
            message = "歡迎管理員 " + username;
            user = new User(username, "admin@email.com");
            return SUCCESS; // 常量 "success"
        } else {
            message = "歡迎 " + username;
            return INPUT; // "input"，對應驗證失敗頁面
        }
    }
    
    // 手動驗證 (或用XML/註解驗證)
    @Override
    public void validate() {
        if (username == null || username.trim().isEmpty()) {
            addFieldError("username", "用戶名不能為空");
        }
        if (age < 0 || age > 150) {
            addFieldError("age", "年齡範圍 0-150");
        }
    }
    
    // Getter/Setter 省略...
}

JSP 視圖頁面：Struts 標簽庫

<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head><title>Struts 2 Demo</title></head>
<body>
    <h2><s:property value="message" /></h2>
    
    <!-- 表單標簽：自動綁定Action屬性、顯示錯誤 -->
    <s:form action="hello">
        <s:textfield name="username" label="用戶名" />
        <s:textfield name="age" label="年齡" type="number" />
        <s:submit value="提交" />
    </s:form>
    
    <!-- 迭代顯示 -->
    <s:if test="user != null">
        <p>用戶: <s:property value="user.username" /> (<s:property value="user.email" />)</p>
    </s:if>
    
    <!-- 錯誤顯示 -->
    <s:fielderror />
</body>
</html>

訪問路徑規則

URL = ContextPath + Namespace + ActionName + Extension

• ContextPath: /myapp
• Namespace: / (package namespace)
• ActionName: hello
• Extension: .action 或 無
• 完整訪問：https://localhost:8080/myapp/hello.action 或 /myapp/hello

常見問題排查

模塊化最佳實踐

1. 按業務域劃分：struts-user.xml、struts-order.xml、struts-admin.xml
2. 主配置<include file="..."/>引入
3. 每包獨立namespace：/user、/order、/admin
4. 公共攔截器/結果類型定義在基礎包struts-default或自定義base-package中，業務包extends繼承

總結

Struts 2 以Filter分發 + POJO Action + 靈活結果映射 + 強大攔截器棧構建MVC框架。掌握struts.xml核心元素（package/action/result/namespace/extends）、Action屬性驅動與驗證、結果類型選擇、模塊化配置，即可快速構建傳統Web應用。雖然Spring MVC已成主流，但理解Struts 2的攔截器鏈、值棧OGNL、類型轉換、插件擴展機制，對掌握Java Web框架設計思想極有裨益。