waysun一路陽(yáng)光

JSP自定義標(biāo)簽。在自定義標(biāo)簽的起始和結(jié)束標(biāo)簽之間的部分為標(biāo)簽體(Body)。
標(biāo)簽處理程序類：定義標(biāo)簽的行為，并在JSP引擎遇到自定義標(biāo)簽時(shí)調(diào)用執(zhí)行。
標(biāo)簽庫(kù)描述符（TLD）文件：描述標(biāo)簽庫(kù)的XML文檔，向JSP引擎提供有關(guān)自定義標(biāo)簽的標(biāo)簽處理程序的信息。tag標(biāo)簽相關(guān)屬性：實(shí)現(xiàn)簡(jiǎn)單標(biāo)簽處理程序 標(biāo)簽處理程序是一個(gè)在運(yùn)行時(shí)調(diào)用的Java類,它包含在 JSP文件中使用的自定義標(biāo)簽的實(shí)現(xiàn)代碼.標(biāo)簽處理程序必須實(shí)現(xiàn)或擴(kuò)展javax.servlet.jsp.tagext包中的類和接口.javax.servlet.jsp.tagext含有允許標(biāo)簽處理程序類與JSP容器通信的接口和類。

最近在項(xiàng)目中要用到這種技術(shù)，所以自己就寫一個(gè)經(jīng)典的HelloWorld實(shí)例：
其實(shí)對(duì)自定義標(biāo)簽已經(jīng)早有接觸了（Struts中使用了很多自定義標(biāo)簽，如html、bean等）
使用這種技術(shù)的優(yōu)點(diǎn)：取代了JSP中的Java程序，并且可以重復(fù)使用，方便不熟悉Java編程的網(wǎng)頁(yè)設(shè)計(jì)人員

實(shí)現(xiàn)步驟：
首先啟動(dòng)eclipse，新建一個(gè)web項(xiàng)目（廢話...）

1、修改web.xml文件，增加自定義標(biāo)簽支持

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<jsp-config>
<taglib>
<taglib-uri>/tld/helloworld</taglib-uri>
<taglib-location>/WEB-INF/tlds/helloworld.tld</taglib-location>
</taglib>
</jsp-config>
</web-app>

2、創(chuàng)建標(biāo)簽庫(kù)TLD文件 tlds\helloworld.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">
<taglib>
<tlib-version>1.0</tlib-version><!-- 標(biāo)簽庫(kù)的版本 -->
<jsp-version>1.2</jsp-version><!-- 這個(gè)標(biāo)簽庫(kù)要求的JSP規(guī)范版本 -->
<short-name>mytag</short-name><!-- JSP頁(yè)面編寫工具可以用來(lái)創(chuàng)建助記名的可選名字 -->
<tag>
<name>helloworld</name><!-- 唯一標(biāo)簽名 -->
<tag-class>com.yd.mytag.HelloWorldTag</tag-class><!-- 標(biāo)簽HelloWorldTag類的完全限定名 -->
<body-content>empty</body-content><!-- 正文內(nèi)容類型 -->
</tag>
</taglib>

這里注意：web.xml和xxx.tld這兩個(gè)XML文件的頭信息的版本匹配很重要，否則會(huì)導(dǎo)致頁(yè)面報(bào)錯(cuò)找不到標(biāo)簽


3、創(chuàng)建標(biāo)簽處理程序類 HelloWorldTag（重寫doStartTag和doEndTag方法）

package com.yd.mytag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspTagException;
import javax.servlet.jsp.tagext.TagSupport;
/**
* TagSupport與BodyTagSupport的區(qū)別:
* 主要看標(biāo)簽處理類是否要讀取標(biāo)簽體的內(nèi)容和改變標(biāo)簽體返回的內(nèi)容，如果不需要就用TagSupport，否則就用BodyTagSupport
* 用TagSupport實(shí)現(xiàn)的標(biāo)簽，都可以用BodyTagSupport來(lái)實(shí)現(xiàn)，因?yàn)锽odyTagSupport繼承了TagSupport
*/
public class HelloWorldTag extends TagSupport {
private static final long serialVersionUID = 3174234039143531070L;
@Override
public int doStartTag() throws JspException {//這個(gè)方法不用所以直接返回值
return EVAL_BODY_INCLUDE;
}
@Override
public int doEndTag() throws JspException {//重點(diǎn)在這個(gè)方法上
try {
pageContext.getOut().write("Hello World!");//標(biāo)簽的返回值
} catch (IOException ex) {
throw new JspTagException("錯(cuò)誤");
}
return EVAL_PAGE;
}
}

補(bǔ)充：
doStartTag()方法是遇到標(biāo)簽開始時(shí)會(huì)呼叫的方法，其合法的返回值是EVAL_BODY_INCLUDE與SKIP_BODY,前者表示將顯示標(biāo)簽間的文字，后者表示不顯示標(biāo)簽間的文字
doEndTag()方法是在遇到標(biāo)簽結(jié)束時(shí)呼叫的方法，其合法的返回值是EVAL_PAGE與SKIP_PAGE，前者表示處理完標(biāo)簽后繼續(xù)執(zhí)行以下的JSP網(wǎng)頁(yè)，后者是表示不處理接下來(lái)的JSP網(wǎng)頁(yè)
doAfterBody(),這個(gè)方法是在顯示完標(biāo)簽間文字之后呼叫的，其返回值有EVAL_BODY_AGAIN與SKIP_BODY，前者會(huì)再顯示一次標(biāo)簽間的文字，后者則繼續(xù)執(zhí)行標(biāo)簽處理的下一步

EVAL_BODY_INCLUDE：把Body讀入存在的輸出流中，doStartTag()函數(shù)可用
EVAL_PAGE：繼續(xù)處理頁(yè)面，doEndTag()函數(shù)可用
SKIP_BODY：忽略對(duì)Body的處理，doStartTag()和doAfterBody()函數(shù)可用
SKIP_PAGE：忽略對(duì)余下頁(yè)面的處理，doEndTag()函數(shù)可用
EVAL_BODY_BUFFERED：申請(qǐng)緩沖區(qū)，由setBodyContent()函數(shù)得到的BodyContent對(duì)象來(lái)處理tag的body，如果類實(shí)現(xiàn)了BodyTag，那么doStartTag()可用，否則非法
EVAL_BODY_AGAIN：請(qǐng)求繼續(xù)處理body，返回自doAfterBody()，這個(gè)返回值在你制作循環(huán)tag的時(shí)候是很有用的。

預(yù)定的處理順序是：doStartTag()返回SKIP_BODY,doAfterBodyTag()返回SKIP_BODY,doEndTag()返回EVAL_PAGE.
如果繼承了TagSupport之后，如果沒(méi)有改寫任何的方法，標(biāo)簽處理的執(zhí)行順序是：doStartTag() ->不顯示文字 ->doEndTag()->執(zhí)行接下來(lái)的網(wǎng)頁(yè)
如果您改寫了doStartTag(),則必須指定返回值，如果指定了EVAL_BODY_INCLUDE,則執(zhí)行順序是：doStartTag()->顯示文字->doAfterBodyTag()->doEndTag()->執(zhí)行下面的網(wǎng)頁(yè)


4、最終測(cè)試頁(yè)面 hello.jsp