JSP 編譯指令 page 與 include 完整詳解

JSP 指令分類

1. page：設定頁面屬性。
2. include：靜態包含檔案。
3. taglib：引入標籤庫。

語法：<%@ 指令名 屬性="值" ... %>

page 指令完整屬性表

<%@ page
    language="java"
    extends="package.Class"
    import="package.Class|package.*,..."
    session="true|false"
    buffer="none|8kb|size kb"
    autoFlush="true|false"
    isThreadSafe="true|false"
    info="text"
    errorPage="relativeURL"
    contentType="mimeType;charset=characterSet"
    isErrorPage="true|false"
%>

• 預設自動匯入：java.lang.*, javax.servlet.*, javax.servlet.jsp.*, javax.servlet.http.*。
• errorPage 指定錯誤處理頁；isErrorPage="true" 宣告本頁為錯誤頁（可用 exception 隱含物件）。
• 通常置於頁面最頂端，可多個 page 指令合併屬性。

include 指令

<%@ include file="relativeURL" %>

• 編譯期 靜態包含，被包含檔案內容會被 JSP 解析。
• 可多次使用、可巢狀嵌套（理論無限層）。
• 所有包含檔案必須使用相同腳本語言。
• 優點：將複雜頁面拆分為獨立片段，便於維護與復用；修改僅需調整單一包含檔。

常見錯誤與解決

錯誤：Duplicate local variable path / Duplicate local variable basePath

原因：主頁與被包含頁面都宣告了同名變數 path、basePath。

解決：

1. 修改被包含頁面變數名稱（如 path2、basePath2）。
2. 或移除被包含頁面的重複宣告，直接使用主頁變數。

動態包含對比

<jsp:include page="..." /> 為執行期動態包含，適用於內容頻繁變動或需傳遞參數的場景，但效能略低於編譯期靜態包含。