您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> J2EE

JSP Include 機制完整指南：靜態包含 vs 動態包含、SSI 對比與最佳實踐

編輯：J2EE

頁面佈局復用的演進：框架 → SSI → JSP Include

框架：瀏覽器渲染差異、外部連結嵌套混亂、SEO 不友善，已棄用。
SSI (Server Side Include)：，需特定副檔名 .shtml、伺服器配置、動態內容支援有限、與 JSP 難共存。
JSP Include：原生支援、無額外配置、靜態/動態雙模式、與 JSP 生態無縫整合。

JSP 兩種包含機制核心差異

機制	語法	處理階段	適用場景	效能
靜態包含 (Include Directive)	`<%@ include file="header.jsp" %>`	編譯期（JSP → Servlet 時）	極少變更的靜態片段：Header、Footer、導航欄、CSS/JS 引用	最快，合併為單一 Servlet，零運行期開銷
動態包含 (Include Action)	`<jsp:include page="fragment.jsp" flush="true" />`	請求期（每次請求執行）	頻繁變更、帶邏輯的動態片段：側邊欄、推薦列表、用戶面板	略低，獨立編譯執行，支援參數傳遞

靜態包含實戰：統一版面結構

<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<html>
<head>
    <title>網站標題</title>
    <%@ include file="/common/head.jsp" %> <!-- CSS、JS、Meta -->
</head>
<body>
    <%@ include file="/common/header.jsp" %>  <!-- Logo、導航 -->
    <%@ include file="/common/nav.jsp" %>     <!-- 側邊選單 -->
    
    <div id="content">
        <!-- 主內容區，各頁面不同 -->
    </div>
    
    <%@ include file="/common/footer.jsp" %>  <!-- 版權、連結 -->
</body></html>

關鍵點： 被包含檔案無需完整 HTML 結構，僅含片段標記。編譯後生成單一巨大 Servlet，執行效能最高。

動態包含實戰：參數傳遞與條件載入

<jsp:include page="/widgets/userPanel.jsp" flush="true">
    <jsp:param name="userId" value="${param.id}" />
    <jsp:param name="showDetail" value="true" />
</jsp:include>

<c:choose>
    <c:when test="${user.role == 'admin'}">
        <jsp:include page="/widgets/adminConsole.jsp" flush="true" />
    </c:when>
    <c:otherwise>
        <jsp:include page="/widgets/userDashboard.jsp" flush="true" />
    </c:otherwise>
</c:choose>

flush="true"：包含前刷新輸出緩衝，確保順序正確。
jsp:param：向被包含頁面傳遞額外參數，請求參數自動合併。
可搭配 JSTL <c:if>/<c:choose> 條件式包含。

動態內容快取陷阱與解決方案

問題： 靜態包含指令會將被包含檔案內容在編譯期「內聯」至主頁面。若被包含檔案為動態內容（如資料庫查詢結果），主頁面重新編譯前不會反映最新資料。

驗證： 修改 included.html 內容，重新整理主頁面，發現未更新。

解決方案：

改用動態包含 <jsp:include>：每次請求重新執行被包含頁面。
手動觸發重新編譯：修改主頁面（加空白行）儲存，強制容器重新編譯。
開發階段開啟 reloadable="true"：Tomcat 自動偵測檔案變更重載（生產環境必須關閉）。

進階技巧：片段化與邊緣快取

片段化：將頁面拆解為「靜態骨架 + 動態島嶼」。靜態骨架用指令包含，動態島嶼用動作包含或 AJAX 載入。
邊緣快取 (ESI / CDN)：Nginx/Varnish/Cloudflare 支援 <esi:include src="/fragment" />，在邊緣節點組裝頁面，動態片段獨立快取策略。
Fragment Caching：<%@ taglib prefix="cache" uri="..." %><cache:cache key="sidebar" timeout="300">...</cache:cache> 區塊級快取。