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 語法
<%-- 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元素的屬性值.一個表達式能夠變得很複雜,它可能由一個或多個表達式組成,這些表達式的順序是從左到右。
Scriptlet
包含一個有效的程序段.
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對象中。
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:loop>中的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>元素有一些限制:
你不能使用<jsp:getProperty>來檢索一個已經被索引了的屬性
你能夠和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>
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>來傳遞多個參數。
<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>