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