萬盛學電腦網

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

JSP include 指令與 include 動作的差異詳解

兩種 Include 形式

形式語法類型處理階段輸出結果
指令 <%@ include file="path" %> 指令元素 翻譯階段(編譯期) 將目標檔案原始碼**靜態合併**進主頁面,產生單一 Servlet 類別
動作 <jsp:include page="path" flush="true" /> 動作元素 請求處理階段(執行期) **動態引入**目標頁面輸出,目標頁面獨立編譯為獨立 Servlet

深度解析:翻譯階段 vs 請求階段

翻譯階段(指令 include)

  1. JSP 容器讀取主頁面與 file 指定的檔案。
  2. 將兩者原始碼**文字合併**成單一完整 JSP 內容。
  3. 對合併後的內容進行一次編譯,產生**一個** Servlet 類別(單一 .class)。
  4. 執行時直接運行該 Servlet,無額外請求轉發開銷。

特性:

  • 合併後共享同一個 pageContext、變數作用域。
  • 被引入檔案可包含 JSP 宣告(<%! %>)、指令、Scriptlet。
  • 檔案變更需重新編譯主頁面才生效(或依賴容器重載機制)。
  • 適用於靜態片段:頁首、頁尾、版權聲明、通用 CSS/JS 引用。

請求階段(動作 include)

  1. 主頁面 Servlet 執行至 <jsp:include> 時,容器發起內部請求給目標頁面。
  2. 目標頁面**獨立編譯、獨立執行**,產生自己的輸出流。
  3. 輸出流寫入主頁面回應中(flush="true" 強制刷新)。
  4. 主頁面繼續執行後續內容。

特性:

  • 目標頁面有獨立的 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>

效能考量

  • 指令 include:單一 Servlet,無額外請求開銷,但類別體積大、重新編譯影響範圍廣。
  • 動作 include:額外 RequestDispatcher.include() 開銷(微秒級),但模組化程度高、支援獨立快取/熱更新。
  • 現代框架(Spring MVC、Struts2)多使用 jsp:include 或 Tiles/Sitemesh 佈局框架,極少用指令 include。
copyright © 萬盛學電腦網 all rights reserved