自定義標籤詳解2

開發傳統的自定義標籤

控制jsp頁面某一部分內容是否執行。

控制整個jsp頁面是否執行。

控制jsp頁面內容重複執行。

修改jsp頁面內容輸出。

由於傳統標籤使用三個標籤接口來完成不同的功能,顯得過於繁瑣,不利於標籤技術的推廣, SUN公司爲降低標籤技術的學習難度,在JSP 2.0中定義了一個更爲簡單、便於編寫和調用的SimpleTag接口來實現標籤的功能。實現SimpleTag接口的標籤通常稱爲簡單標籤。簡單標籤共定義了5個方法:

setJspContext方法

setParentgetParent方法

setJspBody方法

doTag方法

SimpleTag方法介紹

setJspContext方法

用於把JSP頁面的pageContext對象傳遞給標籤處理器對象 

setParent方法

用於把父標籤處理器對象傳遞給當前標籤處理器對象 

getParent方法

用於獲得當前標籤的父標籤處理器對象 

setJspBody方法

用於把代表標籤體的JspFragment對象傳遞給標籤處理器對象 

doTag方法

用於完成所有的標籤邏輯,包括輸出、迭代、修改標籤體內容等。在doTag方法中可以拋出javax.servlet.jsp.SkipPageException異常,用於通知WEB容器不再執行JSP頁面中位於結束標記後面的內容,這等效於在傳統標籤的doEndTag方法中返回Tag.SKIP_PAGE常量的情況。 

SimpleTag接口方法的執行順序

web容器開始執行標籤時,會調用如下方法完成標籤的初始化

WEB容器調用標籤處理器對象的setJspContext方法,將代表JSP頁面的pageContext對象傳遞給標籤處理器對象。

WEB容器調用標籤處理器對象的setParent方法,將父標籤處理器對象傳遞給這個標籤處理器對象。注意,只有在標籤存在父標籤的情況下,WEB容器纔會調用這個方法。

如果調用標籤時設置了屬性,容器將調用每個屬性對應的setter方法把屬性值傳遞給標籤處理器對象。如果標籤的屬性值是EL表達式或腳本表達式,則WEB容器首先計算表達式的值,然後把值傳遞給標籤處理器對象。

如果簡單標籤有標籤體,容器將調用setJspBody方法把代表標籤體的JspFragment對象傳遞進來。

執行標籤時:

容器調用標籤處理器的doTag()方法,開發人員在方法體內通過操作JspFragment對象,就可以實現是否執行、迭代、修改標籤體的目的。

JspFragment類 

javax.servlet.jsp.tagext.JspFragment類是在JSP2.0中定義的,它的實例對象代表JSP頁面中的一段符合JSP語法規範的JSP片段,這段JSP片段中不能包含JSP腳本元素。

WEB容器在處理簡單標籤的標籤體時,會把標籤體內容用一個JspFragment對象表示,並調用標籤處理器對象的setJspBody方法把JspFragment對象傳遞給標籤處理器對象。JspFragment類中只定義了兩個方法,如下所示:

getJspContext方法

用於返回代表調用頁面的JspContext對象.

public abstract void invoke(java.io.Writer out) 

用於執行JspFragment對象所代表的JSP代碼片段

參數out用於指定將JspFragment對象的執行結果寫入到哪個輸出流對象中,如果傳遞給參數out的值爲null,則將執行結果寫入到JspContext.getOut()方法返回的輸出流對象中。(簡而言之,可以理解爲寫給瀏覽器)

invoke方法詳解 

JspFragment.invoke方法是JspFragment最重要的方法,利用這個方法可以控制是否執行和輸出標籤體的內容、是否迭代執行標籤體的內容或對標籤體的執行結果進行修改後再輸出。例如:

在標籤處理器中如果沒有調用JspFragment.invoke方法,其結果就相當於忽略標籤體內容;

在標籤處理器中重複調用JspFragment.invoke方法,則標籤體內容將會被重複執行;

若想在標籤處理器中修改標籤體內容,只需在調用invoke方法時指定一個可取出結果數據的輸出流對象(例如StringWriter),讓標籤體的執行結果輸出到該輸出流對象中,然後從該輸出流對象中取出數據進行修改後再輸出到目標設備,即可達到修改標籤體的目的。

開發帶屬性的標籤

自定義標籤可以定義一個或多個屬性,這樣,在JSP頁面中應用自定義標籤時就可以設置這些屬性的值,通過這些屬性爲標籤處理器傳遞參數信息,從而提高標籤的靈活性和複用性。

要想讓一個自定義標籤具有屬性,通常需要完成兩個任務:

在標籤處理器中編寫每個屬性對應的setter方法

TLD文件中描術標籤的屬性

爲自定義標籤定義屬性時,每個屬性都必須按照JavaBean的屬性命名方式,在標籤處理器中定義屬性名對應的setter方法,用來接收JSP頁面調用自定義標籤時傳遞進來的屬性值。 例如屬性url,在標籤處理器類中就要定義相應的setUrl(String url)方法。

在標籤處理器中定義相應的set方法後,JSP引擎在解析執行開始標籤前,也就是調用doStartTag方法前,會調用set屬性方法,爲標籤設置屬性。

TLD中描述標籤屬性 attribute

元素名 是否必須指定 描      述

description 否 用於指定屬性的描述信息。

name 是 用於指定屬性的名稱。屬性名稱是大小寫敏感的,並且不能以jsp_jspjavasun開頭。

required 否 用於指定在JSP頁面中調用自定義標籤時是否必須設置這個屬性。其取值包括truefalse,默認值爲falsetrue表示必須設置,否則可以設置也可以不設置該屬性。

rtexprvalue 否 rtexprvalueruntime expression value(運行時表達式)的英文簡寫,用於指定屬性值是一個靜態值或動態值。其取值包括truefalse,默認值爲falsefalse表示只能爲該屬性指定靜態文本值,例如"123"true表示可以爲該屬性指定一個JSP動態元素,動態元素的結果作爲屬性值,例如JSP表達式<%=value %>

type  否 用於指定屬性值的Java類型。

<tag>元素的<attribute>子元素用於描述自定義

標籤的一個屬性,自定義標籤所具有的每個屬性

都要對應一個<attribute>元素 。

<attribute>

<description>description</description>

<name>aaaa</name>

<required>true</required>

<rtexprvalue>true</rtexprvalue>

<type>ObjectType</type>

</attribute>

打包自定義標籤庫

把自定義的標籤打到一個jar包中,就是要把標籤處理類的字節碼和標籤庫描述文件按照一定的存放方式添加到一個jar包中。具體做法如下。

把標籤處理類字節碼和標籤庫描述文件按如下所示的結構組織。

使用jar命令來創建jar文件:
jar cvf mytaglib_0.9.jar  META-INF  com

完成這兩個步驟之後,一個自定義標籤庫jar包就打好了,可以把它添加到任何想使用這個標籤庫的Web應用程序的WEB-INF/lib目錄下使用了。

自定義分頁標籤

分頁標籤的使用方式如下:
<q:pager pageNo="當前頁號" pageSize="每頁要顯示的記錄數" recordCount="總記錄數" url="要跳轉的URI" />

通過給這個標籤傳入當前頁號、每頁要顯示的記錄數、總記錄數和要跳轉的URI,這個標籤就可以生成翻頁的HTML元素。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章