JSP核心語法詳解：指令、動作與註釋元素全攻略

JSP（JavaServer Pages）頁面本質上是HTML標籤與JSP元素的混合體。JSP容器在翻譯階段會將這些元素轉換為Servlet的Java代碼。掌握三大核心元素——註釋、指令、動作，是編寫高效、可維護JSP頁面的關鍵。

一、JSP註釋：隱藏於伺服器端的說明

語法：<%-- 註釋內容 --%>

• 特性：僅存在於JSP源文件中，翻譯為Servlet時會被移除，不會輸出至客戶端瀏覽器。
• 用途：記錄業務邏輯說明、暫時禁用代碼片段、版本資訊等敏感資訊。
• 對比：HTML註釋 <!-- --> 會輸出至瀏覽器原始碼，不可用於隱藏伺服器邏輯。

二、指令元素：頁面級配置指令

指令元素為JSP容器提供頁面處理的全域資訊，語法：<%@ 指令名 屬性="值" %>。

1. page 指令：核心配置

定義頁面屬性，如編碼、錯誤處理、Session啟用等。

<%@ page 
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    errorPage="error.jsp"
    isErrorPage="false"
    session="true"
    import="java.util.*, java.sql.*"
    buffer="8kb"
    autoFlush="true"
%>

2. include 指令：靜態包含

語法：<%@ include file="相對路徑" %>

• 翻譯階段合併文件內容，產生單一Servlet類。
• 適用：靜態頁首/頁尾、公共聲明、版權資訊。
• 限制：包含文件變更需重新編譯主頁面；不能包含動態邏輯判斷。

3. taglib 指令：標籤庫宣告

引入自定義標籤庫（如JSTL），賦予語義化標籤能力。

<%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="fmt" uri="https://java.sun.com/jsp/jstl/fmt" %>

• uri：唯一標識標籤庫描述符（TLD）位置。
• prefix：自定義前綴，使用時格式為 <prefix:tagName>。

JSTL 核心標籤示例：

<c:if test="${user.loggedIn}">
    歡迎，<c:out value="${user.name}" />！
</c:if>
<c:forEach var="item" items="${productList}">
    <li><c:out value="${item.name}" /> - $<c:out value="${item.price}" /></li>
</c:forEach>

三、動作元素：請求處理階段的行為

動作元素在請求處理階段執行，語法符合XML規範：<jsp:actionName ... />。

1. JavaBean 操作三劍客

<!-- 實例化 UserBean 放入 Session -->
<jsp:useBean id="user" class="com.model.UserBean" scope="session" />
<!-- 自動映射表單參數到 Bean 屬性 -->
<jsp:setProperty name="user" property="*" />
<!-- 輸出屬性 -->
用戶名：<jsp:getProperty name="user" property="username" />

2. 頁面流程控制

• <jsp:include page="..." flush="true" />：動態包含。請求階段執行目標頁面，將響應合併。目標頁面可獨立編譯，支援參數傳遞 (<jsp:param>)，適合動態內容區塊。
• <jsp:forward page="..." />：請求轉發。將請求轉交給其他資源（Servlet/JSP），瀏覽器URL不變，請求對象共享。
• <jsp:param name="..." value="..." />：輔助標籤，用於 include 或 forward 時附加請求參數。

<jsp:include page="sidebar.jsp" flush="true">
    <jsp:param name="category" value="tech" />
    <jsp:param name="userId" value="${param.id}" />
</jsp:include>

核心差異總結：include 指令 vs jsp:include 動作

最佳實踐建議

1. 盡量使用 JSTL/EL 表達式 替代 Scriptlet (<% ... %>)，實現邏輯與視圖分離。
2. 頁面編碼統一設為 UTF-8 (pageEncoding 與 contentType charset)，杜絕亂碼。
3. 善用 scope 屬性：page (默認) < request < session < application，按需最小化作用域。
4. 動態內容區塊優先用 jsp:include，佈局模板用 include 指令 或 Tiles/SiteMesh 等框架。