自定義標籤
自定義標籤主要用於移除Jsp頁面中的java代碼
快速入門:使用自定義標籤輸出客戶機的IP
移除jsp頁面中的java代碼,只需要完成兩個步驟:
編寫一個實現Tag接口的Java類,並覆蓋doStartTag方法,把jsp頁面中的java代碼寫到doStartTag方法中。
編寫標籤庫描述符(tld)文件,在tld文件中對自定義標籤進行描述。
完成以上操作,即可在JSP頁面中導入和使用自定義標籤。
查看tag接口api文檔,分析自定義標籤的執行流程。
自定義標籤的創建步驟:
(1) 標籤處理器——java類,實現Tag接口
(2) 編寫.tld:
JSP頁面中使用自定義標籤
<dhw:aaa>
<dhw:viewIP>系統自動調用doStartTag()
</dhw:viewIP>系統自動調用doEndTag()
</dhw:aaa>
Tag接口的執行流程
JSP引擎將遇到自定義標籤時,首先創建標籤處理器類的實例對象,然後按照JSP規範定義的通信規則依次調用它的方法。
1、public void setPageContext(PageContext pc), JSP引擎實例化標籤處理器後,將調用setPageContext方法將JSP頁面的pageContext對象傳遞給標籤處理器,標籤處理器以後可以通過這個pageContext對象與JSP頁面進行通信。
2、public void setParent(Tag t),setPageContext方法執行完後,WEB容器接着調用的setParent方法將當前標籤的父標籤傳遞給當前標籤處理器,如果當前標籤沒有父標籤,則傳遞給setParent方法的參數值爲null。
3、public int doStartTag(),調用了setPageContext方法和setParent方法之後,WEB容器執行到自定義標籤的開始標記時,就會調用標籤處理器的doStartTag方法。
4、public int doEndTag(),WEB容器執行完自定義標籤的標籤體後,就會接着去執行自定義標籤的結束標記,此時,WEB容器會去調用標籤處理器的doEndTag方法。
5、public void release(),通常WEB容器執行完自定義標籤後,標籤處理器會駐留在內存中,爲其它請求服務器,直至停止web應用時,web容器纔會調用release方法。
自定義標籤功能擴展
自定義標籤除了可以移除Jsp頁面中的java代碼外,它還可以用於完成一些頁面邏輯,例如:
通過自定義標籤可以控制jsp頁面某一部分內容是否執行。
例如:<c:if>標籤
通過自定義標籤可以控制標籤後的jsp頁面是否執行。
通過自定義標籤可以控制jsp頁面某一部分內容重複執行。
例如:<c:foreach>標籤
通過自定義標籤可以修改jsp頁面內容輸出。
tld文件中的四種標籤體類型
EMPTY JSP scriptless tagdepentend
簡單標籤
由於傳統標籤使用三個標籤接口來完成不同的功能,顯得過於繁瑣,不利於標籤技術的推廣, SUN公司爲降低標籤技術的學習難度,在JSP 2.0中定義了一個更爲簡單、便於編寫和調用的SimpleTag接口來實現標籤的功能。實現SimpleTag接口的標籤通常稱爲簡單標籤。簡單標籤共定義了5個方法:
setJspContext方法
setParent和getParent方法
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),讓標籤體的執行結果輸出到該輸出流對象中,然後從該輸出流對象中取出數據進行修改後再輸出到目標設備,即可達到修改標籤體的目的。