JSP 指令碼元素、指令和預定義變數

js|變數|指令碼  

12.1 JSP指令碼元素

　　 JSP指令碼元素用來插入Java代碼，這些Java代碼將出現在由當前JSP頁面產生的Servlet中。指令碼元素有三種格式：

運算式格式＜%= expression %＞：計算運算式並輸出其結果。
Scriptlet格式＜% code %＞：把代碼插入到Servlet的service方法。
聲明格式＜%! code %＞：把聲明加入到Servlet類（在任何方法之外）。
　　 下面我們詳細說明它們的用法。

　　 12.1.1 JSP運算式

　　 JSP運算式用來把Java資料直接插入到輸出。其文法如下：
＜%= Java Expression %＞



　　 計算Java運算式得到的結果被轉換成字串，然後插入到頁面。計算在運行時進行（頁面被請求時），因此可以訪問和請求有關的全部資訊。例如，下面的代碼顯示頁面被請求的日期/時間：
Current time: ＜%= new java.util.Date() %＞



　　 為簡化這些運算式，JSP預定義了一組可以直接使用的物件變數。後面我們將詳細介紹這些隱含聲明的對象，但對於JSP運算式來說，最重要的幾個對象及其類型如下：

request：HttpServletRequest;
response：HttpServletResponse;
session：和request關聯的HttpSession
out：PrintWriter（帶緩衝的版本，JspWriter），用來把輸出發送到用戶端
　　 下面是一個例子：
Your hostname: ＜%= request.getRemoteHost() %＞



　　 最後，如果使用XML的話，JSP運算式也可以寫成下面這種形式：
＜jsp:expression＞
Java Expression
＜/jsp:expression＞



　　 請記住XML元素和HTML不一樣。XML是大小寫敏感的，因此務必使用小寫。有關XML文法的說明，請參見《XML教程 》

　　 12.1.2 JSP Scriptlet

　　 如果你要完成的任務比插入簡單的運算式更加複雜，可以使用JSP Scriptlet。JSP Scriptlet允許你把任意的Java代碼插入Servlet。JSP Scriptlet文法如下：
＜% Java Code %＞



　　 和JSP運算式一樣，Scriptlet也可以訪問所有預定義的變數。例如，如果你要向結果頁面輸出內容，可以使用out變數：
＜%
String queryData = request.getQueryString();
out.println("Attached GET data: " + queryData);
%＞



　　 注意Scriptlet中的代碼將被照搬到Servlet內，而Scriptlet前面和後面的靜態HTML（模板文本）將被轉換成println語句。這就意味著，Scriptlet內的Java語句並非一定要是完整的，沒有關閉的塊將影響Scriptlet外的靜態HTML。例如，下面的JSP片斷混合了模板文本和Scriptlet：
＜% if (Math.random() ＜ 0.5) { %＞
Have a ＜B＞nice＜/B＞ day!
＜% } else { %＞
Have a ＜B＞lousy＜/B＞ day!
＜% } %＞



　　 上述JSP代碼將被轉換成如下Servlet代碼：
if (Math.random() ＜ 0.5) {
out.println("Have a ＜B＞nice＜/B＞ day!");
} else {
out.println("Have a ＜B＞lousy＜/B＞ day!");
}



　　 如果要在Scriptlet內部使用字元“%＞”，必須寫成“%＼＞”。另外，請注意＜% code %＞的XML等價表達是：
＜jsp:scriptlet＞
Code
＜/jsp:scriptlet＞



　　 12.1.3 JSP聲明

　　 JSP聲明用來定義插入Servlet類的方法和成員變數，其文法如下：
＜%! Java Code %＞



　　 由於聲明不會有任何輸出，因此它們往往和JSP運算式或Scriptlet結合在一起使用。例如，下面的JSP代碼片斷輸出自從伺服器啟動（或Servlet類被改動並重新裝載以來）當前頁面被請求的次數：
＜%! private int accessCount = 0; %＞
自從伺服器啟動以來頁面訪問次數為：
＜%= ++accessCount %＞



　　 和Scriptlet一樣，如果要使用字串“%＞”，必須使用“%＼＞”代替。最後，＜%! code %＞的XML等價表達方式為：
＜jsp:declaration＞
Code
＜/jsp:declaration＞



