js|教程
jsp:useBean Action 的使用
一、 文法:
<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"
}
{ /> |
> 其他元素
</jsp:useBean>
}
這個action使您能將一個JavaBean裝入一個JSP頁面。這是一個非常有用的能力,因為它使您可以使用可重用的JAVA類而不需犧牲效能。最簡單的文法用於指定一個bean:
<jsp:useBean id="name" class="package.class" />
這通常意味著“執行個體化一個類的對象通過指定一個類,並將之與一個通過id指定名稱的變數綁定”。然而,就象我們看到的,您可以指定一個scope屬性來使得bean不僅僅與當前的頁面相聯絡。在這種情形下,得到一個對已存在的bean的引用是非常有用的,而且,僅當沒有相同的id和scope的bean存在時才建立一個新的。現在,您已有了bean,您可以通過jsp:setProperty來修改它,或者,通過使用之前用id指定的名字來使用scriptlet或明確的調用方法。當您說“這個bean有一個稱為foo的X類型的屬性”,您真正的意思是“這個類有一個稱為getFoo的方法,它返回X類型的某類值,還有另一個方法稱為setFoo,它以X為參數。”這jsp:setProperty action 將在下一單元詳細的介紹,但是現在您既可以給出一個明確的值,給出一個屬性來說明此值是從request的參數繼承而來,也可以僅僅列出屬性來標誌此值應該從與屬性名稱同名的參數繼承而來。您可以通過調用適用的getXxx方法,或更普遍的,使用jsp:getProperty action,來得到已存在的JSP運算式或scriptlet屬性。
請注意,為bean指定的類必須在伺服器的規則的類路徑下,而不是用來保留當改變時自動裝載的類的路徑。例如,在Java Web Server上,它和它所用的類必須到類的目錄或在lib目錄下的一個jar檔案內,而不是在servlets的目錄下。
下面讓我們來看一個非常簡單的例子,它裝載一個bean並且設定/得到一個簡單的串參數。
BeanTest.jsp
<HTML>
<HEAD>
<TITLE>Reusing JavaBeans in JSP</TITLE>
</HEAD>
<BODY>
<CENTER>
<TABLE BORDER=5>
<TR><TH CLASS="TITLE">
Reusing JavaBeans in JSP</TABLE>
</CENTER>
<P>
<jsp:useBean id="test" class="hall.SimpleBean" />
<jsp:setProperty name="test"
property="message"
value="Hello WWW" />
<H1>Message: <I>
<jsp:getProperty name="test" property="message" />
</I></H1>
</BODY>
SimpleBean.java
以下是bean的原代碼:
package hall;
public class SimpleBean {
private String message = "No message specified";
public String getMessage() {
return(message);
}
public void setMessage(String message) {
this.message = message;
}
}
運行結果為:頁面輸出: Reusing JavaBeans in JSP
b>Message:Hello WWW
二、jsp:useBean 的詳細用法
最簡單的使用bean的方式是:
<jsp:useBean id="name" class="package.class"/>
為了裝載bean,需要用jsp:setProperty和 jsp:getProperty來修改和檢索bean的屬性。且,還有兩種別的選項。首先,您可以使用容器的格式,也就是:
<jsp:useBean ...>
Body
</jsp:useBean>
要指出的是,Body部分應該僅在bean第一次執行個體化時被執行,而不是在每次被找到和使用時。Beans能夠被共用,因此,並不是所有的jsp:useBean 陳述都產生一個新的bean的執行個體。其次,除了id 或class以外,還有三種屬性您可以使用:scope,type,和beanName。這些屬性總結如下:
屬性
用法
id
給一個變數命名,此變數將指向bean。如果發現存在一個具有相同的id和scope 的bean則使用之而不建立一個。
class
指出bean的完整的包名。
scope
指明bean在之上可以被使用的前後關係。有四個可能的值:page,request,session,和application。預設為page,表明bean僅在當前頁可用(儲存在當前的PageContext中)。request的一個值表明bean僅用於當前用戶端的請求(儲存在ServletRequest對象中)。Session的值指出在當前的HttpSession的生命週期內,對象對所有的頁面可用。 最後,application的值指出對象對所有共用ServletsContext的頁面可以使用。使用jsp:useBean 僅在沒有相同的id和scope 的bean時建立一個新的bean,如果已有則使用之,並忽略以jsp:useBean標誌開始和結尾的代碼。
type
指明將指向對象的變數的類型。這必須與類名相匹配或是一個超類或者是一個實作類別的介面。記住,變數的名由id屬性來指定。
beanName
賦予bean一個名字,您應該在Beans的執行個體化方法中提供。它允許您給出type和一個beanName,並省略類屬性。
三、jsp:setProperty Action
文法:
<jsp:setProperty
name="beanInstanceName"
{ property="*" |
property="propertyName" [ param="parameterName" ] |
property="propertyName" value="{string | <%= expression %>}"
}
/>
在前面我們就知道了可以使用 jsp:setProperty 來為一個bean的屬性賦值。您可以使用兩種方式實現它。其一是,在jsp:useBean後(而不是在之內)使用jsp:setProperty:
<jsp:useBean id="myName" ... />
...
<jsp:setProperty name="myName"
property="someProperty" ... />
在這種方式中,jsp:setProperty 將被執行無論是否已有一個具有相同的id和scope的bean存在。另一種方式是,jsp:setProperty出現在jsp:useBean 元素內,如:
<jsp:useBean id="myName" ... >
...
<jsp:setProperty name="myName"
property="someProperty" ... />
</jsp:useBean>
此種情況下,jsp:setProperty僅在新的對象被執行個體化時才執行。
以下是四種jsp:setProperty的可用的屬性:
屬性
用法
name
這是一個必選屬性。它指出哪一個bean的屬性將被設定。jsp:usebean必須出現在jsp:setProperty之前。
property
這是一個必選屬性。表明您將設定哪一個屬性。然而,有一個特殊的情況:如果以"*"為值意味著,所有的名稱與bean的屬性匹配的request參數都將被傳遞到相應的屬性設定方法。
value
這是一個可選屬性。它指定被設定的屬性的值。字串的值通過相應的對象或包的標準的valueOf方法將自動的轉換為numbers,boolean,Boolean,byte,Byte,char,和Character。例如,boolean或Boolean屬性的值“true”將通過Boolean.valueOf方法轉化,而,一個int或Integer屬性的值“42”將通過Integer.valueOf轉化。您不能同時使用value和param屬性,但,兩個都不用是允許的。
param
這是一個可選屬性。它指明了bean的屬性應該繼承的request的參數。如果當前的request沒有這樣的一個參數,就什麽也不做:系統並不將null傳給設定屬性的方法。因此,您可以使用bean的預設值。例如下面的這段程式執行“將numberOfItems屬性設定為任意numItems request參數的值,如果有這樣的一個request參數,否則什麼也不做。”
<jsp:setProperty name="orderBean"
property="numberOfItems"
param="numItems" />
如果您將value和param同時預設,這和您將param的名稱設為bean的屬性名稱相同一樣。您可以通過將name的值設定為”*”和省略value和param來自動的使用與bean的屬性相應的request的屬性。在這種情況下,伺服器將反覆的尋找可用的屬性和request參數來匹配具有相同名字的。
四、jsp:getProperty Action
文法:
<jsp:getProperty name="beanInstanceName" property="propertyName" />
這個屬性檢索出bean的屬性的值並將之轉化為一個字串,然後將之插入到輸出。它有兩個必選屬性:name,在之前用jsp:useBean引入的名稱,property,必須被插入值的屬性。