萬盛學電腦網

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

JSP 指令元素完整筆記:page、include、taglib 三大指令詳解

概述

JSP 指令元素(Directive)用於向 JSP 容器傳遞頁面層級的配置資訊,不產生直接輸出。三大指令分別為 page、include、taglib,語法統一為 <%@ 指令名 屬性="值" ... %>。

一、page 指令:頁面全域屬性配置

作用於整個 JSP 頁面(含靜態包含的檔案)。常用屬性 13 項:

屬性說明預設值 / 範例
language腳本語言,目前僅支援 javalanguage="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 時不可為 falsetrue
isThreadSafe是否支援多執行緒併發。false 時容器會同步處理請求,嚴重影響效能true
info頁面描述資訊,可透過 Servlet.getServletInfo() 取得info="會員管理頁面"
errorPage發生未捕獲異常時轉向的錯誤頁面errorPage="/error/500.jsp"
isErrorPage宣告此頁為錯誤處理頁,可使用 exception 內建物件false / true
contentType回應 MIME 型別與字元編碼text/html;charset=UTF-8
pageEncodingJSP 檔案本身的儲存編碼(影響編譯時讀取)UTF-8
isELIgnored是否忽略 EL 表達式(true 表不解析)false (JSP 2.0+)
注意:contentType 與 pageEncoding 建議同時設定為 UTF-8,避免中文亂碼。

二、include 指令:靜態包含

在**轉譯階段**將目標檔案內容合併到當前頁面,再統一編譯為 Servlet。屬於「複製貼上」語意。

<%@ include file="相對或絕對路徑" %>

適用場景

  • 包含靜態頁首/頁尾(HTML 片段)
  • 包含通用的變數宣告、工具方法(需注意變數衝突)
  • 被包含檔案可為 .txt、.html、.jsp 等

編碼提示

被包含檔案若含中文,建議在其頂端加入 <%@ page contentType="text/html;charset=GB2312" %>(或 UTF-8)確保編譯正確。

三、taglib 指令:標籤庫宣告

引入自定義標籤庫(或 JSTL),賦予前綴以便在頁面使用。

<%@ taglib uri="標籤庫URI" prefix="前綴" %>
屬性說明
uri標籤庫描述檔(TLD)的唯一識別 URI,或 TLD 檔案路徑
prefix自訂前綴,如 c、fmt、my

範例:JSTL 核心庫

<%@ 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,屬進階主題。
copyright © 萬盛學電腦網 all rights reserved