　　 12.2 JSP指令

　　 JSP指令影響Servlet類的整體結構，它的文法一般如下：
＜%@ directive attribute="value" %＞



　　 另外，也可以把同一指令的多個屬性結合起來，例如：
＜%@ directive attribute1="value1"
attribute2="value2"
...
attributeN="valueN" %＞



　　 JSP指令分為兩種類型：第一是page指令，用來完成下面這類任務：匯入指定的類，自訂Servlet的超類，等等；第二是include指令，用來在JSP檔案轉換成Servlet時引入其他檔案。JSP規範也提到了taglib指令，其目的是讓JSP開發人員能夠自己定義標記，但JSP 1.0不支援該指令，有希望它將成為JSP 1.1的主要改進之一。

　　 12.2.1 page指令

　　 page指令的作用是定義下面一個或多個屬性，這些屬性大小寫敏感。



import="package.class"，或者import="package.class1,...,package.classN"：

用於指定匯入哪些包，例如：＜%@ page import="java.util.*" %＞。import是唯一允許出現一次以上的屬性。


contentType="MIME-Type" 或contentType="MIME-Type; charset=Character-Set"：

該屬性指定輸出的MIME類型。預設是text/html。例如，下面這個指令：
＜%@ page contentType="text/plain" %＞。
和下面的Scriptlet效果相同：
＜% response.setContentType("text/plain"); %＞


isThreadSafe="true|false"

預設值true表明Servlet按照標準的方式處理，即假定開發人員已經同步對執行個體變數的訪問，由單個Servlet執行個體同時地處理多個請求。如果取值false，表明Servlet應該實現SingleThreadModel，請求或者是逐個進入，或者多個並行的請求分別由不同的Servlet執行個體處理。


session="true|false"

預設值true表明預定義變數session（類型為HttpSession）應該綁定到已有的會話，如果不存在已有的會話，則建立一個並綁定session變數。如果取值false，表明不會用到會話，試圖訪問變數session將導致JSP轉換成Servlet時出錯。


buffer="size kb|none"

該屬性指定JspWrite out的緩衝大小。預設值和伺服器有關，但至少應該是8 KB。


autoflush="true|false"

預設值true表明如果緩衝已滿則重新整理它。autoflush很少取false值，false值表示如果緩衝已滿則拋出異常。如果buffer="none"，autoflush不能取false值。


extends="package.class"

該屬性指出將要產生的Servlet使用哪個超類。使用該屬性應當十分小心，因為伺服器可能已經在用自訂的超類。


info="message"

該屬性定義一個可以通過getServletInfo方法提取的字串。


errorPage="url"

該屬性指定一個JSP頁面，所有未被當前頁面捕獲的異常均由該頁面處理。


isErrorPage="true|false"

該屬性指示當前頁面是否可以作為另一JSP頁面的錯誤處理頁面。預設值false。


language="java"

該屬性用來指示所使用的語言。目前沒有必要關注這個屬性，因為預設的Java是當前唯一可用的語言。
　　 定義指令的XML文法為：
＜jsp:directive.directiveType attribute=value /＞



　　 例如，下面這個指令：
＜%@ page import="java.util.*" %＞



　　 它的XML等價表達是：
＜jsp:directive.page import="java.util.*" /＞



　　 12.2.2 include指令

　　 include指令用於JSP頁面轉換成Servlet時引入其他檔案。該指令文法如下：
＜%@ include file="relative url" %＞



　　 這裡所指定的URL是和發出引用指令的JSP頁面相對的URL，然而，與通常意義上的相對URL一樣，你可以利用以“/”開始的URL告訴系統把URL視為從Web伺服器根目錄開始。包含檔案的內容也是JSP代碼，即包含檔案可以包含靜態HTML、指令碼元素、JSP指令和動作。

　　 例如，許多網站的每個頁面都有一個小小的導航條。由於HTML架構存在不少問題，導航條往往用頁面頂端或左邊的一個表格製作，同一份HTML代碼重複出現在整個網站的每個頁面上。include指令是實現該功能的非常理想的方法。使用include指令，開發人員不必再把導航HTML代碼拷貝到每個檔案中，從而可以更輕鬆地完成維護工作。

