在客戶端顯示一個注釋.
JSP 語法
<!-- comment [ <%= expression %> ] -->
例子 1
<!-- This file displays the user login screen -->
在客戶端的HTML源代碼中產生和上面一樣的數據:
<!-- This file displays the user login screen -->
例子 2
<!-- This page was loaded on <%= (new java.util.Date()).toLocaleString() %> -->
在客戶端的HTML源代碼中顯示為:
<!-- This page was loaded on January 1, 2000 -->
描述
這種注釋和HTML中很像,也就是它可以在"查看源代碼"中看到。
唯一有些不同的就是,你可以在這個注釋中用表達式(例子2所示)。這個表達示是不定的,由頁面不同而不同,你能夠使用各種表達式,只要是合法的就行。
寫在JSP程序中,但不是發給客戶。
JSP 語法
<%-- comment --%>
例子:
<%@ page language="java" %>
<html>
<head><title>A Comment Test</title></head>
<body>
<h2>A Test of Comments</h2>
<%-- This comment will not be visible in the page source --%>
</body>
</html>
描述
用隱藏注釋標記的字符會在JSP編譯時被忽略掉。這個注釋在你希望隱藏或注釋你的JSP程序時是很有用的。
JSP編譯器不是會對<%--and--%>之間的語句進行編譯的,它不會顯示在客戶的瀏覽器中,也不會在源代碼中看到在<%-- --%>之間,你可以任意寫注釋語句,但是不能使用 "--%>",如果你非要使用請用"--%\>".
在JSP程序中聲明合法的變量和方法
JSP 語法
<%! declaration; [ declaration; ]+ ... %>
例子
<%! int i = 0; %>
<%! int a, b, c; %>
<%! Circle a = new Circle(2.0); %>
描述
聲明你將要在JSP程序中用到的變量和方法。你也必須這樣做,不然會出錯.
你可以一次性聲明多個變量和方法,只要以";"結尾就行,當然這些聲明在Java中要是合法的。
當你聲明方法或變量時,請注意以下的一些規則:
聲明必須以";"結尾(Scriptlet有同樣的規則,但是 表達式就不同了).
你可以直接使用在<% @ page %>中被包含進來的已經聲明的變量和方法,不需要對它們重新進行聲明.
一個聲明僅在一個頁面中有效。如果你想每個頁面都用到一些聲明,最好把它們寫成一個單獨的文件,然后用<%@ include %>或<jsp:include >元素包含進來。
包含一個符合JSP語法的表達式
JSP 語法
<%= expression %>
例子
<font color="blue"><%= map.size() %></font>
<b><%= numguess.getHint() %></b>.
描述
表達式元素表示的是一個在腳本語言中被定義的表達式,在運行后被自動轉化為字符串,然后插入到這個表達示在JSP文件的位置顯示。因為這個表達式的值已經被轉化為字符串,所以你能在一行文本中插入這個表達式(形式和ASP完全一樣).
當你在JSP中使用表達式時請記住以下幾點:
你不能用一個分號(";")來作為表達式的結束符.但是同樣的表達式用在scriptlet中就需要以分號來結尾了!查看Scriptlet 這個表達式元素能夠包括任何在Java Language Specification中有效的表達式.
有時候表達式也能做為其它JSP元素的屬性值.一個表達式能夠變得很復雜,它可能由一個或多個表達式組成,這些表達式的順序是從左到右。
包含一個有效的程序段.
JSP 語法
<% code fragment %>
例子
<%
String name = null;
if (request.getParameter("name") == null) {
%>
<%@ include file="error.html" %>
<%
} else {
foo.setName(request.getParameter("name"));
if (foo.getName().equalsIgnoreCase("integra"))
name = "acura";
if (name.equalsIgnoreCase( "acura" )) {
%>
描述
一個scriptlet能夠包含多個jsp語句,方法,變量,表達式
因為scriptlet,我們便能做以下的事:
聲明將要用到的變量或方法(參考 聲明).
編寫JSP表達式(參考 表達式).
使用任何隱含的對象和任何用<jsp:useBean>聲明過的對象
編寫JSP語句 (如果你在使用Java語言,這些語句必須遵從Java Language Specification,).
任何文本,HTML標記,JSP元素必須在scriptlet之外
當JSP收到客戶的請求時,scriptlet就會被執行,如果scriptlet有顯示的內容,這些顯示的內容就被存在out對象中。
定義JSP文件中的全局屬性.
JSP 語法
<%@ page
[ language="java" ]
[ extends="package.class" ]
[ import="{package.class | package.*}, ..." ]
[ session="true | false" ]
[ buffer="none | 8kb | sizekb" ]
[ autoFlush="true | false" ]
[ isThreadSafe="true | false" ]
[ info="text" ]
[ errorPage="relativeURL" ]
[ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ]
[ isErrorPage="true | false" ]
%>
例子
<%@ page import="java.util.*, java.lang.*" %>
<%@ page buffer="5kb" autoFlush="false" %>
<%@ page errorPage="error.jsp" %>
描述
<%@ page %>指令作用于整個JSP頁面,同樣包括靜態的包含文件。但是<% @ page %>指令不能作用于動態的包含文件,比如 <jsp:include>
你可以在一個頁面中用上多個<% @ page %>指令,但是其中的屬性只能用一次,不過也有個例外,那就是import屬性。因為import屬性和Java中的import語句差不多(參照Java Language),所以你就能多用此屬性幾次了.
無論你把<% @ page %>指令放在JSP的文件的哪個地方,它的作用范圍都是整個JSP頁面。不過,為了JSP程序的可讀性,以及好的編程習慣,最好還是把它放在JSP文件的頂部.
定義一個標簽庫以及其自定義標簽的前綴.
JSP 語法
<%@ taglib uri="URIToTagLibrary" prefix="tagPrefix" %>
例子
<%@ taglib uri="http://www.jspcentral.com/tags" prefix="public" %>
<public:loop>
.
.
</public:loop>
描述
<% @ taglib %>指令聲明此JSP文件使用了自定義的標簽,同時引用標簽庫,也指定了他們的標簽的前綴。
這里自定義的標簽含有標簽和元素之分。因為JSP文件能夠轉化為XML,所以了解標簽和元素之間的聯系很重要。標簽只不過是一個在意義上被抬高了點的標記,是JSP元素的一部分。JSP元素是JSP語法的一部分,和XML一樣有開始標記和結束標記。元素也可以包含其它的文本,標記,元素。比如,一個jsp:plugin元素有<jsp:plugin>開始標記和</jsp:plugin>結束標記,同樣也可以有<jsp:params>和<jsp:fallback>元素.
你必須在使用自定義標簽之前使用<% @ taglib %>指令,而且你可以在一個頁面中多次使用,但是前綴只能使用一次
屬性
uri="URIToTagLibrary"
Uniform Resource Identifier (URI)根據標簽的前綴對自定義的標簽進行唯一的命名,URI可以是以下的內容:
Uniform Resource Locator (URL), 由 RFC 2396 定義, 查看 http://www.hut.fi/u/jkorpela/rfc/2396/full.html
Uniform Resource Name (URN), 由 RFC 2396定義
一個相對或絕對的路徑
prefix="tagPrefix"
在自定義標簽之前的前綴,比如,在<public:loop>中的public,如果這里不寫public,那么這就是不合法的。請不要用jsp, jspx, java, javax, servlet, sun, 和sunw做為你的前綴
重定向一個HTML文件,JSP文件,或者是一個程序段.
JSP語法
<jsp:forwardpage={"relativeURL"|"<%=expression%>"}/>
or
<jsp:forwardpage={"relativeURL"|"<%=expression%>"}>
<jsp:paramname="parameterName"
value="{parameterValue|<%=expression%>}"/>+
</jsp:forward>
例子<jsp:forwardpage="/servlet/login"/>
<jsp:forwardpage="/servlet/login">
<jsp:paramname="username"value="jsmith"/>
</jsp:forward>
描述
<jsp:forward>標簽從一個JSP文件向另一個文件傳遞一個包含用戶請求的request對象.<jsp:forward>標簽以下的代碼,將不能執行.
你能夠向目標文件傳送參數和值,在這個例子中我們傳遞的參數名為username,值為scott,如果你使用了<jsp:param>標簽的話,目標文件必須是一個動態的文件,能夠處理參數.
如果你使用了非緩沖輸出的話,那么使用<jsp:forward>時就要小心。如果在你使用<jsp:forward>之前,jsp文件已經有了數據,那么文件執行就會出錯.
屬性
page="{relativeURL|<%=expression%>}"
這里是一個表達式或是一個字符串用于說明你將要定向的文件或URL.這個文件可以是JSP,程序段,或者其它能夠處理request對象的文件(如asp,cgi,php).
<jsp:paramname="parameterName"value="{parameterValue|<%=expression%>}"/>+
向一個動態文件發送一個或多個參數,這個文件一定是動態文件.
如果你想傳遞多個參數,你可以在一個JSP文件中使用多個<jsp:param>。name指定參數名,value指定參數值.
獲取Bean的屬性值,用于顯示在頁面中
JSP 語法
<jsp:getProperty name="beanInstanceName" property="propertyName" />
例子
<jsp:useBean id="calendar" scope="page" class="employee.Calendar" />
<h2>
Calendar of <jsp:getProperty name="calendar" property="username" />
</h2>
描述
這個<jsp:getProperty>元素將獲得Bean的屬性值,并可以將其使用或顯示在JSP頁面中.在你使用<jsp:getProperty>之前,你必須用<jsp:useBean>創建它.
<jsp:getProperty>元素有一些限制:
你不能使用<jsp:getProperty>來檢索一個已經被索引了的屬性
你能夠和JavaBeans組件一起使用<jsp:getProperty>,但是不能與Enterprise
Bean一起使用。
屬性
name="beanInstanceName"
bean的名字,由<jsp:useBean>指定
property="propertyName"
所指定的Bean的屬性名。
技巧:
在sun的JSP參考中提到,如果你使用<jsp:getProperty>來檢索的值是空值,那么NullPointerException將會出現,同時如果使用程序段或表達式來檢索其值,那么在瀏覽器上出現的是null(空).
包含一個靜態或動態文件.
JSP 語法
<jsp:include page="{relativeURL | <%= expression%>}" flush="true" />
or
<jsp:include page="{relativeURL | <%= expression %>}"flush="true" >
<jsp:param name="parameterName"
value="{parameterValue | <%= expression %>}" />+
</jsp:include>
Examples
<jsp:include page="scripts/login.jsp" />
<jsp:include page="copyright.html" />
<jsp:include page="/index.html" />
<jsp:include page="scripts/login.jsp">
<jsp:param name="username" value="jsmith" />
</jsp:include>
描述
<jsp:include>元素允許你包含動態文件和靜態,這兩種包含文件的結果是不同的。如果文件僅是靜態文件,那么這種包含僅僅是把包含文件的內容加到jsp文件中去,而如果這個文件動態的,那么這個被包含文件也會被Jsp編譯器執行(這一切與asp相似)
你不能從文件名上判斷一個文件是動態的還是靜態的,比如aspcn.asp
就有可能只是包含一些信息而已,而不需要執行。<jsp:include>能夠同時處理這兩種文件,因此你就不需要包含時還要判斷此文件是動態的還是靜態的.
如果這個包含文件是動態的,那么你還可以用<jsp:param>還傳遞參數名和參數值。
屬性
page="{relativeURL | <%= expression %>}"
參數為一相對路徑,或者是代表相對路徑的表達式.
flush="true"
這里你必須使用flush="true",你不能使用false值.缺省值為false
<jsp:param name="parameterName" value="{parameterValue | <%= expression %> }" />+
<jsp:param>子句能讓你傳遞一個或多個參數給動態文件
你能在一個頁面中使用多個<jsp:param>來傳遞多個參數。
執行一個applet或Bean,有可能的話還要下載一個Java插件用于執行它.
JSP 語法
<jsp:plugin
type="bean | applet"
code="classFileName"
codebase="classFileDirectoryName"
[ name="instanceName" ]
[ archive="URIToArchive, ..." ]
[ align="bottom | top | middle | left | right" ]
[ height="displayPixels" ]
[ width="displayPixels" ]
[ hspace="leftRightPixels" ]
[ vspace="topBottomPixels" ]
[ jreversion="JREVersionNumber | 1.1" ]
[ nspluginurl="URLToPlugin" ]
[ iepluginurl="URLToPlugin" ] >
[ <jsp:params>
[ <jsp:param name="parameterName"
value="{parameterValue | <%= expression %>}" /> ]+
</jsp:params> ]
[ <jsp:fallback> text message for user </jsp:fallback> ]
</jsp:plugin>
例子
<jsp:plugin type=applet code="Molecule.class" codebase="/html">
<jsp:params>
<jsp:param name="molecule" value="molecules/benzene.mol" />
</jsp:params>
<jsp:fallback>
<p>Unable to load applet</p>
</jsp:fallback>
</jsp:plugin>
描述
<jsp:plugin>元素用于在瀏覽器中播放或顯示一個對象(典型的就是applet和Bean),而這種顯示需要在瀏覽器的java插件。
當Jsp文件被編譯,送往瀏覽器時,<jsp:plugin>元素將會根據瀏覽器的版本替換成<object>或者<embed>元素。注意,<object>用于HTML 4.0 ,<embed>用于HTML 3.2.
一般來說,<jsp:plugin>元素會指定對象是Applet還是Bean,同樣也會指定class的名字,還有位置,另外還會指定將從哪里下載這個Java插件。具體如下:
屬性
type="bean | applet"
.將被執行的插件對象的類型,你必須得指定這個是Bean還是applet,因為這個屬性沒有缺省值.
code="classFileName"
將會被Java插件執行的Java Class的名字,必須以.class結尾。這個文件必須存在于codebase屬性指定的目錄中.
codebase="classFileDirectoryName"
將會被執行的Java Class文件的目錄(或者是路徑),如果你沒有提供此屬性,那么使用<jsp:plugin>的jsp文件的目錄將會被使用.
name="instanceName"
這個Bean或applet實例的名字,它將會在Jsp其它的地方調用.
archive="URIToArchive, ..."
一些由逗號分開的路徑名,這些路徑名用于預裝一些將要使用的class,這會提高applet的性能.
align="bottom | top | middle | left | right"
圖形,對象,Applet的位置,有以下值:
?
bottom
topmiddleleftrightheight="displayPixels" width="displayPixels"
Applet或Bean將要顯示的長寬的值,此值為數字,單位為象素.
hspace="leftRightPixels" vspace="topBottomPixels"
Applet或Bean顯示時在屏幕左右,上下所需留下的空間,單位為象素.
jreversion="JREVersionNumber | 1.1"
Applet或Bean運行所需的Java Runtime Environment (JRE) 的版本.
缺省值是 1.1.
nspluginurl="URLToPlugin"
Netscape Navigator用戶能夠使用的JRE的下載地址,此值為一個標準的URL,如http://www.aspcn.com/jsp
iepluginurl="URLToPlugin"
IE用戶能夠使用的JRE的下載地址,此值為一個標準的URL,如http://www.aspcn.com/jsp
<jsp:params>[ <jsp:param name="parameterName"
value="{parameterValue | <%= expression %>}" /> ]+ </jsp:params>
你需要向applet或Bean傳送的參數或參數值。
<jsp:fallback> text message for user </jsp:fallback>
一段文字用于Java
插件不能啟動時顯示給用戶的,如果插件能夠啟動而applet或Bean不能,那么瀏覽器會有一個出錯信息彈出.
創建一個Bean實例并指定它的名字和作用范圍.
JSP 語法
<jsp:useBean
id="beanInstanceName"
scope="page | request | session | application"
{
class="package.class" |
type="package.class" |
class="package.class" type="package.class" |
beanName="{package.class | <%= expression %>}" type="package.class"
}
{
/> |
> other elements </jsp:useBean>
}
例子
<jsp:useBean id="cart" scope="session" class="session.Carts" />
<jsp:setProperty name="cart" property="*" />
<jsp:useBean id="checking" scope="session" class="bank.Checking" >
<jsp:setProperty name="checking" property="balance" value="0.0" />
</jsp:useBean>
創建一個Bean實例并指定它的名字和作用范圍.
JSP 語法
<jsp:useBean
id="beanInstanceName"
scope="page | request | session | application"
{
class="package.class" |
type="package.class" |
class="package.class" type="package.class" |
beanName="{package.class | <%= expression %>}" type="package.class"
}
{
/> |
> other elements </jsp:useBean>
}
?
例子
<jsp:useBean id="cart" scope="session" class="session.Carts" />
<jsp:setProperty name="cart" property="*" />
<jsp:useBean id="checking" scope="session" class="bank.Checking" >
<jsp:setProperty name="checking" property="balance" value="0.0" />
</jsp:useBean>
描述
<jsp:useBean>用于定位或示例一個JavaBeans組件。<jsp:useBean>首先會試圖定位一個Bean實例,如果這個Bean不存在,那么<jsp:useBean>就會從一個class或模版中進行示例。
為了定位或示例一個Bean,<jsp:useBean>會進行以下步聚,順序如下:
?
通過給定名字和范圍試圖定位一個Bean.
對這個Bean對象引用變量以你指定的名字命名.
如果發現了這個Bean,將會在這個變量中儲存這個引用。如果你也指定了類型,那么這個Bean也設置為相應的類型.
如果沒有發現這個Bean,將會從你指定的class中示例,并將此引用儲存到一個新的變量中去。如果這個class的名字代表的是一個模版,那么這個Bean被java.beans.Beans.instantiate示例.
如果<jsp:useBean>已經示例(不是定位)了Bean,同時<jsp:useBean>和</jsp:useBean>中有元素,那么將會執行其中的代碼.
<jsp:useBean>元素的主體通常包含有<jsp:setProperty>元素,用于設置Bean的屬性值。正如上面第五步所說的,<jsp:useBean>的主體僅僅只有在<jsp:useBean>示例Bean時才會被執行,如果這個Bean已經存在,<jsp:useBean>能夠定位它,那么主體中的內容將不會起作用
屬性以及用法
id="beanInstanceName"
在你所定義的范圍中確認Bean的變量,你能在后面的程序中使用此變量名來分辨不同的Bean
這個變量名對大小寫敏感,必須符合你所使用的腳本語言的規定,在Java
Programming Language中,這個規定在Java Language
規范已經寫明。如果這個Bean已經在別的<jsp:useBean>中創建,那么這個id的值必須與原來的那個id值一致.
scope="page | request | session | application"
Bean存在的范圍以及id變量名的有效范圍。缺省值是page,以下是詳細說明:
?
page - 你能在包含<jsp:useBean>元素的JSP文件以及此文件中的所有靜態包含文件中使用Bean,直到頁面執行完畢向客戶端發回響應或轉到另一個文件為止。
request - 你在任何執行相同請求的Jsp文件中使用Bean,直到頁面執行完畢向客戶端發回響應或轉到另一個文件為止。你能夠使用Request對象訪問Bean,比如request.getAttribute(beanInstanceName)
session - 從創建Bean開始,你就能在任何使用相同session的Jsp文件中使用Bean.這個Bean存在于整個Session生存周期內,任何在分享此Session的Jsp文件都能使用同一Bean.注意在你創建Bean的Jsp文件中<%
@ page %>指令中必須指定session=true
?
application - 從創建Bean開始,你就能在任何使用相同application的Jsp文件中使用Bean.這個Bean存在于整個application生存周期內,任何在分享此application的Jsp文件都能使用同一Bean.
class="package.class"
使用new關鍵字以及class構造器從一個class中示例一個bean.這個class不能是抽象的,必須有一個公用的,沒有參數的構造器.這個package的名字區別大小寫。
type="package.class"
如果這個Bean已經在指定的范圍中存在,那么寫這個Bean一個新的數據庫類型
。如果你沒有使用class或beanName指定type,Bean將不會被示例.package和class的名字,區分大小寫.
beanName="{package.class | <%= expression %>}" type="package.class"
使用java.beans.Beans.instantiate方法來從一個class或連續模版中示例一個Bean,同時指定Bean的類型。
beanName可以是package和class也可以是表達式,它的值會傳給Beans.instantiate.tupe的值可以和Bean相同。
package 和 class 名字區分大小寫.
內置對象是不需要聲明,直接可以在JSP中使用的對象,JSP有以下幾種內置對象:
request request表示HttpServletRequest對象。它包含了有關瀏覽器請求的信息,并且提供了幾個用于獲取cookie, header, 和session數據的有用的方法。
response response表示HttpServletResponse對象,并提供了幾個用于設置送回 瀏覽器的響應的方法(如cookies,頭信息等)
out out 對象是javax.jsp.JspWriter的一個實例,并提供了幾個方法使你能用于向瀏覽器回送輸出結果。
pageContext pageContext表示一個javax.servlet.jsp.PageContext對象。它是用于方便存取各種范圍的名字空間、servlet相關的對象的API,并且包裝了通用的servlet相關功能的方法。
session session表示一個請求的javax.servlet.http.HttpSession對象。Session可以存貯用戶的狀態信息
application applicaton 表示一個javax.servle.ServletContext對象。這有助于查找有關servlet引擎和servlet環境的信息
config config表示一個javax.servlet.ServletConfig對象。該對象用于存取servlet實例的初始化參數。
page page表示從該頁面產生的一個servlet實例。
Servlet API中的幾個對象
JSP提供了八個內部對象,而其中的五個內部對象對應于Servlet API中的七個對象,這也就使得我們正常理解并熟練使用Servlet中的這七個對象顯得尤其重要。這五個JSP的內部對象和Servlet API中的對象的對應關系是:
request對象對應于:javax.servlet.http.HttpServletRequest和javax.servlet.ServletRequest
response對象對應于:javax.servlet.http.HttpServletResponse和javax.servlet.ServletResponse
session對象對應于:javax.servlet.http.HttpSession
application對象對應于:javax.servlet.ServletContext
config對象對應于:javax.servlet.ServletConfig
javax.servlet.http.HttpServletRequest
這是一個接口,在我們提到接口之前,還是讓我們來復習一下Java中接口的一個初步的解釋:
接口在語法上與類相似,但是接口沒有實例,使用接口,只是指定類必須做什么而不是如何做。
HttpServletRequest接口用來處理一個對Servlet的HTTP格式的請求信息。
javax.servlet.ServletRequest
這也是一個接口,這個接口定義一個Servlet引擎產生的對象,通過這個對象,Servlet可以獲得客戶端請求的數據。這個對象通過讀取請求體的數據提供包括參數的名稱、值和屬性以及輸入流的所有數據。而javax.servlet.http.HttpServletRequest也只是該接口的一個擴展,也就是說,該接口的所有方法也可以被javax.servlet.http.HttpServletRequest所使用。
javax.servlet.http.HttpServletResponse接口
該接口用來描述一個返回到客戶端的HTTP回應。
javax.servlet.ServletResponse接口
該接口用來定義一個Servlet引擎產生的對象,通過這個對象,Servlet對客戶端的請求作出響應。這個響應應該是一個MIME實體,可能是一個HTML頁、圖象數據或其他MIME的格式。javax.servlet.http.HttpServletResponse接口是該接口的擴展。
javax.servlet.http.HttpSession接口
該接口用來描述一個session,至于什么是session我想在這里就沒必要說了吧。
javax.servlet.ServletContext接口
該接口用來定義了一個Servlet的環境對象。也可是認為這是多個客戶端共享的信息,它與session的區別在于應用范圍的不同,session只對應于一個用戶。
javax.servlet.ServletConfig接口
該接口定義了一個對象,通過這個對象,Servlet引擎配置一個Servlet。每一個ServletConfig對象對應著一個唯一的Servlet。
javax.servlet.http.Cookie類
這個類描述了一個cookie,cookie的作用其實與session很類似,只是cookie保存在客戶端,session保存在服務器端。