與JSP指令元素不同的是,JSP動(dòng)作元素在請(qǐng)求處理階段起作用。JSP動(dòng)作元素是用XML語(yǔ)法寫(xiě)成的。
利用JSP動(dòng)作可以動(dòng)態(tài)地插入文件、重用JavaBean組件、把用戶(hù)重定向到另外的頁(yè)面、為Java插件生成HTML代碼。
動(dòng)作元素只有一種語(yǔ)法,它符合XML標(biāo)準(zhǔn):
<jsp:action_name attribute="value" />
動(dòng)作元素基本上都是預(yù)定義的函數(shù),JSP規(guī)范定義了一系列的標(biāo)準(zhǔn)動(dòng)作,它用JSP作為前綴,可用的標(biāo)準(zhǔn)動(dòng)作元素如下:
語(yǔ)法 | 描述 |
---|---|
jsp:include | 在頁(yè)面被請(qǐng)求的時(shí)候引入一個(gè)文件。 |
jsp:useBean | 尋找或者示例化一個(gè)JavaBean。 |
jsp:setProperty | 設(shè)置JavaBean的屬性。 |
jsp:getProperty | 輸出某個(gè)JavaBean的屬性。 |
jsp:forward | 把請(qǐng)求轉(zhuǎn)到一個(gè)新的頁(yè)面。 |
jsp:plugin | 根據(jù)瀏覽器類(lèi)型為Java插件生成OBJECT或EMBED標(biāo)記。 |
jsp:element | 定義動(dòng)態(tài)XML元素 |
jsp:attribute | 設(shè)置動(dòng)態(tài)定義的XML元素屬性。 |
jsp:body | 設(shè)置動(dòng)態(tài)定義的XML元素內(nèi)容。 |
jsp:text | 在JSP頁(yè)面和文檔中使用寫(xiě)入文本的模板 |
所有的動(dòng)作要素都有兩個(gè)屬性:id屬性和scope屬性。
id屬性:
id屬性是動(dòng)作元素的唯一標(biāo)識(shí),可以在JSP頁(yè)面中引用。動(dòng)作元素創(chuàng)建的id值可以通過(guò)PageContext來(lái)調(diào)用。
scope屬性:
該屬性用于識(shí)別動(dòng)作元素的生命周期。 id屬性和scope屬性有直接關(guān)系,scope屬性定義了相關(guān)聯(lián)id對(duì)象的壽命。 scope屬性有四個(gè)可能的值: (a) page, (b)request, (c)session, 和 (d) application。
<jsp:include>動(dòng)作元素用來(lái)包含靜態(tài)和動(dòng)態(tài)的文件。該動(dòng)作把指定文件插入正在生成的頁(yè)面。語(yǔ)法格式如下:
<jsp:include page="相對(duì) URL 地址" flush="true" />
前面已經(jīng)介紹過(guò)include指令,它是在JSP文件被轉(zhuǎn)換成Servlet的時(shí)候引入文件,而這里的jsp:include動(dòng)作不同,插入文件的時(shí)間是在頁(yè)面被請(qǐng)求的時(shí)候。
以下是include動(dòng)作相關(guān)的屬性列表。
屬性 | 描述 |
---|---|
page | 包含在頁(yè)面中的相對(duì)URL地址。 |
flush | 布爾屬性,定義在包含資源前是否刷新緩存區(qū)。 |
以下我們定義了兩個(gè)文件 date.jsp 和 main.jsp,代碼如下所示:
date.jsp文件代碼:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <p> 今天的日期是: <%= (new java.util.Date()).toLocaleString()%> </p>
main.jsp文件代碼:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>菜鳥(niǎo)教程(cainiaoplus.com)</title> </head> <body> <h2>include 動(dòng)作示例</h2> <jsp:include page="date.jsp" flush="true" /> </body> </html>
現(xiàn)在將以上兩個(gè)文件放在服務(wù)器的根目錄下,訪(fǎng)問(wèn)main.jsp文件。顯示結(jié)果如下:
include 動(dòng)作示例 今天的日期是: 2016-6-25 14:08:17
jsp:useBean 動(dòng)作用來(lái)加載一個(gè)將在JSP頁(yè)面中使用的JavaBean。
這個(gè)功能非常有用,因?yàn)樗沟梦覀兛梢园l(fā)揮 Java 組件復(fù)用的優(yōu)勢(shì)。
jsp:useBean動(dòng)作最簡(jiǎn)單的語(yǔ)法為:
<jsp:useBean id="name" />
在類(lèi)載入后,我們既可以通過(guò) jsp:setProperty 和 jsp:getProperty 動(dòng)作來(lái)修改和檢索bean的屬性。
以下是useBean動(dòng)作相關(guān)的屬性列表。
屬性 | 描述 |
---|---|
class | 指定Bean的完整包名。 |
type | 指定將引用該對(duì)象變量的類(lèi)型。 |
beanName | 通過(guò) java.beans.Beans 的 instantiate() 方法指定Bean的名字。 |
在給出具體示例前,讓我們先來(lái)看下 jsp:setProperty 和 jsp:getProperty 動(dòng)作元素:
jsp:setProperty用來(lái)設(shè)置已經(jīng)示例化的Bean對(duì)象的屬性,有兩種用法。首先,你可以在jsp:useBean元素的外面(后面)使用jsp:setProperty,如下所示:
<jsp:useBean id="myName" ... /> ... <jsp:setProperty name="myName" property="someProperty" .../>
此時(shí),不管jsp:useBean是找到了一個(gè)現(xiàn)有的Bean,還是新創(chuàng)建了一個(gè)Bean示例,jsp:setProperty都會(huì)執(zhí)行。第二種用法是把jsp:setProperty放入jsp:useBean元素的內(nèi)部,如下所示:
<jsp:useBean id="myName" ... > ... <jsp:setProperty name="myName" property="someProperty" .../> </jsp:useBean>
此時(shí),jsp:setProperty只有在新建Bean示例時(shí)才會(huì)執(zhí)行,如果是使用現(xiàn)有示例則不執(zhí)行jsp:setProperty。
jsp:setProperty動(dòng)作有下面四個(gè)屬性,如下表:
屬性 | 描述 |
---|---|
name | name屬性是必需的。它表示要設(shè)置屬性的是哪個(gè)Bean。 |
property | property屬性是必需的。它表示要設(shè)置哪個(gè)屬性。有一個(gè)特殊用法:如果property的值是"*",表示所有名字和Bean屬性名字匹配的請(qǐng)求參數(shù)都將被傳遞給相應(yīng)的屬性set方法。 |
value | value 屬性是可選的。該屬性用來(lái)指定Bean屬性的值。字符串?dāng)?shù)據(jù)會(huì)在目標(biāo)類(lèi)中通過(guò)標(biāo)準(zhǔn)的valueOf方法自動(dòng)轉(zhuǎn)換成數(shù)字、boolean、Boolean、 byte、Byte、char、Character。例如,boolean和Boolean類(lèi)型的屬性值(比如"true")通過(guò) Boolean.valueOf轉(zhuǎn)換,int和Integer類(lèi)型的屬性值(比如"42")通過(guò)Integer.valueOf轉(zhuǎn)換。 value和param不能同時(shí)使用,但可以使用其中任意一個(gè)。 |
param | param 是可選的。它指定用哪個(gè)請(qǐng)求參數(shù)作為Bean屬性的值。如果當(dāng)前請(qǐng)求沒(méi)有參數(shù),則什么事情也不做,系統(tǒng)不會(huì)把null傳遞給Bean屬性的set方法。因此,你可以讓Bean自己提供默認(rèn)屬性值,只有當(dāng)請(qǐng)求參數(shù)明確指定了新值時(shí)才修改默認(rèn)屬性值。 |
jsp:getProperty動(dòng)作提取指定Bean屬性的值,轉(zhuǎn)換成字符串,然后輸出。語(yǔ)法格式如下:
<jsp:useBean id="myName" ... /> ... <jsp:getProperty name="myName" property="someProperty" .../>
下表是與getProperty相關(guān)聯(lián)的屬性:
屬性 | 描述 |
---|---|
name | 要檢索的Bean屬性名稱(chēng)。Bean必須已定義。 |
property | 表示要提取Bean屬性的值 |
以下示例我們使用了Bean:
package com.nhooo.main; public class TestBean { private String message = "菜鳥(niǎo)教程"; public String getMessage() { return(message); } public void setMessage(String message) { this.message = message; } }
編譯以上示例文件 TestBean.java :
$ javac TestBean.java
編譯完成后會(huì)在當(dāng)前目錄下生成一個(gè) TestBean.class 文件, 將該文件拷貝至當(dāng)前 JSP 項(xiàng)目的 WebContent/WEB-INF/classes/com/nhooo/main下( com/nhooo/main 包路徑,沒(méi)有需要手動(dòng)創(chuàng)建)。
下面是一個(gè) Eclipse 中目錄結(jié)構(gòu)圖:
下面是一個(gè)很簡(jiǎn)單的實(shí)例,它的功能是裝載一個(gè)Bean,然后設(shè)置/讀取它的message屬性。
現(xiàn)在讓我們?cè)趍ain.jsp文件中調(diào)用該Bean:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>菜鳥(niǎo)教程(cainiaoplus.com)</title> </head> <body> <h2>Jsp 使用 JavaBean 示例</h2> <jsp:useBean id="test" /> <jsp:setProperty name="test" property="message" value="菜鳥(niǎo)教程..." /> <p>輸出信息....</p> <jsp:getProperty name="test" property="message" /> </body> </html>
瀏覽器訪(fǎng)問(wèn),執(zhí)行以上文件,輸出如下所示:
jsp:forward動(dòng)作把請(qǐng)求轉(zhuǎn)到另外的頁(yè)面。jsp:forward標(biāo)記只有一個(gè)屬性page。語(yǔ)法格式如下所示:
<jsp:forward page="相對(duì) URL 地址" />
以下是forward相關(guān)聯(lián)的屬性:
屬性 | 描述 |
---|---|
page | page屬性包含的是一個(gè)相對(duì)URL。page的值既可以直接給出,也可以在請(qǐng)求的時(shí)候動(dòng)態(tài)計(jì)算,可以是一個(gè)JSP頁(yè)面或者一個(gè) Java Servlet. |
以下示例我們使用了兩個(gè)文件,分別是: date.jsp 和 main.jsp。
date.jsp 文件代碼如下:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <p> 今天的日期是: <%= (new java.util.Date()).toLocaleString()%> </p>
main.jsp文件代碼:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>菜鳥(niǎo)教程(cainiaoplus.com)</title> </head> <body> <h2>forward 動(dòng)作示例</h2> <jsp:forward page="date.jsp" /> </body> </html>
現(xiàn)在將以上兩個(gè)文件放在服務(wù)器的根目錄下,訪(fǎng)問(wèn)main.jsp文件。顯示結(jié)果如下:
今天的日期是: 2016-6-25 14:37:25
jsp:plugin動(dòng)作用來(lái)根據(jù)瀏覽器的類(lèi)型,插入通過(guò)Java插件 運(yùn)行Java Applet所必需的OBJECT或EMBED元素。
如果需要的插件不存在,它會(huì)下載插件,然后執(zhí)行Java組件。 Java組件可以是一個(gè)applet或一個(gè)JavaBean。
plugin動(dòng)作有多個(gè)對(duì)應(yīng)HTML元素的屬性用于格式化Java 組件。param元素可用于向Applet 或 Bean 傳遞參數(shù)。
以下是使用plugin 動(dòng)作元素的典型示例:
<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來(lái)測(cè)試jsp:plugin動(dòng)作元素,<fallback>元素是一個(gè)新元素,在組件出現(xiàn)故障的錯(cuò)誤時(shí)發(fā)送給用戶(hù)錯(cuò)誤信息。
<jsp:element> 、 <jsp:attribute>、 <jsp:body>動(dòng)作元素動(dòng)態(tài)定義XML元素。動(dòng)態(tài)是非常重要的,這就意味著XML元素在編譯時(shí)是動(dòng)態(tài)生成的而非靜態(tài)。
以下示例動(dòng)態(tài)定義了XML元素:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>菜鳥(niǎo)教程(cainiaoplus.com)</title> </head> <body> <jsp:element name="xmlElement"> <jsp:attribute name="xmlElementAttr"> 屬性值 </jsp:attribute> <jsp:body> XML 元素的主體 </jsp:body> </jsp:element> </body> </html>
瀏覽器訪(fǎng)問(wèn)以下頁(yè)面,輸出結(jié)果如下所示:
<jsp:text>動(dòng)作元素允許在JSP頁(yè)面和文檔中使用寫(xiě)入文本的模板,語(yǔ)法格式如下:
<jsp:text>模板數(shù)據(jù)</jsp:text>
以上文本模板不能包含重復(fù)元素,只能包含文本和EL表達(dá)式(注:EL表達(dá)式將在后續(xù)章節(jié)中介紹)。請(qǐng)注意,在XML文件中,您不能使用表達(dá)式如 ${whatever > 0},因?yàn)?gt;符號(hào)是非法的。 你可以使用 ${whatever gt 0}表達(dá)式或者嵌入在一個(gè)CDATA部分的值。
<jsp:text><![CDATA[<br>]]></jsp:text>
如果你需要在 XHTML 中聲明 DOCTYPE,必須使用到<jsp:text>動(dòng)作元素,示例如下:
<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>
你可以對(duì)以上示例嘗試使用<jsp:text>及不使用該動(dòng)作元素執(zhí)行結(jié)果的區(qū)別。