Struts 2 / Servlet 獲取原生 API 對象完全指南：Request、Response、Session、Application、PageContext

前言：框架封裝下的原生訪問

Struts 2 通過 ServletActionContext 與 ActionContext 提供對 Servlet API 的無侵入式訪問，避免 Action 直接實現 ServletRequestAware 等接口造成耦合。本文匯總獲取 HttpServletRequest、HttpServletResponse、HttpSession、ServletContext、PageContext 的標準代碼，並說明原理與注意事項。

核心工具類

• org.apache.struts2.ServletActionContext：靜態持有當前線程的 Servlet API 對象 (ThreadLocal 機制)；
• com.opensymphony.xwork2.ActionContext：Struts 2 上下文，封裝 Session/Application 為 Map，與 Servlet API 解耦。

標準獲取代碼

import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionContext;
import javax.servlet.http.*;
import javax.servlet.*;

// 1. HttpServletRequest
HttpServletRequest request = ServletActionContext.getRequest();

// 2. HttpServletResponse
HttpServletResponse response = ServletActionContext.getResponse();

// 3. HttpSession (原生)
HttpSession session = request.getSession(); // 或 request.getSession(false)

// 4. Session Map (Struts 2 封裝，單元測試友好)
Map<String, Object> sessionMap = ActionContext.getContext().getSession();

// 5. ServletContext (Application)
ServletContext application = ServletActionContext.getServletContext();

// 6. Application Map (Struts 2 封裝)
Map<String, Object> applicationMap = ActionContext.getContext().getApplication();

// 7. PageContext (極少用，僅 JSP 標籤協作需求)
PageContext pageContext = ServletActionContext.getPageContext();

原理與最佳實踐

常見陷阱

• 線程安全：ActionContext.getContext() 依賴 ThreadLocal，**只能在請求處理線程中調用** (execute、interceptor)，不能在構造函數、靜態初始化、異步線程中使用；
• Session 未創建：getSession() 會自動創建，getSession(false) 才不創建；Map 方式同理；
• Response 已提交後不可設 Header/Cookie：調用 response.getWriter() 或 getOutputStream() 後再設 Header 會拋 IllegalStateException；
• 文件上傳：需 request.getContentType().startsWith("multipart/") 並用 CommonsMultipartParser 或 Servlet 3.0 request.getPart() 解析，Struts 2 文件上傳攔截器已自動封裝為 File 屬性。