| 形式 | 語法 | 類型 | 處理階段 | 輸出結果 |
|---|---|---|---|---|
| 指令 | <%@ include file="path" %> |
指令元素 | 翻譯階段(編譯期) | 將目標檔案原始碼**靜態合併**進主頁面,產生單一 Servlet 類別 |
| 動作 | <jsp:include page="path" flush="true" /> |
動作元素 | 請求處理階段(執行期) | **動態引入**目標頁面輸出,目標頁面獨立編譯為獨立 Servlet |
file 指定的檔案。.class)。特性:
pageContext、變數作用域。<%! %>)、指令、Scriptlet。<jsp:include> 時,容器發起內部請求給目標頁面。flush="true" 強制刷新)。特性:
pageContext,區域變數隔離(但可共享 request/session/application)。<jsp:param> 動態傳參。| 場景 | 推薦 | 理由 |
|---|---|---|
| 靜態版頭/版尾/導航列 | 指令 include | 效能最佳、共享變數、編譯期檢查語法 |
| 動態生成內容、需傳參 | 動作 include | 獨立編譯、支援參數、即時生效 |
被引入頁面含 <%@ page ...%> 指令 | 動作 include | 指令 include 會導致指令衝突/重複 |
| 大型門戶、高併發首頁 | 動作 include + 快取 | 支援片段快取(ESI/Fragment Caching),局部更新 |
<!-- 指令 include:編譯期合併 -->
<%@ include file="/common/header.jsp" %>
<!-- 動作 include:執行期引入 -->
<jsp:include page="/common/header.jsp" flush="true">
<jsp:param name="title" value="首頁" />
</jsp:include>
RequestDispatcher.include() 開銷(微秒級),但模組化程度高、支援獨立快取/熱更新。jsp:include 或 Tiles/Sitemesh 佈局框架,極少用指令 include。