怎樣自己定制標簽(Custom Tag)
(整理的學習筆記)
步驟1、創建一個Tag handler class(標記處理器類)
package javax.servlet.jsp.tagext
開發空Body的標簽處理器類----->1)implements Tag 2)extends TagSupport
空Body的標簽處理器類需要覆蓋方法:
doStartTag()
返回值:Tag.SKIP_BODY
doEndTag()
返回值:
1)Tag.EVAL_PAGE:讓標簽下面的內容繼續執行
2)Tag.SKIP_PAGE:讓標簽下面的內容不執行
開發帶Body的標簽處理器類----->1)implements BodyTag 2)extends BodyTagSupport
帶Body的標簽處理器類需要覆蓋方法
doStartTag()
返回值:
BodyTag.SKIP_BODY:執行後直接調用doEndTag()方法
BodyTag.EVAL_BODY_INCLUDE:執行後直接調用doAfterBody()方法
BodyTag.EVAL_BODY_BUFFERED:
doEndTag()
返回值:
BodyTag.EVAL_PAGE:標簽下面的內容繼續執行
BodyTag.SKIP_PAGE:標簽下面的內容不執行
doAfterBody()
返回值:
BodyTag.SKIP_BODY:執行後調用doEngTag()方法
BodyTag.EVAL_BODY_AGAIN:執行後調用doAfterBody()方法
步驟2、創建一個tld文件(tag library descriptor)
一個XML格式的文件,用於對標記進行描述
通常放在WEB-INF目錄下 (/WEB-INF/*.tld)
abc.tld
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<!-- template test -->
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>tagSample</short-name>
<uri>/tagSample</uri>
<description>A blank tag library template.</description>
<tag>
<name>welcome</name>
<tag-class>tagapp.HelloTag</tag-class>
<body-content>empty</body-content>
<display-name>my first tag</display-name>
<small-icon> </small-icon>
<large-icon> </large-icon>
<description> </description>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<type>java.lang.String</type>
</attribute>
</tag>
</taglib>
步驟3.創建一個JSP文件
<%@taglib uri="[tld_url]" prefix=""%>
<%@taglib uri="/WEB-INF/abc.tld" prefix="mike"%>
...
<mike:welcome name=""/>
uri的值可以是:
A、/WEB-INF/mytag.tld -----> uri="/WEB-INF/mytag.tld"
B、tld文件中 <uri>/tagSample</uri> ------> uri="/tagSample"
C、利用web.xml文件映射tld文件與taglib-uri的值 -----> uri="/abc"
<taglib>
<taglib-uri>/abc</taglib-uri>
<taglib-location>/WEB-INF/mytag.tld</taglib-location>
</taglib>
帶Body的標簽處理器類的方法的注釋:
doStartTag()
return value: SKIP_BODY 空BODY標記
EVAL_BODY_INCLUDE 帶BODY標記,執行流程進入doAfterBody
EVAL_BODY_BUFFERED 帶BODY標記,執行流程進入setBodyContent
doEndTag()
return value: SKIP_PAGE 忽略標記後剩余的JSP內容
EVAL_PAGE 繼續執行標記後剩余的JSP內容
doAfterBody()
return value: SKIP_BODY 結束doAfterBody()方法,流程進入doEndTag()
EVAL_BODY_AGAIN 繼續執行doAfterBody()方法
SimpleTagSupport
較好的練習題:
一、
1、模仿jstl標簽庫開發下列標簽:
1)<sql:setDataSource>
屬性有:
driver:必須的,可以用表達式
url;必須的,可以用表達式
user:必須的,可以用表達式
password:必須的,可以用表達式
2)<sql:query>
屬性有:
dataSource:必須的,可以用表達式
sql:必須的,可以用表達式
3)<sql:update>
屬性有:
dataSource:必須的,可以用表達式
sql:必須的,可以用表達式
2、開發類似於<c:forEach>的標簽,可以遍歷一個集合對象(可選,如不能完成,可直接利用jstl的標簽來完成)