　　 由於include指令是在JSP轉換成Servlet的時候引入檔案，因此如果導航條改變了，所有使用該導航條的JSP頁面都必須重新轉換成Servlet。如果導航條改動不頻繁，而且你希望包含操作具有儘可能好的效率，使用include指令是最好的選擇。然而，如果導航條改動非常頻繁，你可以使用jsp:include動作。jsp:include動作在出現對JSP頁面請求的時候才會引用指定的檔案，請參見本文後面的具體說明。

　　 12.3 執行個體：指令碼元素和指令的應用

　　 下面是一個使用JSP運算式、Scriptlet、聲明、指令的簡單例子。
＜!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"＞
＜HTML＞
＜HEAD＞
＜TITLE＞JavaServer Pages＜/TITLE＞
＜/HEAD＞

＜BODY BGCOLOR="#FDF5E6" TEXT="#000000" LINK="#0000EE"
VLINK="#551A8B" ALINK="#FF0000"＞
＜CENTER＞
＜TABLE BORDER=5 BGCOLOR="#EF8429"＞
＜TR＞＜TH CLASS="TITLE"＞
JSP應用執行個體＜/TABLE＞
＜/CENTER＞
＜P＞
下面是一些利用各種JSP功能產生的動態內容:
＜UL＞
＜LI＞＜B＞運算式.＜/B＞＜BR＞
你的主機名稱: ＜%= request.getRemoteHost() %＞.
＜LI＞＜B＞JSP Scriptlet.＜/B＞＜BR＞
＜% out.println("查詢字串: " +
request.getQueryString()); %＞
＜LI＞＜B＞聲明（和運算式）.＜/B＞＜BR＞
＜%! private int accessCount = 0; %＞
伺服器啟動以來訪問次數: ＜%= ++accessCount %＞
＜LI＞＜B＞指令（和運算式）.＜/B＞＜BR＞
＜%@ page import = "java.util.*" %＞
當前日期: ＜%= new Date() %＞
＜/UL＞

＜/BODY＞
＜/HTML＞



　　 12.4 JSP預定義變數

　　 為了簡化JSP運算式和Scriptlet的代碼，JSP提供了8個預先定義的變數（或稱為隱含對象）。這些變數是request、response、out、session、application、config、pageContext和page。

　　 12.4.1 request

　　 這是和請求關聯的HttpServletRequest，通過它可以查看請求參數（調用getParameter），請求類型（GET，POST，HEAD，等），以及請求的HTTP頭（Cookie，Referer，等）。嚴格說來，如果請求所用的是HTTP之外的其他協議，request可以是ServletRequest的子類（而不是HttpServletRequest），但在實踐中幾乎不會用到。

　　 12.4.2 response

　　 這是和應答關聯的HttpServletResponse。注意，由於輸出資料流（參見下面的out）是帶緩衝的，因此，如果已經向用戶端發送了輸出內容，普通Servlet不允許再設定HTTP狀態碼，但在JSP中卻是合法的。

　　 12.4.3 out

　　 這是用來向用戶端發送內容的PrintWriter。然而，為了讓response對象更為實用，out是帶緩衝功能的PrintWriter，即JspWriter。JSP允許通過page指令的buffer屬性調整緩衝的大小，甚至允許關閉緩衝。

　　 out一般只在Scriptlet內使用，這是因為JSP運算式是自動發送到輸出資料流的，很少需要顯式地引用out。

　　 12.4.4 session

　　 這是和請求關聯的HttpSession對象。前面我們已經介紹過會話的自動建立，我們知道，即使不存在session引用，這個對象也是自動綁定的。但有一個例外，這就是如果你用page指令的session屬性關閉了會話，此時對session變數的引用將導致JSP頁面轉換成Servlet時出錯。

　　 12.4.5 application

　　 這是一個ServletContext，也可以通過getServletConfig().getContext()獲得。

　　 12.4.6 config

　　 這是當前頁面的ServletConfig對象。

　　 12.4.7 pageContext

　　 主要用來管理頁面的屬性。

　　 12.4.8 page

　　 它是this的同義字，當前用處不大。它是為了Java不再是唯一的JSP程式設計語言而準備的預留位置。