十二、腳本元素、指令和預定義變量
2024-09-05 00:20:46
供稿：網友
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編程語言而準備的占位符。
