waysun一路陽光

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

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

實現步驟：
首先啟動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、創建標簽庫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規范版本 -->
<short-name>mytag</short-name><!-- JSP頁面編寫工具可以用來創建助記名的可選名字 -->
<tag>
<name>helloworld</name><!-- 唯一標簽名 -->
<tag-class>com.yd.mytag.HelloWorldTag</tag-class><!-- 標簽HelloWorldTag類的完全限定名 -->
<body-content>empty</body-content><!-- 正文內容類型 -->
</tag>
</taglib>

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


3、創建標簽處理程序類 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的區別:
* 主要看標簽處理類是否要讀取標簽體的內容和改變標簽體返回的內容，如果不需要就用TagSupport，否則就用BodyTagSupport
* 用TagSupport實現的標簽，都可以用BodyTagSupport來實現，因為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()方法是在遇到標簽結束時呼叫的方法，其合法的返回值是EVAL_PAGE與SKIP_PAGE，前者表示處理完標簽后繼續執行以下的JSP網頁，后者是表示不處理接下來的JSP網頁
doAfterBody(),這個方法是在顯示完標簽間文字之后呼叫的，其返回值有EVAL_BODY_AGAIN與SKIP_BODY，前者會再顯示一次標簽間的文字，后者則繼續執行標簽處理的下一步

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

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


4、最終測試頁面 hello.jsp