JSP指令元素簡介
來源:互聯網
上載者:User
js 指令元素(Directives Elements)
指令主要用來提供整個JSP網頁相關的資訊,並且用來設定JSP頁面的相關屬性。
一、page指令
功能:設定整個JSP網頁的屬性和相關功能。
文法:<%@ page attribute1="value1" attribute2="value2" %>
標籤元素:
page指令元素的屬性
language="language" 指定JSP Container要用什麼語言來編譯JSP網頁。目前只可以使用Java語言,不過不排除增加其它語言。預設值為Java。
extends="className" 定義此JSP頁面產生的Servlet是繼承自哪個父類。必須為實現HttpJspPage介面的類。JSP規範對不完全理解其隱意的情況下使用此屬性提出警告。
import="importList" 定義此JSP頁面可以使用哪些Java API。用逗號分隔列出一個或多個全質類名。此列表用於在產生的java servlet中建立相應的匯入語句。以下包是自動包含的,不必被指出:java.lang.*;java.servlet.*;java.servlet.jsp.*;java.servlet.htt.*
session="true|false" 指明JSP頁面是否需要一個HTTP會話,如果為true,那麼產生的servlet將包含建立一個HTTP會話(或訪問一個HTTP會話)的代碼,預設為true。
buffer="none|size in kb" 指定輸出資料流緩衝的大小。有效值是nkb或沒有。預設為8kb。
authflush="true|false: 決定輸出資料流的緩衝區是否要自動清除。當值為true時緩衝滿時將被自動重新整理,當值為false時,緩衝區滿會拋出溢出異常。預設值為true。
isThreadSafe="true" 此JSP頁面能處理來自多個線程的同步請求,此值為true,否則為false,產生的servlet表明它實現了SingleThreadMode介面。SingleThreadMode已經聲明不贊成使用(deprecate)
info="text" 表示此JSP頁面的相關資訊,由getServletInfo()方法返回的。
isErrorPage="true|false" 如果此頁面被用作處理異常錯誤的頁面,則為true。在這種情況下,頁面可被指定為另一頁面page指令元素中errorPage屬性的取值。指定此屬性為true將使exception隱含變數對此頁面可用。預設值為false。
errorPage="error_url" 表示如果發生異常錯誤,網頁會被重新指向一個URL頁面。錯誤頁面必須在其page指令元素中指定isErrorPage="true"
contentType="ctinfo" 表示將在產生servlet中使用的MIME類型和可選字元解碼。
pageEncoding="ctinfo" 表示JSP頁面的編碼方式。
isELIgnored="true|false" 表示是否在此JSP網頁中執行或忽略EL運算式。如果為true時JSP Container將忽略EL運算式。
二、include指令
功能:在JSP編譯時間插入包含一個檔案。包含的過程是靜態,包含的檔案可以是JSP、HTML、文本或是Java程式。
文法:<%@ include file="relativeURLspec" %>
標籤元素:
注意:include指令元素和行為元素主要有兩個方面的不同點。
1.include指令是靜態包含,執行時間是在編譯階段執行,引入的內容為靜態文要,在編譯成servlet時就和包含者融合到一起。所以file不能是一個變數,也不能在file後接任何參數。
2.include行為是動態包含,執行時間是在要求階段執行,引入的內容在執行頁面時被請求時動態產生再包含到頁面中。
三、taglib指令
功能:使用標籤庫定義新的自訂標籤,在JSP頁面中啟用定製行為。
文法:<%@ taglib uri="tabLibraryURI" prefix"tagPrefix" %>
標籤元素:
page指令元素的屬性
uri="tagLibraryURI" 標籤庫描述器的URI,主要是說是tagLibrary的存放位置。
prefix="tagPrefix" 用於標識在頁面後面部分使用定製標籤的唯一首碼。