摘要:
標準的JSP 標記可以調用JavaBeans組件或者執行客戶的請求,這大大降低了JSP開發的復雜度和維護量。JSP技術也允許你自定義taglib,其實換句話說,taglib可以看成是對JSP標記的一種擴展,正如xml是對html的一種擴展一樣。taglib通常定義在tag標簽庫中,這種標簽庫存放著你自己定義的tag標簽。簡而言之,如果使用taglib,那么你可以設計自己的JSP標記!
一般來說,自定義tag標簽主要用于操作隱藏對象、處理html提交表單、訪問數據庫或其它企業級的服務,諸如郵件和目錄操作等等。自定義tag標簽的使用者一般都是那些對java編程語言非常精通,而且對數據訪問和企業級服務訪問都非常熟悉的程序員,對于HTML設計者來說,使得他可以不去關注那些較復雜的商業邏輯,而將精力放在網頁設計上。同時,它也將庫開發者和庫使用者進行合理分工,自定義tag標簽將那些重復工作進行封裝,從而大大提高了生產力,而且可以使得tag庫可用于不同的項目中,完美地體現了軟件復用的思想。
在這篇文章中,我們主要討論:
· 什么是自定義tag標簽?
· 怎么使用tag標簽?
o 聲明要使用的tag庫
o 找到與之對應的tag處理類
o tag標簽的類型
· 自定義tag標簽
o tag處理類
o tag庫描述
o tag標簽示例
o 帶屬性的tag
o 帶body的tag
o 定義了腳本變量的tag
o 具有協作關系的tag
· 自定義tag標簽
o 一個迭代tag的例子
o 一個模板tag庫
o tag處理類到底是怎樣被調用的?
什么是自定義的tag?
一個自定義的tag標簽是用戶定義的一種JSP標記。當一個含有自定義的tag標簽的JSP頁面被jsp引擎編譯成servlet時,tag標簽被轉化成了對一個稱為tag處理類的對象進行的操作。于是當JSP頁面被jsp引擎轉化為servlet后,實際上tag標簽被轉化成為了對tag處理類的操作。
自定義tag標簽有很多特色,諸如:
· 可以在JSP頁面中自定義tag標簽的屬性
· 訪問JSP頁面中的所有對象
· 可以動態地修改頁面輸出
· 彼此這間可以相互通信。你可以先創建一個JavaBeans組件,然后在一個tag中調用此JavaBeans組件,同時可以在另一個tag中調用它。
· tag允許相互嵌套,可以在一個JSP頁面中完成一些復雜的交互。
使用tag標簽
本節主要描述怎樣在JSP頁面中使用tag標簽,以及tag標簽的不同類型。
要使用tag標簽,JSP程序員必須做2件事:
· 聲明此tag標簽的tag庫
· 實現此tag標簽
聲明tag標簽所在的tag庫
如果要使用tag標簽,則應用JSP的taglib指示符來指定其tag庫(注意:taglib要在在使用此tag標簽之前聲明)
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %>
uri屬性定義了唯一的標簽庫描述(以下簡稱TLD),它可以是直接是tld文件名或一個獨一無二的名字。prefix是用來區別其它TLD中和本TLD中有重名的tag的一種手段。
TLD必須以.tld作為擴展名,并且存放在當前應用的WEB-INF目錄或其子目錄下。你可以通過它的文件名直接引用它,也可以通過別的方式間接地引用它。
以下taglib指示符直接引用一個TLD:
<%@ taglib uri=”/WEB-INF/tutorial-template.tld” prefix=”tt” %>
以下的taglib指示符通過一個邏輯名稱間接地引用一個TLD:
<%@ taglib uri=”/tutorial-template” prefix=”tt” %>
如果是間接引用TLD的話,那你必須還要在web.xml中定義此邏輯名稱與tld文件之間的映射,具體做法是在web.xml中加入一個名為taglib的元素:
<taglib>
<taglib-uri>/tutorial-template</taglib-uri>
<taglib-location>
/WEB-INF/tutorial-template.tld
</taglib-location>
</taglib>
實現此tag標簽
為了實現tag標簽,你有2種方法來存放tag處理類。一、讓tag處理類以.class的方式存放于當前應用的WEB-INF/class子目錄下,二、如果tag處理類是以JAR包的形式存在的話,那可以放在當前應用的WEB-INF/lib目錄下,如果tag處理類要在多個應用中共享,那么它就應放在jsp服務器上的common/lib目錄下,對于tomcat來說,就是tomcat/common/lib目錄下。
tag標簽類型
自定義的tag標簽遵循XML語法。它有一個開始標記和一個結束標記,有的還有body(即文本節點):
<tt:tag>
body
</tt:tag>
一個不帶body的tag標簽如下:
<tt:tag />
簡單的tag標簽
一個沒有body和屬性的tag標簽如下:
<tt:simple />
帶屬性的tag標簽
自定義標簽可以有自己的屬性。屬性一般在開始標記中定義,語法為 attr=”value”。屬性的作用相當于自定義標簽的一個參數,它影響著tag處理類的行為。你可以在TLD中詳細定義它。
你可以用一個String常量給一個屬性賦值,也可以通過表達式給它賦值,如<%= ...%>。以struts為例,它的logic:present標簽就是用的String常量來給屬性賦值:
<loglic:present parameter = “Clear”>
而另一個標簽logic:iterate是用表達式來給屬性賦值:
<logci:iterate collection=”<%= bookDB.getBooks() %>”
id=”book” type=”database.BookDetails”>
帶body的tag標簽
一個自定義標簽可以包含其它自定義標簽、腳本變量、HTML標記或其它內容。
在下述例子中,此JSP頁面使用了struts的logic:present標簽,如果些標簽定義了parameter=”Clear”的屬性,則將清除購物車的內容,然后打印出一條信息:
<logic:present parameter=”Clear”>
<% cart.clear(); %>
<font color=”#ff0000” size=”+2”><strong>
你選擇了清除購物車!
</strong></font>
</logic:present>
到底是用屬性還是用body來傳遞信息?
如上所述,我們既可以通過屬性,也可以通過body來傳遞信息。但一般來說,比較簡單的類型,如字符串或簡單表達式最好采用屬性來傳遞信息。
定義腳本變量的tag標簽
所謂腳本變量,是指JSP中可以調用的變量或對象。它可由tag標簽產生。以下示例闡述了一個tag標簽定義了一個名為tx的由JNDI所定義的事務處理對象。腳本變量可以是ejb對象、事務、數據庫連接等等:
<tt:lookup id=”tx” type=”UserTransaction” name=”java:comp/UserTransaction” />
<% tx.begin(); %>
...
具有協作關系的tag標簽
自定義tag標簽之間可以通過共享對象來實現協作。在下述例子中,標簽tag1創建了一個名為obj1的對象,在標簽tag2仍可以重復使用obj。
<tt:tag1 attr1=”obj1” value1=”value” />
<tt:tag2 attr1=”obj1” />
在以下這個例子當中,如果外層的tag標簽創建了一個對象,那么其內層的所有tag標簽都可以使用這個對象。由于這樣產生的對象沒有一個指定的名字,那么就可以將少重名的沖突。這個例子闡述了一系列協作的嵌套對象。
<tt:outerTag>
<tt:innerTag />
</tt:outerTag>
Tag處理類
Tag處理類必須實現Tag接口或BodyTag接口,不過現在一般都流行從TagSupport或BodyTagSupport類中繼承,這些類或接口都可以在javax.servlet.jsp.tagext包中找到。
當JSP引擎看到自己的JSP頁面中包含有tag標簽時,它會調用doStartTag方法來處理tag標簽的開頭,調用doEndTag方法來處理tag標簽的結束。
下表說明不同類型的tag所需要不同的處理過程:
Tag處理類的方法
Tag標簽類型
所調用的方法
基本標簽
doStartTag, doEndTag, release
帶屬性的標簽
doStartTag, doEndTag, set/getAttribute1...N, release
帶內容的標簽
doStartTag, doEndTag, release
帶內容的標簽,且內容重復循環
doStartTag, doAfterBody, doEndTag, release
帶內容的標簽,且內容與JSP交互
doStartTag, doEndTag, release, doInitBody, doAfterBody, release
一個tag處理類可以通過javax.servlet.jsp.PageContext來與JSP交互,通過javax.servlet.jsp.PageContext類,tag處理類可以訪問JSP中的request、session和application對像。
如果tag標簽是互相嵌套的,那內層的tag處理類可以通過它的parent屬性來訪問上層的tag處理類。
一般情況都將所有的tag處理類打成了JAR的包,以便于發布。
Tag庫描述(簡稱TLD)
Tag庫是用xml語言描述的,TLD包括了tag庫中所有tag標簽的描述,它一般用來被jsp服務器用來校驗tag的語法正確性,或者被jsp開發者用來開發新的標簽。
TLD的文件擴展名必須為.tld,而且必須放在當前WEB應用的WEB-INF目錄或其子目錄中。
一個TLD的內容的開頭必須遵守標準的XML開頭,用于描述DTD和xml的版本,例如:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "TLD必須以<taglib>來作為它的根元素,<taglib>的子元素如下表:
<taglib>的子元素
Element
Description
tlib-version
Tag庫的版本
jsp-version
Tag庫所需要的jsp的版本
short-name
助記符,tag的一個別名(可選)
uri
用于確定一個唯一的tag庫
display-name
被可視化工具(諸如Jbuilder)用來顯示的名稱(可選)
small-icon
被可視化工具(諸如Jbuilder)用來顯示的小圖標(可選)
large-icon
被可視化工具(諸如Jbuilder)用來顯示的大圖標(可選)
description
對tag庫的描述(可選)
listener
參見下面listener元素
tag
參見下面tag 元素
Listener元素
一個tag庫可能定義一些類做為它的事件偵聽類,這些類在TLD中被稱為listener 元素,jsp服務器將會實例化這些偵聽類,并且注冊它們。Listener元素中有一個叫listener-class的子元素,這個元素的值必須是該偵聽類的完整類名。
Tag元素
每個tag元素在tag庫中都要指出它的名字、類名、腳本變量、tag的屬性。其中腳本變量的值可以直接在TLD中定義或通過tag附加信息的類來取得。每個屬性描述了這個屬性是否可以省略,它的值是否可以通過<%= …%>這樣的JSP語法來獲得,以及屬性的類型。
每一個tag在TLD中對應一個tag元素,下表是tag元素的子元素:
Tag元素的子元素
元素名稱
描述
name
獨一無二的元素名
tag-class
Tag標簽對應的tag處理類
tei-class
javax.servlet.jsp.tagext.TagExtraInfo的子類,用于表達腳本變量(可選)
body-content
Tag標簽body的類型
display-name
被可視化工具(諸如Jbuilder)用來顯示的名稱(可選)
small-icon
被可視化工具(諸如Jbuilder)用來顯示的小圖標(可選)
large-icon
被可視化工具(諸如Jbuilder)用來顯示的大圖標(可選)
description
此tag標簽的描述
variable
提供腳本變量的信息(同tei-class)(可選)
attribute
Tag標簽的屬性名
以下章節介紹對于不同類型的tag,如何具體地實現它們。
簡單的tag
tag處理類
簡單的tag處理類必須實現Tag接口的doStartTag和doEndTag方法。當jsp引擎碰到tag標簽的開頭時,doStartTag被調用,因為簡單的tag沒有body,所以此方法將返回 SKIP_BODY。當jsp引擎碰到tag標簽的結尾時,doEndTag被調用,如果余下的頁面還要被計算,那它將返回EVAL_PAGE,否則將會返回SKIP_PAGE。
以下是例子:對于標簽 <tt:simple /> ,它的tag處理類實現如下:
public SimpleTag extends TagSupport
{
public int doStartTag() throws JspException
{
try{
pageContext.getOut().print(“Hello.”);
}catch(Exception e){
throw new JspTagException(“SimpleTag: “ + e.getMessage());
}
return SKIP_BODY;
}
public int doEndTag()
{
return EVAL_PAGE;
}
}
注意:如果tag標簽沒有內容的話,那必須定義body-content元素為空,例如
<body-content>empty</body-content>
帶屬性的tag標簽
tag處理類
對于tag標簽的每個屬性,你必須依照JavaBeans規范來定義其屬性,以及get和set方法。以struts的logic:present 標簽為例,
<logic:present parameter=”Clear”>
與此相應,此tag處理類應有如下方法和定義:
protected String parameter = null;
public String getParameter()
{
return this.parameter;
}
public void setParameter(String parameter)
{
this.parameter = parameter;
}
注意:如果你的屬性名為id,而且你的tag處理類是從TagSupport類繼承的,那你就不需要定義它的屬性和set和get方法,因為他們早已在TagSupport被定義過了。
Attribute元素
對于tag標簽的每個屬性,你必須定義它是否必須的,它的值是否可以用諸如<%= …%>的表達式來獲得,以及它的類型(可選),如果不指定它的類型,那就默認為是java.lang.String類型。如果rtexprvalue元素被定義為true或yes,那么在type元素中就定義了attribute的返回類型。
<attribute>
<name>attr1</name>
<required>true|false|yes|no</required>
<rtexprvalue>true|false|yes|no</rtexprvalue>
<type>attribute的返回類型(只用當rtexprvalue為真是才有效)</type>
</attribute>
如果tag的某個屬性不是必須的,那tag處理類會自動提供一個缺省值。
例如,在logic:present這個tag標簽中定義了一個屬性叫parameter,但它不是必須的,而且它可以被諸如<%= …%>的表達式來賦值。
<tag>
<name>present</name>
<tag-class>org.apache.struts.taglib.logic.PresentTag</tag-class>
<body-content>JSP</body-content>
…
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
…
</tag>
屬性元素的校驗
有關于tag標簽的有效值可以從tag庫的說明文檔中獲得,當JSP頁面被編譯時,jsp引擎會強制性地參照TLD中定義的規則進行檢查。
還有一個方法也可以進行屬性元素的校驗,就是先繼承類TagExtraInfo,然后調用它的isValid方法。這個類同時也起到提供tag中定義的腳本變量信息的作用。
IsValid方法通過TagData對象來傳遞屬性信息,它包括著tag的所有的屬性名-值的信息。由于校驗發生在運行時刻,因此這個屬性的值將被賦值為TagData.REQUEST_TIME_VALUE。
例如tag標簽<tt:twa attr1=”value1” />在TLD中定義如下:
<attribute>
<name>attr1</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
這個定義說明了attr1能在運行期間被賦值。
以下的isValid方法檢查attr1屬性的值是否屬于Boolean類型。注意由于attr1能在運行刻被賦值,那么isValid方法必須檢查tag用戶是否對此tag進行了運行時刻賦值。
Public class TwaTEI extends TagExtraInfo
{
public boolean isValid(Tagdata data)
{
Object o = data.getAttribute(“attr1”);
If(o != null && o != TagData.REQUEST_TIME_VALUE)
{
if( ( (String)o).toLowerCase().equals(“true”) ||?
((String)o).toLowerCase().equals(“false”) )
return true;
else
return false;
}
else
return true;
}
}
帶body的tag
tag處理類
如果tag標簽含有內容,那處理方式會略微有些不同,而且還要視tag處理類是否要與body交互的情況而定。如果要與body交互,那我們認為tag處理類要可能要對body進行操作。
Tag處理類不與body交互
如果tag處理類不與body交互,tag處理類應該實現Tag接口或從TagSupport中派生,如果body要被計算,那么doStartTag方法應返回 EVAL_BODY_INCLUDE,否則應返回SKIP_BODY。
如果tag處理類要對body反復運算,則它應該實現IterationTag或從TagSupport中派生。如果tag處理類認為body還未計算完的話,那它的doStartTag方法和doAfterBody方法必須返回EVAL_BODY_AGAIN。
Tag處理類與body交互
如果tag處理類與body交互,那tag處理類應實現BodyTag接口或從BodyTagSupport中派生。這種tag處理類一般要實現doInitBody和doAfterBody方法。
Body允許一些方法來讀寫它的內容。Tag處理類可以調用body內容的getString或getReader方法來從body中提取信息,也可用 writeOut(out) 方法來將body的內容寫入到out對象中。其中out對象通過tag處理類的getPreviousOut方法來獲得。
如果body的內容需要被計算,那么doStartTag方法必須返回EVAL_BODY_BUFFERED,否則,它將返回 SKIP_BODY。
doInitBody 方法
此方法在body內容已經設好,但未被計算之前被調用。你可以根據不同的body內容來制定初始化策略。
doAfterBody方法
此方法在body內容已被計算后進行調用。
和doStartTag方法一樣,doAfterBody方法返回一個指示符指示是否要繼續計算body,如果要繼續計算,則doAfterBody應返回EVAL_BODY_BUFFERED,否則,它應返回SKIP_BODY。
release 方法
tag處理類調用此方法將它的狀態重置為初始狀態,并釋放所有的私有資源。
以下的例子讀取body的內容(其中含有一條sql語句),然后將它傳遞給一個對象,讓它進行查詢。由于此處body不須重新計算,所以doAfterBody會返回SKIP_BODY。
Public class QueryTag extends BodyTagSupport
{
public int doAfterBody() throws JspTagException
{
BodyContent bc = getBodyContent();
//將body的內容以字符串的格式提取出來
String query = bc.getString();
//清除body
bc.clearBody();
try{
Statement stmt = connection.createStatement();
Result result = stmt.executeQuery(query);
}catch(SQLException e){
throw new JspTagException(“queryTag: “ + e.getMessage() );
return SKIP_BODY;
}
}
body-content元素
由于tag可能會有body,你必須用body-content元素來指定body內容的類型:
<body-content>JSP|tagdependent</body-content>
如果body的內容是定制的或內部的tag、腳本元素、或HTML廣本,則歸類為JSP類型。其他的類型,比如上面代碼所述的?D?D將sql statement類傳給 query tag的這種類型應該標為tagdependent。
注意:實際上body-content的值并不影響tag處理類對body內容的處理,它僅僅是被tag編輯工具用來描述此body的內容。
用tags定義腳本變量
tag處理類
tag處理類負責創建或設置頁面中定義的腳本變量,用pageContext.setAttribute(name,value,scope)或pageContext.setAttribute(name,value)方法來實現。一般來說,tag處理類通過腳本變量的名稱來獲取它,腳本變量的名稱一般可用get方法來獲得。
如果腳本變量的值依賴于tag處理類中的上下文中某一對象,那它可用pageContext.getAttribute(name,scope)方法來找到那個對象。一般的處理過程是tag處理類先找到腳本變量,再對其進行處理,然后用pageContext.setAttribute(name,object)的方法來設置它的新值。
對象的生存周期(scope)如下表:
對象的生存周期表
名字
可訪問范圍
生存周期
page
當前頁面
一直有效,除非頁面向客戶提交響應或重定向到一個新頁面
request
當前頁面或當前頁面重定向到的頁面
一直有效,除非頁面向客戶提交響應
session
當前頁面或在同一瀏覽器窗口中的頁面
一直有效,除非關閉當前瀏覽器、超時、網絡故障
application
整個web應用程序的所有請求
一直有效,除非發生網絡故障、服務器故障
提供關于腳本變量的信息
以下示例定義了一個名為“book”的腳本變量,用來訪問程序中關于書的信息:
<bean:define id=”book” name=”bookDB” property=”bookDetails” type=”database.BookDetails” />
<font color=”red” size=”+2” >
<%= messages.getString(“CartRemoved”) %>
<strong><jsp:getProperty name=”book” property=”title” /></strong>
</font>
當包含此tag的JSP頁面被編譯時,jsp引擎會自動生成關于此book的同步的代碼(同步可以避免幾個客戶同時訪問此book時造成的沖突),要生成同步代碼,jsp引擎需要知道此腳本變量的如下信息:
· 腳本變量名稱
· 腳本變量所屬的類
· 此腳本變量是否引用了一個新的或已存在的對象
· 此腳本變量的有效性
有兩種辦法可以向jsp引擎提供關于腳本變量的信息:在TLD中定義variable子元素,或用tei-class子元素定義一個額外tag信息類。用variable最簡單,但可能降低了一些靈活性。
Variable元素
Variable元素有如下子元素:
· name-given ?D?D 給出的名字,是一個常量
· name-from-attribute?D?D 屬性名,在編譯時給出的屬性名
name-given或name-from-attribute兩者必須選一,但以下子元素是可選的:
· variable-class?D?D變量的類型,缺省為java.lang.String。
· declare?D?D此腳本變量是否引用了一個新對象,缺省為True。
· scope?D?D腳本變量的范圍,缺省為NESTED。下表描述了scope的幾種類型:
腳本變量的有效范圍
值
有效性
方法
NESTED
在tag標簽的開始和結束之間
如果tag處理類實現BodyTag接口,則在doInitBody和doAfterBody中調用,否則在doStartTag中調用
AT_BEGIN
從tag標簽的開始一直到頁面結束
如果tag處理類實現BodyTag接口,則在doInitBody、doAfterBody和doEndTag中調用,否則在doStartTag和doEndTag中調用
AT_END
從tag標簽的結束一直到頁面結束
在doEndTag中調用
以struts為例,它的bean:define標簽的實現遵循JSP1.1規范,此規范要求使用額外tag信息類來定義腳本變量。Variable元素是JSP1.2規范中加入的。以bean:define標簽為例,你可以定義如下variable元素:
<tag>
<variable>
<name-from-attribute>id</name-from-attribute>
<variable-class>database.BookDetails</variable-class>
<declare>true</declare>
<scope>AT_BEGIN</scope>
</variable>
</tag>
額外tag信息類
如果要定義一個額外tag信息類,你要繼承javax.servlet.jsp.TagExtraInfo類。一個TagExtraInfo類必須實現getVariableInfo方法,此方法返回一個叫VariableInfo的數組類,它包括如下信息:
· 變量名
· 變量所屬類名
· 此變量是否引用了一個新對象
· 此變量的有效范圍
jsp引擎將一個名為data的參數傳給getVariableInfo方法,data中包括tag標簽中的所有“屬性名?D?D屬性值”對。它可以用來向VariableInfo對象提供腳本變量的名字和類名。
以struts為例,它在bean:define標簽中定義了一個名為DefineTei的額外tag信息類,用來向腳本變量提供信息。由于腳本變量的名稱(book)和類名(database.BookDetails)是通過tag標簽的屬性來傳遞的,它們一般定義在VariableInfo的構建代碼中,并且可用data.getAttributeString方法來得到這些信息。如果要允許book腳本變量能在從tag開始直到整個JSP頁面結束的范圍內都可用的話,那它的范圍應設為AT_BEGIN。如下所示:
public class DefineTei extends TagExtraInfo
{
public VariableInfo[] getVariableInfo(TagData data)
{
String type = data.getAttributeString(“type”);
If( type == null)
type = “java.lang.Object”;
return new VariableInfo[] {
new VariableInfo(data.getAttributeString(“id”),?
type,
true,
VariableInfo.AT_BEGIN)
};
}
}
注意:關于額外tag信息類的類名必須要在TLD中的tag標簽下的tei-class子元素中定義。因此,DefineTei的tei-class中的定義看起來如下:
<tei-class>
org.apache.struts.taglib.bean.DefineTagTei
</tei-class>
具有協作關系的tag
tag通過共享對象來進行協作,JSP技術支持2種方式的對象共享。
第一種方法是使用pageContext對象進行對象的共享(可支持JSP頁面和tag處理類之間的共享),如果在一個tag處理類中要調用由另一個tag處理類創建的對象,可調用pageContext.getAttribute(name, scope)方法。
第二各方式的共享是對于tag之間有嵌套關系而言的,外層的tag所創建的對象對于內層的tag來說是可以共用的。這種形式的共享的好處是減少了可能存在的重名沖突。
要訪問一個嵌套tag創建的對象,tag處理類必須先找到此嵌套tag對象,可用TagSupport的靜態方法 TagSupport.findAncestorWithClass(from, class)或TagSupport.getParent方法。前者在當不確定此tag是否為嵌套tag對象時使用。一旦它的父類被找到,它就能訪問其所有動態或靜態創建的對象。靜態創建的對象是父類的成員,而動態創建的對象可能是父類的私有對象。諸如此類的對象可以用tag處理類的setValue方法來保存,用getValue方法來獲得。
下例闡述了以上兩種共享對象的方法。在這個例子當中,一個查詢tag檢查一個名為connection的屬性名是否在doStartTag中被設置。如果connection屬性被設置,tag處理類從pageContext中得到這個connection對象。否則,此tag處理類先找到它的父tag處理類,然后從它的父tag處理類中找到connection對象。
public class QueryTag extends BodyTagSupport
{
private String connectionId;
public int doStartTag() throws JspException
{
String cid = getConnection();
if(cid != null)
{
//存在一個connection id,使用它。
connection = (Connection) pageContext.getAttribute(cid);
}
else
{
ConnectionTag ancestorTag = (ConnectionTag)findAncestorWithClass(this,?
ConnectionTag.class);
if(ancestorTag == null)
{
throw new JspTagException(“一個沒有connection屬性的查詢標簽必須被一個connection標記嵌套。”);
}
connection = ancestorTag.getConnection();
}
}
}?
此查詢標簽在JSP頁面中的調用形式可以從以下2種定義中任選一種:
<tt:connection id=”con01” ...> ... </tt:connection>
<tt:query id=”balances” connection=”con01” >
SELECT account, balance FROM acct_table
where customer_num = <%= request.getCustno() %>
</tt:query>
或
<tt:connection ...>
<x:query id=”balances”>
SELECT account, balance FROM acct_table
where customer_num = <%= request.getCustno() %>
</x:query>
</tt:connection>
與此同時,在TLD中必須指定connection屬性為可選的,定義如下:
<tag>
...
<attribute>
<name>connection</name>
<required>false</required>
</attribute>
</tag>
?