| 維度 | 編譯指令 | 動作指令 |
|---|---|---|
| 執行階段 | JSP 編譯為 Servlet 時 | 請求處理執行期 |
| 語法 | <%@ directive %> | <jsp:action /> |
| 本質 | 指導容器編譯行為 | XML 標籤形式的執行期操作 |
| 可替換性 | 不可替換 | 等價於 Java Scriptlet 程式碼 |
<jsp:forward page="/target.jsp" />
<!-- 攜帶參數 -->
<jsp:forward page="/target.jsp">
<jsp:param name="userId" value="1001" />
<jsp:param name="source" value="home" />
</jsp:forward>
request 保持不變,可共享屬性**必須嵌套在** <jsp:forward>、<jsp:include>、<jsp:params> 內使用。
<jsp:include page="/header.jsp">
<jsp:param name="title" value="歡迎頁面" />
<jsp:param name="theme" value="dark" />
</jsp:include>
<jsp:include page="/fragment/navbar.jsp" flush="true">
<jsp:param name="user" value="${sessionScope.user.name}" />
</jsp:include>
flush="true":包含前刷新輸出緩衝區<%@ include file="..." %> (靜態包含、編譯期合併原始碼) 本質不同<jsp:plugin type="applet" code="Clock.class" width="200" height="200">
<jsp:params>
<jsp:param name="timezone" value="GMT+8" />
</jsp:params>
<jsp:fallback>您的瀏覽器不支援 Applet</jsp:fallback>
</jsp:plugin>
⚠️ **已淘汰**:現代瀏覽器不再支援 Java Applet/NPAPI,僅歷史專案維護涉及。
<!-- 尋找或建立 session 範圍的 UserBean -->
<jsp:useBean id="user" class="com.example.UserBean" scope="session" />
id:變數名 (EL 可用 ${user})class:完整類名scope:page(預設) / request / session / applicationtype:宣告型別 (介面/父類),配合 beanName 使用<!-- 自動映射請求參數到同名屬性 -->
<jsp:setProperty name="user" property="*" />
<!-- 設定單一屬性 -->
<jsp:setProperty name="user" property="email" value="test@example.com" />
<!-- 從請求參數取值,參數名不同於屬性名 -->
<jsp:setProperty name="user" property="userName" param="username" />
<jsp:getProperty name="user" property="email" />
<!-- 等價於 ${user.email} 或 <%= user.getEmail() %> -->
| 動作指令 | 現代替代 (JSTL/EL) | 優勢 |
|---|---|---|
<jsp:include> | <c:import url="..."/> | 支援外部 URL、錯誤處理、匯入二進位資源 |
<jsp:forward> | Controller 轉發 RequestDispatcher | 邏輯集中、可攔截、可測試 |
<jsp:useBean/set/getProperty> | Controller 準備 Model → EL ${bean.prop} | 關注點分離、型別安全、易測試 |
<jsp:plugin> | WebAssembly / JavaScript | 瀏覽器原生支援、效能佳 |
<jsp:include> 仍可用於佈局片段 (header/footer) 引入,但 <c:import> 功能更強<jsp:plugin> 相關代碼,遷移至前端技術棧7 大 JSP 動作指令是 JSP 1.0/1.1 時代的產物,提供了標準化的執行期操作。現代開發中,僅保留 <jsp:include> 佈局片段引入較常見,其餘功能皆由 Controller + EL/JSTL 更優雅地實現。理解其原理有助於維護遺留系統與掌握 JSP 生命週期。