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編程語言而準備的占位符。