JSP page指令 - tw511教學網

JSP中的page指令用於向容器提供與當前JSP頁面相關的指令。可以在JSP頁面的任何位置使用page指令進行編碼。按照慣例，page指令被編碼在JSP頁面的頂部。

以下是page指令的基本語法 -

<%@ page attribute = "value" %>

可以使用XML編寫上述語法，如下所示：

<jsp:directive.page attribute = "value" />

屬性

下表列出了與page指令相關聯的屬性 -

序號	屬性	說明
1	`buffer`	指定輸出流的緩衝模型。
2	`autoFlush`	控制servlet輸出緩衝區的行為。
3	`contentType`	定義字元編碼方案。
4	`errorPage`	定義另一個報告Java未檢查執行時異常的JSP的URL。
5	`isErrorPage`	指示此JSP頁面是否是由另一個JSP頁面的`errorPage`屬性指定的URL。
6	`extends`	指定生成的servlet必須擴充套件的超類。
7	`import`	指定JSP中使用的包或類的列表，就像Java的`import`語句一樣。
8	`info`	定義可以使用servlet的`getServletInfo()`方法存取的字串。
9	`isThreadSafe`	定義生成的servlet的執行緒模型。
10	`language`	定義JSP頁面中使用的程式設計語言。
11	`session`	指定JSP頁面是否參與HTTP對談
12	`isELIgnored`	指定JSP頁面中的EL表示式是否被忽略。
13	`isScriptingEnabled`	確定指令碼元素是否被允許使用。

1. buffer屬性

buffer屬性指定伺服器輸出響應物件的緩衝特性。

可以編寫指一個none值來指定不使用緩衝，以便servlet輸出立即被定向到響應物件，或者可以編寫一個以KB為單位的最大緩衝區大小，這將指示servlet在寫入響應之前寫入緩衝區。

如要指示servlet將輸出直接寫入響應輸出物件，請使用以下命令 -

<%@ page buffer = "none" %>

使用以下命令來指示servlet將輸出寫入大小不小於64KB位元組的緩衝區 -

<%@ page buffer = "64kb" %>

2. autoFlush屬性

autoFlush屬性指定緩衝區輸出是否在緩衝區填充時自動重新整理，或者是否引發異常以指示緩衝區溢位。

true(預設值)值表示自動緩衝區重新整理，false值表示引發異常。

當servlet的輸出緩衝區已滿時，以下指令會導致servlet丟擲異常，則使用以下語句 -

<%@ page autoFlush = "false" %>

此指令使servlet在完全輸出時重新整理輸出緩衝區，

<%@ page autoFlush = "true" %>

通常，buffer和autoFlush屬性在page指令中進行編碼，如下所示：

<%@ page buffer = "16kb" autoflush = "true" %>

3. contentType屬性

contentType屬性設定JSP頁面和生成的響應頁面的字元編碼。預設內容型別為：text/html，它是HTML頁面的標準內容型別。

如果要從JSP輸出為XML，請使用以下page指令 -

<%@ page contentType = "text/xml" %>

以下語句指示向瀏覽器生成的頁面呈現為HTML -

<%@ page contentType = "text/html" %>

以下指令將內容型別設定為：Microsoft Word文件 -

<%@ page contentType = "application/msword" %>

還可以指定響應的字元編碼。例如，如果要指定返回瀏覽器的結果頁面使用：UTF-8，則可以使用以下page指令 -

<%@ page contentType = "text/html:charset=UTF-8" %>

4. errorPage屬性

如果希望在當前頁面執行時出現錯誤時，指定一個錯誤提示頁面，那麼errorPage屬性告訴JSP引擎顯示哪個頁面。errorPage屬性的值是相對URL。

當丟擲所有未捕獲的異常時，以下指令用於在頁面出錯時指定顯示MyErrorPage.jsp的內容 -

<%@ page errorPage = "MyErrorPage.jsp" %>

5. isErrorPage屬性

isErrorPage屬性表示當前的JSP頁面可以用作另一個JSP的錯誤頁面。

isErrorPage的值可為true或false。 isErrorPage屬性的預設值為false。

例如，handleError.jsp將isErrorPage選項設定為true，因為它應該處理錯誤 -

<%@ page isErrorPage = "true" %>

6. extends屬性

extends屬性指定生成的servlet必須擴充套件的超類。

例如，以下指令指示JSP轉換器生成servlet，以使servlet擴充套件somePackage.SomeClass -

<%@ page extends = "somePackage.SomeClass" %>

7. import屬性

import屬性與Java import語句具有相同的功能，並且類似於Java import語句。import選項的值是要匯入的程式包的名稱。

例如，要匯入java.sql.*，請使用以下page指令 -

<%@ page import = "java.sql.*" %>

要匯入多個包，可以使用逗號分隔，如下所示：

<%@ page import = "java.sql.*,java.util.*"  %>

預設情況下，容器會自動匯入java.lang.*，javax.servlet.*，javax.servlet.jsp.*和javax.servlet.http.*。

8. info屬性

info屬性允許提供JSP的描述。以下是一個程式碼範例 -

<%@ page info = "This JSP Page Written By Maxsu"  %>

9. isThreadSafe屬性

isThreadSafe選項將頁面標記為執行緒安全。預設情況下，所有JSP都被認為是執行緒安全的。如果將isThreadSafe選項設定為false，則JSP引擎確保一次只有一個執行緒正在執行JSP。

以下page指令將isThreadSafe選項的值設定為false -

<%@ page isThreadSafe = "false"  %>

10. language屬性

language屬性指示在JSP頁面指令碼編寫中使用的程式設計語言。

例如，由於通常我們使用Java作為指令碼語言，因此language選項可設定成如下：

<%@ page language = "java" %>

11. session屬性

session屬性指示JSP頁面是否使用HTTP對談。如果設定值為true，則表示JSP頁面可以存取內建session物件，設定值為false表示JSP頁面無法存取內建session物件。

以下指令允許JSP頁面使用任何內建session物件方法，如：session.getCreationTime()或session.getLastAccessTime() -

<%@ page session = "true" %>

12. isELIgnored屬性

isELIgnored屬效能夠禁用JSP 2.0中引入的表示式語言(EL)表示式的求值計算。

isELIgnored屬性的預設值為true，這意味著表示式${...}按JSP規範進行評估計算。如果屬性設定為false，則不會對表示式進行評估求值，而將其視為靜態文字內容。

以下指令設定表示式不會被評估計算 -

<%@ page isELIgnored = "false" %>

13. isScriptingEnabled屬性

isScriptingEnabled屬性確定指令碼元素是否被允許使用。

isScriptingEnabled屬性預設值為true，它表示啟用指令碼，表示式和宣告。如果屬性的值設定為false，則如果JSP使用任何指令碼，表示式(非EL)或宣告，則會引發轉換時錯誤。

如果要限制指令碼，表示式(非EL)或宣告的使用，可將isScriptingEnabled屬性的值可以設定為false -

<%@ page isScriptingEnabled = "false" %>