#1122 JSP動作元素
JSP動作元素
與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>動作元素用來包含靜態和動態的檔案。該動作把指定檔案插入正在生成的頁面。語法格式如下：
<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()).toLocalString()%>
</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>
<jsp:useBean>動作元素
jsp:useBean動作用來裝載一個將在JSP頁面中使用的JavaBean。
這個功能非常有用，因為它使得我們既可以發揮Java元件重用的優勢，同時也避免了損失JSP區別於Servlet的方便性。
jsp:useBean動作最簡單的語法為：
<jsp:useBean id = "name" class= "package.class" />
在類載入後，我們既可以通過 jsp:setProperty 和 jsp:getProperty 動作來修改和檢索bean的屬性。
以下是useBean動作相關的屬性列表。
屬性 描述
class 指定Bean的完整包名。
type 指定將引用該物件變數的型別。
beanName 通過 java.beans.Beans 的 instantiate() 方法指定Bean的名字。
在給出具體例項前，讓我們先來看下 jsp:setProperty 和 jsp:getProperty 動作元素：
<jsp:setProperty>動作元素
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>動作元素
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 = message;
}
}
<html>
<head>
<title>Using JavaBeans in JSP</title>
</head>
<body>
<center>
<h2>Using JavaBeans in JSP</h2>
<jsp:useBean id = "test" class = "action.TestBean" />
<jsp:setProperty name = "test" property = "message"
value = "Hello JSP ..." />
<p>Got message ......</p>
<jsp:getProperty name = "test" property = "message"/>
</center>
</body>
</html>
<jsp:forward> 動作元素
jsp:forward動作把請求轉到另外的頁面。jsp:forward標記只有一個屬性page。語法格式如下所示：
<jsp:forward page="Relative URL" />
以下是forward相關聯的屬性：
屬性,描述
page
page屬性包含的是一個相對URL。page的值既可以直接給出，也可以在請求的時候動態計算，可以是一個JSP頁面或者一個 Java Servlet.
例項
以下例項我們使用了兩個檔案，分別是： date.jps 和 main.jsp。
date.js檔案程式碼如下：
<p>
Today's date:<%=(new java.util.Date()).toLocalString()%>
</p>
main.jsp 檔案程式碼：
<html>
<head>
<title>The include Action Example</title>
</head>
<body>
<center>
<h2>The include action Example</h2>
<jsp:forward page = "date.jsp" />
</center>
</body>
</html>
現在將以上兩個檔案放在伺服器的根目錄下，訪問main.jsp檔案。顯示結果如下：
<jsp:plugin>動作元素
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"
width="60" height="80">
<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>動作元素
<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: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>