萬盛學電腦網

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

JSP 編譯指令 page 與 include 深度解析:屬性詳解、靜態包含陷阱與最佳實踐

JSP 指令分類

指令用途執行階段
page設定 JSP 頁面屬性 (編碼、繼承、匯入、錯誤頁等)編譯期
include靜態包含檔案內容 (編譯期合併)編譯期
taglib引入標籤庫編譯期

page 指令完整屬性參考

<%@ page
    language="java"                    <!-- 預設 java,理論支援其他腳本語言 -->
    extends="com.example.BaseServlet"  <!-- 生成 Servlet 繼承的父類 -->
    import="java.util.*,java.sql.*"    <!-- 匯入套件,可多次使用 -->
    session="true"                     <!-- 是否自動建立 HttpSession -->
    buffer="8kb"                       <!-- 輸出緩衝區大小,none 關閉 -->
    autoFlush="true"                   <!-- 緩衝區滿時自動 flush -->
    isThreadSafe="true"                <!-- 是否支援多執行緒,false 則單執行緒模型 -->
    info="版本 1.0"                    <!-- 存入 Servlet getServletInfo() -->
    errorPage="/error.jsp"             <!-- 發生未捕獲異常時轉向的錯誤頁 -->
    contentType="text/html;charset=UTF-8" <-- 回應 Content-Type -->
    isErrorPage="false"                <!-- 是否為錯誤處理頁 (可用 exception 物件) -->
    pageEncoding="UTF-8"               <-- JSP 檔案儲存編碼 (優先於 contentType charset) -->
%>

關鍵屬性深度解析

pageEncoding vs contentType charset

  • pageEncoding:決定 **JSP 原始檔以何種編碼讀取/儲存**。編譯時將原始碼按此編碼解碼為 Unicode。
  • contentType="text/html; charset=UTF-8":決定 **HTTP 回應標頭** `Content-Type: text/html; charset=UTF-8`,告訴瀏覽器以 UTF-8 解碼回應體。
  • 最佳實踐:兩者**必須一致**,且建議統一為 **UTF-8**。

errorPage / isErrorPage 配對使用

<!-- 一般頁面 -->
<%@ page errorPage="/error/500.jsp" %>

<!-- 錯誤頁面 error/500.jsp -->
<%@ page isErrorPage="true" %>
<%-- 此頁面可直接使用 exception 隱含物件 --%>
<h1>系統錯誤</h1>
<pre><%= exception.getMessage() %></pre>

buffer 與 autoFlush 交互

  • buffer="none":直接輸出,forward 前不可有輸出
  • buffer="16kb" + autoFlush="false":大頁面可減少網路交互,但 forward 前需手動 out.flush()

include 指令:靜態包含

<%@ include file="/common/header.jsp" %>

運作機制

  • **編譯期** 將目標檔案內容**原文合併**至當前 JSP,再編譯為單一 Servlet
  • 被包含檔案可包含 JSP 程式碼、指令、HTML,會被**解析執行**
  • 支援巢狀包含,理論無限制
  • 所有頁面必須使用**相同腳本語言** (預設 java)

優點

  • 將複雜頁面拆解為可獨立維護的片段 (header、footer、sidebar)
  • 修改片段即時生效,無需重新編譯主頁面 (容器偵測檔案變更)
  • 效能最佳:單一 Servlet、無額外請求轉發開銷

經典陷阱:變數名稱衝突

<!-- main.jsp -->
<%@ include file="fragment.jsp" %>
<% String path = request.getContextPath(); %>

<!-- fragment.jsp -->
<% String path = request.getContextPath(); %> <!-- 編譯錯誤:Duplicate local variable path -->

解決方案:

  1. 片段中使用獨特前綴變數名:String fragPath = ...
  2. 片段盡量**不宣告區域變數**,改用請求屬性:request.setAttribute("path", ...)
  3. 改用 **動態包含** <jsp:include page="..." /> (編譯為獨立 Servlet,變數隔離)

靜態包含 vs 動態包含 對照

特性<%@ include %> (靜態)<jsp:include /> (動態)
包含時機編譯期請求執行期
產出 Servlet單一 Servlet多個 Servlet
變數作用域共享 (易衝突)隔離
目標檔案變更主頁面重新編譯即時生效
可包含動態內容是 (合併後執行)是 (獨立執行)
效能最佳略低 (請求轉發)
傳遞參數不可 (共享 request)<jsp:param>

現代最佳實踐

  1. 佈局片段:使用 <%@ include file="/layout/header.jsp" %>,片段**不宣告區域變數**
  2. 功能模組:使用 <jsp:include page="/module/userCard.jsp"><jsp:param name="userId" value="123"/></jsp:include>
  3. 錯誤頁面:統一配置 errorPage,錯誤頁設定 isErrorPage="true"
  4. 編碼統一:全專案 pageEncoding="UTF-8" + contentType="text/html;charset=UTF-8"
  5. 避免 extends:除非框架要求,否則不要自訂 Servlet 父類,破壞容器最佳化

總結

page 指令控制頁面編譯與執行行為,核心在編碼、錯誤處理、緩衝區設定。include 指令提供編譯期靜態包含,效能最佳但需注意變數衝突。現代開發中,佈局片段用靜態包含,業務模組用動態包含或 <c:import>,配合 EL/JSTL 實現關注點分離。

copyright © 萬盛學電腦網 all rights reserved