萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 呼叫 Java 代碼最佳實踐:從 Scriptlet 到 MVC 架構演進

JSP 本質是 Servlet 的「反向」寫法:靜態 HTML 為主,動態邏輯嵌入其中。早期大量使用 Scriptlet (<% ... %>)、表達式 (<%= ... %>)、宣告 (<%! ... %>) 混雜 HTML,導致「意大利麵條代碼」難以維護。本文梳理 JSP 呼叫 Java 代碼的演進路徑,確立現代最佳實踐。

一、 JSP 三種動態元素原理與缺陷

元素語法編譯後位置用途缺陷
Scriptlet<% java 代碼 %>_jspService() 方法內流程控制、變數宣告、複雜邏輯業務邏輯與視圖耦合、難測試、無編譯期檢查、IDE 支援弱
Expression<= 運算式 %>out.print(運算式)輸出變數/運算結果同 Scriptlet,且無法進行複雜邏輯
Declaration<%! 成員變數/方法 %>Servlet 類別成員區域定義共用方法、常數共享單例 Servlet 實例 → **線程不安全**、佔用 Heap、違反單一職責
鐵律:生產代碼**嚴禁**使用 Scriptlet/Declaration。Expression 僅在極簡原型/遺留維護時少量使用,優先改用 EL (${...})。

二、 現代最佳實踐:MVC + JavaBean + EL/JSTL

架構分層

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Controller │────▶│   Service   │────▶│   DAO/Repo  │
│  (Servlet)  │     │  (Business) │     │   (Data)    │
└─────────────┘     └─────────────┘     └─────────────┘
       │                                     
       ▼                                     
┌─────────────┐                             
│    View     │                             
│  (JSP/EL)   │                             
└─────────────┘                             

Controller (Servlet) 負責:

  1. 接收請求參數 → 封裝 JavaBean / DTO (自動綁定或手動)。
  2. 調用 Service 層執行業務邏輯、事務控制。
  3. 將結果物件放入 request/session 作用域。
  4. RequestDispatcher.forward() 轉發至 JSP 渲染。

JSP (View) 僅負責:

  • EL (${bean.property}) 讀取作用域屬性。
  • JSTL (c:if/choose/forEach/set/url) 流程控制與迭代。
  • 自定義標籤 / Tag Files 封裝複雜 UI 片段。
  • **零 Java 程式碼片段**。

完整範例:用戶列表查詢

// 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>

三、 Java 類別部署規範:包結構與類別載入

  1. 務必使用套件 (package):com.example.controller、com.example.service、com.example.model。**預設套件 (無 package) 類別無法被 JSP/EL 正確導入**,編譯會報錯。
  2. 編譯後 .class 放入 WEB-INF/classes/com/example/... (Maven 標準輸出目錄)。
  3. 第三方 JAR 放入 WEB-INF/lib/。
  4. 容器類別載入器遵循**雙親委派 + 子優先 (WebappClassLoader)**:Web 應用類別優於容器共用庫,實現隔離。

四、 預定義隱含物件 (無需宣告直接在 Scriptlet/EL 中使用)

變數名類型EL 隱含物件對應說明
requestHttpServletRequest${requestScope}請求參數、Header、屬性
responseHttpServletResponse${responseScope}回應 Header、Cookie、狀態碼
sessionHttpSession${sessionScope}會話屬性、ID、逾時
applicationServletContext${applicationScope}全域配置、資源路徑、初始化參數
outJspWriter—輸出流 (Scriptlet 用)
pageContextPageContext${pageContext}統一入口,可取得以上所有 + request/response 物件
configServletConfig—Servlet 初始化參數
pageObject (this)—當前 Servlet 實例
exceptionThrowable—錯誤頁面 (isErrorPage="true") 可用

五、 為何要將 Java 代碼移出 JSP?(六大鐵律)

  1. 開發分工:Java 開發者專注業務邏輯 (IDE、重構、單測);前端工程師專注 HTML/CSS/JS (設計工具、熱重載)。
  2. 編譯部署:Java 類別獨立編譯、單元測試、打包 JAR;JSP 修改需部署至容器觸發重編譯,週期長。
  3. 除錯體驗:Java 斷點、監看、評估表達式完整支援;JSP Scriptlet 除錯痛苦 (行號對應混亂、變數不可見)。
  4. 可測試性:Service/DAO 可獨立單元測試 (Mockito/JUnit);Scriptlet 混雜在 JSP 無法隔離測試。
  5. 重用性:Java 類別可被多 Controller、定時任務、Web Service、Batch Job 共同調用。
  6. 安全性:JSP 編譯後生成 Servlet 類別,原始碼可能洩露邏輯細節;預編譯 (JSPC) 可緩解但增加構建複雜度。

六、 遺留專案漸進式重構策略

  1. 識別「大 Scriptlet 區塊」→ 提取為獨立 Java 類 (Service/Util/Helper)。
  2. 將提取類注入 Servlet/Filter/Listener,或透過 pageContext.getAttribute("beanName") 從作用域獲取。
  3. JSP 替換為 EL + JSTL + 自定義標籤檔 (.tag)。
  4. 引入 isELIgnored="false" (頁面) 或 web.xml <jsp-config><el-ignored>false</el-ignored></jsp-config> (全域)。
  5. 配置 jsp-config trimDirectiveWhitespaces="true" 移除編譯產生的多餘空白行。

結語

JSP 的設計初衷是「模板引擎」,而非「程式設計語言」。**將 Java 代碼移至獨立類別、JSP 純粹渲染**,是通往可維護、可測試、可擴展 Web 應用的唯一正道。此原則在 Thymeleaf、FreeMarker、Velocity、React/Vue (SSR) 等現代模板/框架中同樣適用:View 僅負責「如何顯示」,Controller/Service 負責「顯示什麼」與「業務規則」。

copyright © 萬盛學電腦網 all rights reserved