struts自定义标签开发

     带body的自定义标签，尝试写一个标签，这个标签可以迭代显示标签主体里面的内容，迭代的次数由标签的属性指定.
     首先，要说明的是，其实标签也是一个java类，它是运行一个或两个接口的javabean,然后再配合标签描述文件(以.tld为扩展名)，两者结合就可以作出自己的自定义标签库了.呵呵，是不是觉得有点眉目了？
     那么下面我们开始写一个自己的java标签类，作为有body的标签，这个类必须实现javax.servlet.jsp.tagext.BodyTag接口.
下面我们看一下BodyTag这个接口中定义了那些方法来支持tag：

public void doInitBody();
public void setBodyContent(javax.servlet.jsp.tagext.BodyContent);
public int doAfterBody();

那么由于BodyTag继承了javax.servlet.jsp.tagext.Tag接口，所以我们再来看一下Tag中的方法：

 

public void release();
public javax.servlet.jsp.tagext.Tag getParent();
public void setParent(javax.servlet.jsp.tagext.Tag);
public int doEndTag();
public int doStartTag();
public void setPageContext(javax.servlet.jsp.PageContext);

说了这么多方法，是不是有点头晕了？呵呵，那么究竟BodyTag的处理过程是怎么样的呢？下面我们就来说一下它的处理流程：
1.当容器创建一个新的标签实例后，通过setPageContext来设置标签的页面上下文.
2.使用setParent方法设置这个标签的上一级标签，如果没有上一级嵌套，设置为null.
3.设置标签的属性，这个属性在标签库描述文件中定义，如果没有定义属性，就不调用此类方法.
4.调用doStartTag方法，这个方法可以返回EVAL_BODY_INCLUDE和SKIP_BODY，当返回EVAL_BODY_INCLUDE时，就计算标签的body，如果返回SKIP_BODY，就不再计算标签的body.
5.调用setBodyContent设置当前的BodyContent.
6.调用doInitBody，如果计算BodyContent时需要进行一些初始化，就在这个方法中进行.
7.每次计算完Body后调用doAfterBody，如果返回EVAL_BODY_TAG，表示继续计算一次Body，直到返回SKIP_BODY才继续往下执行.
8.调用doEndTag方法，这个方法可以返回EVAL_PAGE或者SKIP_PAGE，当返回EVAL_PAGE时，容器将在标签结束时继续计算JSP页面其他的部分；如果返回SKIP_PAGE，容器将在标签结束时停止计算JSP页面其他的部分.
9.调用release()方法释放标签程序占用的任何资源。
知道了标签处理的流程了，那么下面我们就开始写一个自己的java类了
我的标签类的源码：

package test.jsp.tags;

import javax.servlet.jsp.tagext.BodyTagSupport;
import javax.servlet.jsp.tagext.BodyContent;
import javax.servlet.jsp.JspTagException;

public class BodyTagExample extends BodyTagSupport
{
private int counts;

public BodyTagExample()
{
super ();
}
public void setCounts( int counts)
{
this .counts = counts;
}
public int doStartTag() throws JspTagException
{
System.out.println( " doStartTag... " );
if (counts > 0 )
{
return EVAL_BODY_TAG;
}
else
{
return SKIP_BODY;
}
}
public void setBodyContent(BodyContent bodyContent)
{
System.out.println( " setBodyContent... " );
this .bodyContent = bodyContent;
}
public void doInitBody() throws JspTagException
{
System.out.println( " doInitBody.... " );
}
public int doAfterBody() throws JspTagException
{
System.out.println( " do After body... " + counts);
if (counts > 1 )
{
counts -- ;
return EVAL_BODY_TAG;
}
else
{
return SKIP_BODY;
}
}
public int doEndTag() throws JspTagException
{
System.out.println( " do end Tag... " );
try
{
if (bodyContent != null )
{
bodyContent.writeOut(bodyContent.getEnclosingWriter());
}
}
catch (java.io.IOException e)
{
throw new JspTagException( " IO Error: " + e.getMessage());
}
return EVAL_PAGE;
}
}

写完了java类，下面我们该用一个描述文件来描述我们写的这个类了：
我的tld描述文件源码：

 

<? xml version="1.0" encoding="ISO-8859-1" ?>
<! DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"
http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd" >
< taglib >
< tlibversion > 1.0 </ tlibversion >
< jspversion > 1.1 </ jspversion >
< shortname > Application Tag Library </ shortname >
< uri > http://jakarta.apache.org/taglibs/struts-example-1.0 </ uri >
< info > tag loop </ info >
< tag >
< name > loop </ name >
< tagclass > test.jsp.tags.BodyTagExample </ tagclass >
< bodycontent > JSP </ bodycontent >
< attribute >
< name > counts </ name >
< required > true </ required >
< rtexprvalue > true </ rtexprvalue >
</ attribute >
</ tag >
</ taglib >

我们对这个文件进行一个小小的说明：
最重要的是上面的黑体字部分，其他的部分我们可以拷贝粘贴就可以了。
tag中的name属性：定义了我们的tag名称，在后面会用到。
tag中的tagclass属性：指定了我们这个tag的实现类。
tage中的bodycontent属性：指定我们的页面内容是什么性质的。(注意：在jsp开发中这里必须写JSP)
tage中的attribute属性：定义了我们的这个tag可能有的属性。
attribute中的name属性：指定了属性的名称。它和我们类中定义的“int counts;”必须一样，并且在类中还必须包含一个setCounts(int counts)方法，否则这个属性就不能设置。
attribute中的required属性：表示这个属性是否是必须的。
attribute中的rtexprvalue属性：表示这个属性是否可以用JSP的程序段的结果输出。
现在我们的tag就写完了，下面就是我们怎么在页面中用了。
首先，我们要在web.xml中声明这个tag
我的web.xml源码：

<? xml version="1.0" encoding="UTF-8" ?>
<! 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 > demotag </ taglib-uri >
< taglib-location > /WEB-INF/tld/mytag.tld </ taglib-location >
</ taglib >
</ web-app >

其次，我们要在页面中引用这个tag。
我的jsp源码：

<% @ page contentType = " text/html; charset=GBK " language = " java " %>
<% @ taglib uri = " demotag " prefix = " demo " %>
< html >
< body >
< br >
< demo:loop counts = " 5 " >
现在时间是： <%= new java.util.Date().toString() %>< br >
</ demo:loop >
< br >
</ body >
</ html >

 

如果要写没有标签体的自定义标签，直接继承 TagSupport,实现doStartTag,doEndStart就可以了。