與JSP指令元素不同的是,JSP動作元素在請求處理階段運作。 JSP動作元素是用XML語法寫成的。
利用JSP動作可以動態地插入檔案、重複使用JavaBean元件、把使用者重新導向到另外的頁面、為Java外掛程式產生HTML程式碼。
動作元素只有一種文法,它符合XML標準:
<jsp:action_name attribute="value" />
動作元素基本上都是預先定義的函數,JSP規範定義了一系列的標準動作,它用JSP作為前綴,可用的標準動作元素如下:
文法 | 描述 |
---|---|
jsp:include | 在頁面被請求的時候引入一個文件。 |
jsp:useBean | 尋找或實例化一個JavaBean。 |
jsp:setProperty | 設定JavaBean的屬性。 |
jsp:getProperty | 輸出某個JavaBean的屬性。 |
jsp:forward | 把請求轉到一個新的頁面。 |
jsp:plugin | 根據瀏覽器類型為Java插件產生OBJECT或EMBED標記。 |
jsp:element | 定義動態XML元素 |
jsp:attribute | 設定動態定義的XML元素屬性。 |
jsp:body | 設定動態定義的XML元素內容。 |
jsp:text | 在JSP頁面和文件中使用寫入文字的模板 |
所有的動作要素都有兩個屬性:id屬性和scope屬性。
id屬性:
id屬性是動作元素的唯一標識,可以在JSP頁面中引用。動作元素所建立的id值可以透過PageContext來呼叫。
scope屬性:
此屬性用於識別動作元素的生命週期。 id屬性和scope屬性有直接關係,scope屬性定義了相關聯id物件的壽命。 scope屬性有四個可能的值: (a) page, (b)request, (c)session, 和(d) application。
<jsp:include>動作元素用來包含靜態和動態的檔案。這個動作把指定文件插入正在產生的頁面。文法格式如下:
<jsp:include page="relative URL" flush="true" />
前面已經介紹過include指令,它是在JSP文件被轉換成Servlet的時候引入文件,而這裡的jsp:include動作不同,插入文件的時間是在頁面被請求的時候。
以下是include動作相關的屬性清單。
屬性 | 描述 |
---|---|
page | 包含在頁面中的相對URL位址。 |
flush | 布林屬性,定義在包含資源前是否刷新快取區。 |
以下我們定義了兩個檔案date.jsp和main.jsp,程式碼如下所示:
date.jsp檔案代碼:
<p> Today's date: <%= (new java.util.Date()).toLocaleString()%></p>
main.jsp檔案程式碼:
<html><head><title>The include Action Example</title></head><body><center><h2>The include action Example</h2><jsp:include page="date.jsp" flush ="true" /></center></body></html>
現在將以上兩個檔案放在伺服器的根目錄下,存取main.jsp檔案。顯示結果如下:
The include action ExampleToday's date: 12-Sep-2013 14:54:22
jsp:useBean動作用來裝載一個將在JSP頁面中使用的JavaBean。
這個功能非常有用,因為它使得我們既可以發揮Java元件重用的優勢,同時也避免了損失JSP區別於Servlet的方便性。
jsp:useBean動作最簡單的語法為:
<jsp:useBean id="name" />
在類別載入後,我們既可以透過jsp:setProperty 和jsp:getProperty 動作來修改和擷取bean的屬性。
以下是useBean動作相關的屬性清單。
屬性 | 描述 |
---|---|
class | 指定Bean的完整包名。 |
type | 指定將引用該物件變數的類型。 |
beanName | 透過java.beans.Beans 的instantiate() 方法指定Bean的名字。 |
在給具體實例之前,讓我們先來看看jsp:setProperty 和jsp:getProperty 動作元素:
jsp:setProperty用來設定已經實例化的Bean物件的屬性,有兩種用法。首先,你可以在jsp:useBean元素的外面(後面)使用jsp:setProperty,如下所示:
<jsp:useBean id="myName" ... />...<jsp:setProperty name="myName" property="someProperty" .../>
此時,不管jsp:useBean是找到了一個現有的Bean,還是新建立了一個Bean實例,jsp:setProperty都會執行。第二種用法是把jsp:setProperty放入jsp:useBean元素的內部,如下所示:
<jsp:useBean id="myName" ... >... <jsp:setProperty name="myName" property="someProperty" .../></jsp:useBean>
此時,jsp:setProperty只有在新建Bean實例時才會執行,如果是使用現有實例則不執行jsp:setProperty。
屬性 | 描述 |
---|---|
name | name屬性是必需的。它表示要設定屬性的是哪個Bean。 |
property | property屬性是必要的。它表示要設定哪個屬性。有一個特殊用法:如果property的值是"*",表示所有名字和Bean屬性名字匹配的請求參數都會被傳遞給對應的屬性set方法。 |
value | value 屬性是可選的。該屬性用來指定Bean屬性的值。字串資料會在目標類別中透過標準的valueOf方法自動轉換成數字、boolean、Boolean、 byte、Byte、char、Character。例如,boolean和Boolean類型的屬性值(例如"true")透過Boolean.valueOf轉換,int和Integer類型的屬性值(例如"42")透過Integer.valueOf轉換。 value和param不能同時使用,但可以使用其中任一個。 |
param | param 是可選的。它指定用哪個請求參數作為Bean屬性的值。如果目前請求沒有參數,則什麼事情也不做,系統不會把null傳遞給Bean屬性的set方法。因此,你可以讓Bean自己提供預設屬性值,只有當請求參數明確指定了新值時才修改預設屬性值。 |
jsp:getProperty動作提取指定Bean屬性的值,轉換成字串,然後輸出。文法格式如下:
<jsp:useBean id="myName" ... />...<jsp:getProperty name="myName" property="someProperty" .../>
下表是與getProperty相關聯的屬性:
屬性 | 描述 |
---|---|
name | 要檢索的Bean屬性名稱。 Bean必須已定義。 |
property | 表示要提取Bean屬性的值 |
以下實例我們使用了Bean:
/* 檔案: TestBean.java */package action; public class TestBean { private String message = "No message specified"; public String getMessage() { return(message); } public void setMessage(String message) { this.message = this.message = this.message = this.message = this.message = this.message = this.message = this.message = this.message = this.message = this.message = this.message = this.message = this. message; }}
編譯上述實例並產生TestBean.class 文件,將該文件拷貝至伺服器正式存放Java類別的目錄下,而不是保留給修改後能夠自動裝載的類別的目錄( 如:C:apache-tomcat-7.0.2 webappsWEB-INFclassesaction目錄中,CLASSPATH 變數必須包含該路徑。例如,對於Java Web Server來說,Bean和所有Bean用到的類別都應該放入classes目錄,或是封裝進jar檔後放入lib目錄,但不應該放到servlets 下。 下面是一個很簡單的例子,它的功能是裝載一個Bean,然後設定/讀取它的message屬性。
現在讓我們在main.jsp檔案中呼叫該Bean:
<html><head><title>Using JavaBeans in JSP</title></head><body><center><h2>Using JavaBeans in JSP</h2> <jsp:useBean id="test" /> < jsp:setProperty name="test" property="message" value="Hello JSP..." /> <p>Got message....</p> <jsp:getProperty name="test" property="message" /> </center></body></html>
執行以上文件,輸出如下:
Using JavaBeans in JSPGot message....Hello JSP...
jsp:forward動作把請求轉到另外的頁面。 jsp:forward標記只有一個屬性page。語法格式如下所示:
<jsp:forward page="Relative URL" />
以下是forward相關聯的屬性:
屬性 | 描述 |
---|---|
page | page屬性包含的是一個相對URL。 page的值可以直接給出,也可以在請求的時候動態計算,可以是一個JSP頁面或一個Java Servlet. |
以下實例我們使用了兩個文件,分別是: date.jsp 和main.jsp。
date.jsp檔案程式碼如下:
<p> Today's date: <%= (new java.util.Date()).toLocaleString()%></p>
main.jsp檔案程式碼:
<html><head><title>The forward Action Example</title></head><body><center><h2>The forward action Example</h2><jsp:forward page="date.jsp" / ></center></body>
現在將以上兩個檔案放在伺服器的根目錄下,存取main.jsp檔案。顯示結果如下:
Today's date: 12-Sep-2010 14:54:22
jsp:plugin動作用來根據瀏覽器的類型,插入透過Java外掛程式運行Java Applet所必需的OBJECT或EMBED元素。
如果需要的插件不存在,它會下載插件,然後執行Java元件。 Java元件可以是一個applet或一個JavaBean。
plugin動作有多個對應HTML元素的屬性用來格式化Java 元件。 param元素可用於向Applet 或Bean 傳遞參數。
以下是使用plugin 動作元素的典型實例:
<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class" > <jsp:param name="fontcolor" value="red" /> <jsp:param name="background" value=" black" /> <jsp:fallback> Unable to initialize Java Plugin </jsp:fallback> </jsp:plugin>
如果你有興趣可以嘗試使用applet來測試jsp:plugin動作元素,<fallback>元素是一個新元素,在元件出現故障的錯誤是傳送給使用者錯誤訊息。
<jsp:element> 、 <jsp:attribute>、 <jsp:body>動作元素動態定義XML元素。動態是非常重要的,這意味著XML元素在編譯時是動態產生的而非靜態。
以下實例動態定義了XML元素:
<%@page language="java" contentType="text/html"%><html xmlns="http://www.w3c.org/1999/xhtml" xmlns:jsp="http://java.sun. com/JSP/Page"><head><title>Generate XML Element</title></head><body><jsp:element name="xmlElement"><jsp:attribute name="xmlElementAttr"> Value for the attribute</jsp:attribute><jsp:body> Body for XML element</jsp:body></jsp:element></body></html>
執行時產生HTML程式碼如下:
<html xmlns="http://www.w3c.org/1999/xhtml" xmlns:jsp="http://java.sun.com/JSP/Page"> <head><title>Generate XML Element</ title></head><body><xmlElement xmlElementAttr="Value for the attribute"> Body for XML element</xmlElement></body></html>
<jsp:text>動作元素允許在JSP頁面和文件中使用寫入文字的模板,語法格式如下:
<jsp:text>Template data</jsp:text>
以上文字範本不能包含其他元素,只能只能包含文字和EL表達式(註:EL表達式將在後續章節中介紹)。請注意,在XML檔案中,您不能使用表達式如${whatever > 0},因為>符號是非法的。 你可以使用${whatever gt 0}表達式或嵌入在一個CDATA部分的值。
<jsp:text><![CDATA[<br>]]></jsp:text>
如果你需要在XHTML 中宣告DOCTYPE,必須使用到<jsp:text>動作元素,實例如下:
<jsp:text><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">]]></jsp:text>< head><title>jsp:text action</title></head><body><books><book><jsp:text> Welcome to JSP Programming</jsp:text></book></books></body></html>
你可以對上述實例嘗試使用<jsp:text>及不使用該動作元素執行結果的區別。