自定义标签之 带Body的标签库

在自定义标签之HelloWorld中用Tag和TagSupport实现了简单的HelloWorld，那么这篇记录带Body的标签开发，带有Body的Tag必须要实现javax.servlet.jsp.tagext.BodyTag接口，BodyTag接口中定义了一些处理标签体的方法 。
通过实现BodyTag接口，就可以方便地操作标签体，比如可以让标签体迭代多次等。BodyTag的处理过程如下：前4步与一般的标签体一样
1：当容器创建一个新的标签实例后，通过setPageContext设置标签的页面上下文。
2：使用setParent方法设置这个标签的上一级标签。如果没有上一级嵌套，设置为空。
3：设置标签的属性。这个属性在标签库描述文件中定义。如果没有定义属性就不调用此类方法。
4：调用 doStartTag方法，这个方法可以返回EVAL_BODY_INCLUDE和SKIP_BODY。当返回EVAL_BODY_INCLUDE时，就计算标签的BODY，如果返回SKIP_BODY，就不计算标签的BODY。
5：调用setBodyContent设置当前的BodyContent
6：调用doInitBody。如果在计算BodyContent时需要进行一些初始化，就在这个方法中进行。
7：每次计算完BodyTag后调用 doAfterBody。如果返回EVAL_BODY_TAG，表示继续计算一次BodyTag，直到返回SKIP_BODY才继续执行第 8 步。
8：调用doEndTag方法，这个方法可以返回EVAL_PAGE或者SKIP_PAGE。当返回 EVAL_PAGE时，容器在标签结束时继续计算JSP页面的其他部份，如果返回SKIP_PAGE，容器将在标签结果时停止计算JSP页面的其他部分。
9：调用release()方法释放标签程序占用的任何资源

好了，废话我也不希望多说，下面来一个实例：
A：标签的实现代码

package  eflylab;
import  javax.servlet.jsp. * ;
import  javax.servlet.jsp.tagext. * ;
import  java.util.Hashtable;
import  java.io.Writer;
import  java.io.IOException;

public   class  BodyTagExample  extends  BodyTagSupport
{
    int counts;//counts为迭代的次数。
    public BodyTagExample()
    {
        super();
    }
    
    /** *//**
     *设置counts属性。这个方法由容器自动调用。
     */
    public void setCounts(int c)
    {
        this.counts=c;
    }
    
    /** *//**
     *覆盖doStartTag方法
     */
     public int doStartTag() throws JspTagException  
     {   
         System.out.println("doStartTag");
         if(counts>0) 
         { 
             return EVAL_BODY_TAG;
         } 
         else 
         { 
              return SKIP_BODY;
         } 
    }
    
    /** *//**
     *覆盖doAfterBody方法
     */
    public int doAfterBody() throws JspTagException 
    { 
        System.out.println("doAfterBody"+counts);
        if(counts>1)
        {
            counts--;
            return EVAL_BODY_TAG; 
         }  
         else
         { 
            return SKIP_BODY; 
         } 
    }
    
   /** *//**
     *覆盖doEndTag方法
     */
    public int doEndTag() throws JspTagException 
    {
         System.out.println("doEndTag");
        try 
        {  
             if(bodyContent != null)  
             {
                 bodyContent.writeOut(bodyContent.getEnclosingWriter()); 
             }
        } 
        catch(java.io.IOException e)
        {
            throw new JspTagException("IO Error: " + e.getMessage());  
        }   
        return EVAL_PAGE;  
    }
    
     public void doInitBody() throws JspTagException{
      System.out.println("doInitBody");
     }
     public void setBodyContent(BodyContent bodyContent) 
     {   
          System.out.println("setBodyContent");
          this.bodyContent=bodyContent; 
          
     }
        
        
}

每次计算 完Body时，都会调用 doAfterBody方法。
B:标签描述文件mytag.tld中加入

    < tag >     
         < name > loop </ name >
         < tag-class > eflylab.BodyTagExample </ tag-class >
         < body-content > jsp </ body-content > <!--  必须为jsp  -->
         < attribute >
               < name > counts </ name > <!--  这个是我们资源源文件中的属性，同时源文件中必须要有setCounts(int counts)方法  -->
               < required > true </ required > <!--  必需要给定  -->
               < rtexprvalue > true </ rtexprvalue >
           </ attribute >
     </ tag >

C:测试页面

<% @ taglib uri="/demotag" prefix="bodytag"  %>
< html >
< head >
< title > body tag </ title >
< meta  http-equiv ="Content-Type"  content ="text/html; charset=gb2312" >
</ head >
< body >
  < HR >
  < bodytag:loop  counts ="5" >  
   现在的时间是：  <% = new  java.util.Date() %> < BR >
</ bodytag:loop >  
  < HR >   
  </ BODY >   
</ HTML >

运行：

同时控制台：

这里打印的内容就是调用标签中方法的顺序。可以看出除了doAfterBody外，其他方法都只调用了一次。doAfterBody在每次循环完后都会调用。