JSP 指令元素(Directive)用於向 JSP 容器傳遞頁面層級的配置資訊,不產生直接輸出。三大指令分別為 page、include、taglib,語法統一為 <%@ 指令名 屬性="值" ... %>。
作用於整個 JSP 頁面(含靜態包含的檔案)。常用屬性 13 項:
| 屬性 | 說明 | 預設值 / 範例 |
|---|---|---|
| language | 腳本語言,目前僅支援 java | language="java" |
| extends | 生成 Servlet 繼承的父類(完整類名),慎用,可能限制容器優化 | extends="com.example.BaseServlet" |
| import | 匯入 Java 套件/類,多個用逗號分隔。JSP 隱含匯入:java.lang.*, javax.servlet.*, javax.servlet.jsp.*, javax.servlet.http.* | import="java.util.*,java.sql.*" |
| session | 是否啟用內建 session 物件 | true / false |
| buffer | 輸出緩衝區大小,none 表無緩衝 | 8kb / 16kb / none |
| autoFlush | 緩衝區滿時是否自動刷新(true)或拋出異常(false)。buffer=none 時不可為 false | true |
| isThreadSafe | 是否支援多執行緒併發。false 時容器會同步處理請求,嚴重影響效能 | true |
| info | 頁面描述資訊,可透過 Servlet.getServletInfo() 取得 | info="會員管理頁面" |
| errorPage | 發生未捕獲異常時轉向的錯誤頁面 | errorPage="/error/500.jsp" |
| isErrorPage | 宣告此頁為錯誤處理頁,可使用 exception 內建物件 | false / true |
| contentType | 回應 MIME 型別與字元編碼 | text/html;charset=UTF-8 |
| pageEncoding | JSP 檔案本身的儲存編碼(影響編譯時讀取) | UTF-8 |
| isELIgnored | 是否忽略 EL 表達式(true 表不解析) | false (JSP 2.0+) |
注意:contentType與pageEncoding建議同時設定為 UTF-8,避免中文亂碼。
在**轉譯階段**將目標檔案內容合併到當前頁面,再統一編譯為 Servlet。屬於「複製貼上」語意。
<%@ include file="相對或絕對路徑" %>
被包含檔案若含中文,建議在其頂端加入 <%@ page contentType="text/html;charset=GB2312" %>(或 UTF-8)確保編譯正確。
引入自定義標籤庫(或 JSTL),賦予前綴以便在頁面使用。
<%@ taglib uri="標籤庫URI" prefix="前綴" %>
| 屬性 | 說明 |
|---|---|
| uri | 標籤庫描述檔(TLD)的唯一識別 URI,或 TLD 檔案路徑 |
| prefix | 自訂前綴,如 c、fmt、my |
<%@ taglib uri="https://java.sun.com/jsp/jstl/core" prefix="c" %>
<c:out value="${user.name}" />
page 指令可重複出現,但同一屬性(除 import 外)只能定義一次。include 指令屬靜態包含,若需動態包含(執行期決定、保留獨立請求上下文),請使用 <jsp:include page="..." flush="true" /> 動作標籤。Tag / SimpleTag 介面並編寫 TLD,屬進階主題。