JSP 本質是 Servlet 的「反向」寫法:靜態 HTML 為主,動態邏輯嵌入其中。早期大量使用 Scriptlet (<% ... %>)、表達式 (<%= ... %>)、宣告 (<%! ... %>) 混雜 HTML,導致「意大利麵條代碼」難以維護。本文梳理 JSP 呼叫 Java 代碼的演進路徑,確立現代最佳實踐。
| 元素 | 語法 | 編譯後位置 | 用途 | 缺陷 |
|---|---|---|---|---|
| Scriptlet | <% java 代碼 %> | _jspService() 方法內 | 流程控制、變數宣告、複雜邏輯 | 業務邏輯與視圖耦合、難測試、無編譯期檢查、IDE 支援弱 |
| Expression | <= 運算式 %> | out.print(運算式) | 輸出變數/運算結果 | 同 Scriptlet,且無法進行複雜邏輯 |
| Declaration | <%! 成員變數/方法 %> | Servlet 類別成員區域 | 定義共用方法、常數 | 共享單例 Servlet 實例 → **線程不安全**、佔用 Heap、違反單一職責 |
鐵律:生產代碼**嚴禁**使用 Scriptlet/Declaration。Expression 僅在極簡原型/遺留維護時少量使用,優先改用 EL (${...})。
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Controller │────▶│ Service │────▶│ DAO/Repo │
│ (Servlet) │ │ (Business) │ │ (Data) │
└─────────────┘ └─────────────┘ └─────────────┘
│
▼
┌─────────────┐
│ View │
│ (JSP/EL) │
└─────────────┘
request/session 作用域。RequestDispatcher.forward() 轉發至 JSP 渲染。${bean.property}) 讀取作用域屬性。c:if/choose/forEach/set/url) 流程控制與迭代。// UserController.java
@WebServlet("/users")
public class UserController extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
int page = parseInt(req.getParameter("page"), 1);
int size = parseInt(req.getParameter("size"), 20);
PageResult result = userService.findPage(page, size);
req.setAttribute("pageResult", result); // 放入 request 域
req.getRequestDispatcher("/WEB-INF/views/user/list.jsp").forward(req, resp);
}
}
<%-- list.jsp --%>
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" isELIgnored="false" %>
<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<html><body>
<table>
<thead><tr><th>ID</th><th>用戶名</th><th>Email</th></tr></thead>
<tbody>
<c:forEach items="${pageResult.items}" var="user">
<tr>
<td>${user.id}</td>
<td>${user.username}</td>
<td>${user.email}</td>
</tr>
</c:forEach>
</tbody>
</table>
<!-- 分頁導航 -->
<c:url value="/users" var="pageUrl">
<c:param name="size" value="${pageResult.size}" />
</c:url>
<c:forEach begin="1" end="${pageResult.totalPages}" var="p">
<a href="${pageUrl}&page=${p}">${p}</a>
</c:forEach>
</body></html>
com.example.controller、com.example.service、com.example.model。**預設套件 (無 package) 類別無法被 JSP/EL 正確導入**,編譯會報錯。.class 放入 WEB-INF/classes/com/example/... (Maven 標準輸出目錄)。WEB-INF/lib/。| 變數名 | 類型 | EL 隱含物件對應 | 說明 |
|---|---|---|---|
| request | HttpServletRequest | ${requestScope} | 請求參數、Header、屬性 |
| response | HttpServletResponse | ${responseScope} | 回應 Header、Cookie、狀態碼 |
| session | HttpSession | ${sessionScope} | 會話屬性、ID、逾時 |
| application | ServletContext | ${applicationScope} | 全域配置、資源路徑、初始化參數 |
| out | JspWriter | — | 輸出流 (Scriptlet 用) |
| pageContext | PageContext | ${pageContext} | 統一入口,可取得以上所有 + request/response 物件 |
| config | ServletConfig | — | Servlet 初始化參數 |
| page | Object (this) | — | 當前 Servlet 實例 |
| exception | Throwable | — | 錯誤頁面 (isErrorPage="true") 可用 |
pageContext.getAttribute("beanName") 從作用域獲取。.tag)。isELIgnored="false" (頁面) 或 web.xml <jsp-config><el-ignored>false</el-ignored></jsp-config> (全域)。jsp-config trimDirectiveWhitespaces="true" 移除編譯產生的多餘空白行。JSP 的設計初衷是「模板引擎」,而非「程式設計語言」。**將 Java 代碼移至獨立類別、JSP 純粹渲染**,是通往可維護、可測試、可擴展 Web 應用的唯一正道。此原則在 Thymeleaf、FreeMarker、Velocity、React/Vue (SSR) 等現代模板/框架中同樣適用:View 僅負責「如何顯示」,Controller/Service 負責「顯示什麼」與「業務規則」。