| 元素 | 語法 | 用途 | XML 兼容語法 |
|---|---|---|---|
| 指令 | <%@ directive %> | 指示容器如何處理頁面 | <jsp:directive.directive /> |
| 聲明 | <%! declaration %> | 定義頁面級變量/方法 | <jsp:declaration>...</jsp:declaration> |
| 表達式 | <%= expression %> | 輸出值到響應流 | <jsp:expression>...</jsp:expression> |
| 腳本片段 | <% code %> | 嵌入 Java 邏輯代碼 | <jsp:scriptlet>...</jsp:scriptlet> |
| 註釋 | <%-- comment --%> | 僅服務端可見,不輸出到客戶端 | <jsp:comment>...</jsp:comment> |
<%@ page
language="java"
contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"
import="java.util.*, java.sql.*"
errorPage="error.jsp"
isErrorPage="false"
session="true"
buffer="8kb"
autoFlush="true"
isThreadSafe="true"
info="頁面描述"
%>
import:導入包/類,多個用逗號分隔errorPage:拋出異常時轉向的錯誤頁isErrorPage="true":聲明當前頁為錯誤頁,可用 exception 隱含對象session:是否參與 HTTP Session,false 可減輕服務器壓力buffer:輸出緩衝區大小,none 直接輸出<%@ include file="header.jsp" %>
<jsp:include page="..." /> (動態包含、運行時合併、可傳參)<%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="fn" uri="https://java.sun.com/jsp/jstl/functions" %>
<%@ taglib prefix="fmt" uri="https://java.sun.com/jsp/jstl/fmt" %>
<%@ taglib prefix="my" tagdir="/WEB-INF/tags" %> <!-- 標籤文件目錄 -->
<%!
private int counter = 0; // 實例變量 (每請求一個實例,線程不安全!)
private static final String CONST = "CONST"; // 靜態常量 (共享)
public String formatDate(Date date) {
return new SimpleDateFormat("yyyy-MM-dd").format(date);
}
%>
⚠ 警告:JSP 默認單實例多線程,聲明的非靜態變量是線程不安全的實例變量。盡量避免在聲明中定義可變狀態,改用局部變量或 ThreadLocal。
<%= "Hello " + userName %>
<%= new java.util.Date() %>
<%= request.getParameter("id") %>
<%-- 等價於 out.print(...) --%>
<input value="<%= userName %>"><%
String name = request.getParameter("name");
if (name == null || name.isEmpty()) {
%>
<%@ include file="error.html" %>
<%
} else {
User user = userService.findByName(name);
if ("admin".equals(user.getRole())) {
%>
<h1>管理員面板</h1>
<%
}
}
%>
{} 跨標籤配對,極易導致代碼難讀維護| 對象 | 類型 | 作用域 | 核心用途 |
|---|---|---|---|
| request | HttpServletRequest | request | 參數、屬性、Header、Session 獲取 |
| response | HttpServletResponse | page | 設置狀態碼、Header、Cookie、重導向 |
| out | JspWriter | page | 輸出響應內容 (表達式最終調用) |
| session | HttpSession | session | 用戶會話數據 (需 page 指令 session="true") |
| application | ServletContext | application | 全局配置、資源路徑、屬性共享 |
| config | ServletConfig | page | 初始化參數 (<init-param>) |
| pageContext | PageContext | page | 統一訪問其他 8 對象、作用域屬性操作、轉發/包含 |
| page | Object (this) | page | 當前 Servlet 實例,極少用 |
| exception | Throwable | page | 僅錯誤頁 (isErrorPage="true") 可用 |
${user.name} // 等同 pageContext.findAttribute("user").getName()
${param.id} // request.getParameter("id")
${header["user-agent"]} // request.getHeader("User-Agent")
${sessionScope.cart.itemCount} // 精確指定作用域
${empty list} // 判空 (null/空字符串/空集合/空數組)
${fn:length(list)} // JSTL fn 函數
${user.role == 'admin' ? '管理員' : '普通用戶'} // 三元運算
<c:if test="${not empty user}">歡迎 ${user.name}</c:if>
<c:choose>
<c:when test="${user.vip}">VIP 用戶</c:when>
<c:otherwise>普通用戶</c:otherwise>
</c:choose>
<c:forEach var="item" items="${productList}" varStatus="status">
${status.count}. ${item.name} - ¥${item.price}
</c:forEach>
<c:url value="/product/detail" var="url">
<c:param name="id" value="${item.id}" />
</c:url>
<a href="${url}">查看詳情</a>
JSP 屬於服務端模板渲染模式,現代主流架構:
維護舊專案時仍需掌握 JSP 語法,但新專務不推薦使用 JSP 作為視圖層。