waysun一路陽光

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

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

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

1、修改web.xml文件，增加自定義標簽支持

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

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


3、創(chuàng)建標簽處理程序類 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ū)別:
* 主要看標簽處理類是否要讀取標簽體的內(nèi)容和改變標簽體返回的內(nèi)容，如果不需要就用TagSupport，否則就用BodyTagSupport
* 用TagSupport實現(xiàn)的標簽，都可以用BodyTagSupport來實現(xiàn)，因為BodyTagSupport繼承了TagSupport
*/
public class HelloWorldTag extends TagSupport {
private static final long serialVersionUID = 3174234039143531070L;
@Override
public int doStartTag() throws JspException {//這個方法不用所以直接返回值
return EVAL_BODY_INCLUDE;
}
@Override
public int doEndTag() throws JspException {//重點在這個方法上
try {
pageContext.getOut().write("Hello World!");//標簽的返回值
} catch (IOException ex) {
throw new JspTagException("錯誤");
}
return EVAL_PAGE;
}
}

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

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

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


4、最終測試頁面 hello.jsp