JSP自定义标签（jsp1.2）
原文出自：http://www.blogjava.net/liuwentao253/archive/2006/11/17/81694.html
作者：刘文涛
一、概述
JSP中有一块重要的技术：自定义标签（Custom Tag） 。
1．优点：
取代了JSP中的Java程序，并且可以重复使用，方便不熟悉Java编程的网页设计人员。
2．开发流程：
（1） 编写JSP，在JSP中使用自定义标签。
（2） 在web.xml中指定JSP中使用的标签的.tld(标签库描述文件)文件的位置。也可不在web.xml中指定.tld文件
位置，而在jsp页面中指定。
（3）.tld文件中指定标签使用的类。
3. 自定义标签的分类：
（1）简单标签：如< mytag:helloworld/>
（2）带属性标签：如<imytag:checkinput dbname = “<myBean.getDBName()>”/>
（3）带标签体的标签：
在自定义标签的起始和结束标签之间的部分为标签体(Body)。Body的内容可以是JSP中的标准标签，也可以是HTML、脚本语言或其他的自定义标签。
<
mytag：checkinput dbname
=
“
<
myBean.getDBName()
>
”
>
<
mytag:log message
=
”Table Name”
>
<
mytag：checkinput
/>
（4） 可以被Script使用的标签：
定义了id和type属性的标签可以被标签后面的Scriptlet使用。
<
mytag:connection id
=
“oraDB” type
=
“DataSource” name
=
“Oracle”
>
<%
oraDB.getConnection();
%>
4．接口及其他
实际上，自定义标签的处理类实现了Tag Handler对象。
JSP技术在javax.servlet.jsp.tagext中提供了多个Tag Handler接口，
JSP1.2中定义了Tag、BodyTag、IterationTag接口，
在JSP2.0中新增了SimpleTag接口。
JSP 还提供了上述接口的实现类TagSupport、BodyTagSupport和SimpleTagSupport（SimpleTagSupport只 在JSP2.0中才有）。BodyTagSupport实现了BodyTag、Tag和IterationTag接口。
SimpleTag 这个类在servlet.jar下面是没有的，可以在D:\Tomcat5\common\lib\jsp-api.jar下找到。
接口及其方法
Tag接口 代码 ：
package javax.servlet.jsp.tagext;
public interface Tag {
// 表示不用处理标签体，直接调用doEndTag()方法。
int SKIP_BODY = 0 ;
// 忽略标签后面的JSP内容。
int SKIP_PAGE = 5 ;
// 表示需要处理标签体。
int EVAL_BODY_INCLUDE = 1 ;
// 处理标签后，继续处理JSP后面的内容。
int EVAL_PAGE = 6 ;
void setPageContext(javax.servlet.jsp.PageContext pageContext);
void setParent(javax.servlet.jsp.tagext.Tag tag);
javax.servlet.jsp.tagext.Tag getParent();
int doStartTag() throws javax.servlet.jsp.JspException;
int doEndTag() throws javax.servlet.jsp.JspException;
void release();
}
二、实验
1．试验介绍
下面的实验就是基于上述开发流程开发的。
（1）在JSP中指定taglib的uri：<%@ taglib uri="/helloworld" prefix="mytag" %>。
（2）在web.xml中配置tag-location:
<taglib>
<taglib-uri>/helloworld</taglib-uri>
<taglib-location>/WEB-INF/helloworld.tld</taglib-location>
</taglib>
注：也可不在web.xml中配置，在JSP中指定taglib的uri:<%@ taglib uri="WEB-INF/helloword.tld " prefix="mytag" %>。
（3）在helloworld.tld 文件中定义实现标签的处理类：
<short-name>mytag</short-name>
<tag>
<name>helloworld</name>
<tag-class>mytag.HelloWorldTag</tag-class>
<body-content>empty</body-content>
</tag>
( 4 ) 执行处理类mytag.HelloWorldTag的doStartTag和doEndTag方法，然后将结果输入到JSP中，和JSP中的内容一起输出。
实际上自定义标签和JSP中的其他的内容被WebServer一起编译成servlet。
2 ．开始实验
2．1．编写JSP
<%@ page contentType="text/html; charset=GBK" %> <%@ taglib uri="/helloworld" prefix="mytag" %> <html><head><title>jsp1</title></head> <body bgcolor="#ffffc0"> <h1>下面显示的是自定义标签中的内容</h1> <p></p> <mytag:helloworld></mytag:helloworld> </body> </html>
2．2．编写web.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!-- edited with XMLSPY v5 rel. 4 U (http: // www.xmlspy.com) by Williams (501) -->
<! DOCTYPE web - app PUBLIC " -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN "
" http://java.sun.com/dtd/web-app_2_3.dtd " >
<web-app>
<taglib>
<taglib-uri>/ helloworld</taglib-uri>
<taglib-location>/WEB-INF/helloworld.tld</taglib-location>
</taglib>
</web-app>
2．3 编写tld文件
<? xml version="1.0" encoding="ISO-8859-1" ?>
<! 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>
<short-name>mytag</short-name>
<tag>
<name>helloworld</name>
<tag-class>mytag.HelloWorldTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
2．4 编写标签实现类
package mytag;
import java.io.IOException;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
public class HelloWorldTag extends TagSupport{
public HelloWorldTag(){
}
public int doStartTag() throws JspTagException{
return EVAL_BODY_INCLUDE;
}
public int doEndTag() throws JspTagException{
try{
pageContext.getOut().write("Hello World");
}catch(IOException ex){
throw new JspTagException("错误");
}
return EVAL_PAGE;
}
}
2．5 执行效果
部署到Tomcat的WebApps目录下，启动Tomcat，输入：http://localhost:8080/myjsp/hello.jsp
“Hello World”就是我们定义的标签部分的处理类输出的结果。
2．6 注意：
这个试验我做了2天，总是报错，弄得很是灰心，开始时以为tld文件或web.xml文件配置不正确，但怎么也找不到原因。
今晚我终于找到原因了，是因为.class文件一定要放在classes文件夹中，我放到了lib中。
.jar或servlet文件要放在lib目录中，而.class要放在classes目录中，如果要放到lib目录中,必须把mytag中的文件打包成.jar文件，然后把mytag.jar放到lib目录中。
JSP1.2的自定义标签，在JSP2.0中xml文件的格式变了。
======================以下是自己补充的=======================================
JSP2.0的标签有更简单的定义
博客JSP简单标签 中
1、 JSP引擎调用标签处理器对象的setJspContext()，将JSP页面的pageContext()对象传递给标签处理器对象。
2、 JSP引擎调用setParent()，将父标签处理器对象传递给标签处理器对象。
3、 如果调用标签设置属性，容器将每个属性对应的setter()方法把属性值传递给标签处理器对象。
4、 如果有标签体，容器将标签体封装为JspFragment对象，然后调用setJspBody()将JspFragment对象传递给标签处理器对象。
5、 调用doTag()方法执行标签逻辑。