html注釋
在客戶端顯示一個注釋。
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 語法
例子：
<%@ 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中要是合法的。
當你聲明方法或變量時，請注意以下的一些規則:
1 聲明必須以";"結尾(scriptlet有同樣的規則，但是表達式就不同了)。
2 你可以直接使用在% @ page %中被包含進來的已經聲明的變量和方法，不需要對它們重新進行聲明。
3 一個聲明僅在一個頁面中有效。如果你想每個頁面都用到一些聲明，最好把它們寫成一個單獨的文件，然后用%@ include %或jsp:include元素包含進來。
表達式
包含一個符合jsp語法的表達式。
jsp 語法
例子
<font color="blue"><%= map.size() %></font> <b><%= numguess.gethint() %></b>. |
描述
表達式元素表示的是一個在腳本語言中被定義的表達式，在運行后被自動轉化為字符串，然后插入到這個表達式在jsp文件的位置顯示。因為這個表達式的值已經被轉化為字符串，所以你能在一行文本中插入這個表達式（形式和asp完全一樣)。
當你在jsp中使用表達式時請記住以下幾點：
1 你不能用一個分號（“;”）來作為表達式的結束符。但是同樣的表達式用在scriptlet中就需要以分號來結尾了！查看scriptlet這個表達式元素能夠包括任何在java language specification中有效的表達式。
2 有時候表達式也能作為其它jsp元素的屬性值。一個表達式能夠變得很復雜，它可能由一個或多個表達式組成，這些表達式的順序是從左到右。 scriptlet
包含一個有效的程序段。
jsp 語法
例子
<% 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，我們便能做以下的事:
1 聲明將要用到的變量或方法（參考 聲明)。
2 編寫jsp表達式（參考 表達式)。
3 使用任何隱含的對象和任何用jsp:usebean聲明過的對象。
4 編寫jsp語句(如果你在使用java語言，這些語句必須遵從java language specification)。
任何文本、html標記、jsp元素必須在scriptlet之外。
當jsp收到客戶的請求時，scriptlet就會被執行，如果scriptlet有顯示的內容，這些顯示的內容就被存在out對象中。
page 指令
定義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文件的頂部。
taglib 指令
定義一個標簽庫以及其自定義標簽的前綴。
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 %指令，而且你可以在一個頁面中多次使用，但是前綴只能使用一次。
屬性
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，如果這里不寫public，那么這就是不合法的。請不要用jsp、jspx、java、javax、servlet、sun和sunw做你的前綴。
jsp:forward
重定向一個html文件、jsp文件、或者是一個程序段。
jsp 語法
<jsp:forward page={"relativeurl" | "<%= expression %>"} /> or <jsp:forward page={"relativeurl" | "<%= expression %>"} > <jsp:param name="parametername" value="{parametervalue | <%= expression %>}" />+ </jsp:forward> |
例子
<jsp:forward page="/servlet/login" /> <jsp:forward page="/servlet/login"> <jsp:param name="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:param name="parametername" value="{parametervalue | <%= expression %>}" />+ |
向一個動態文件發送一個或多個參數，這個文件一定是動態文件。
如果你想傳遞多個參數，你可以在一個jsp文件中使用多個jsp:param。name指定參數名，value指定參數值。
jsp:getproperty
獲取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元素有一些限制:
1 你不能使用jsp:getproperty來檢索一個已經被索引了的屬性
2 你能夠和javabeans組件一起使用jsp:getproperty，但是不能與enterprise bean一起使用。
屬性
name="beaninstancename"
bean的名字，由jsp:usebean指定。
property="propertyname"
所指定的bean的屬性名。
技巧:
在sun的jsp參考中提到，如果你使用jsp:getproperty來檢索的值是空值，那么nullpointerexception將會出現，同時如果使用程序段或表達式來檢索其值，那么在瀏覽器上出現的是null(空)。
jsp:include 包含一個靜態或動態文件。
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> |
例子
<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來傳遞多個參數。
jsp:plugin 執行一個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
top
middle
left
right
height="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不能，那么瀏覽器會有一個出錯信息彈出。
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> |
菜鳥學堂：
