js|文法 HTML注釋
在用戶端顯示一個注釋。
JSP 文法
spacing="0" cellpadding="2" bordercolorlight = "black" bordercolordark = "#FFFFFF" align="center"> <!-- 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中要是合法的。
當你聲明方法或變數時，請注意以下的一些規則:
1 聲明必須以";"結尾(Scriptlet有同樣的規則，但是運算式就不同了)。
2 你可以直接使用在% @ page %中被包含進來的已經聲明的變數和方法，不需要對它們重新進行聲明。
3 一個聲明僅在一個頁面中有效。如果你想每個頁面都用到一些聲明，最好把它們寫成一個單獨的檔案，然後用%@ include %或jsp:include元素包含進來。
運算式
包含一個符合JSP文法的運算式。
JSP 文法
<%= expression %>
例子
<font color="blue"><%= map.size() %></font>
<b><%= numguess.getHint() %></b>.
描述
運算式元素表示的是一個在指令碼語言中被定義的運算式，在運行後被自動轉化為字串，然後插入到這個運算式在JSP檔案的位置顯示。因為這個運算式的值已經被轉化為字串，所以你能在一行文本中插入這個運算式（形式和ASP完全一樣)。
當你在JSP中使用運算式時請記住以下幾點：
1 你不能用一個分號（“;”）來作為運算式的結束符。但是同樣的運算式用在scriptlet中就需要以分號來結尾了！查看Scriptlet這個運算式元素能夠包括任何在Java Language Specification中有效運算式。
2 有時候運算式也能作為其它JSP元素的屬性值。一個運算式能夠變得很複雜，它可能由一個或多個運算式組成，這些運算式的順序是從左至右。
Scriptlet
包含一個有效程式段。
JSP 文法
width="400" border="1" cellspacing="0" cellpadding="2" bordercolorlight = "black" bordercolordark = "#FFFFFF" align="center"> <% 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，我們便能做以下的事:
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 %指令，而且你可以在一個頁面中多次使用，但是首碼只能使用一次。
屬性
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，如果這裡不寫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 文法
d_nobr> <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 | }"
參數為一相對路徑，或者是代表相對路徑的運算式。
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>
