自定义标签【迭代标签】

如果我们要开发出这样的标签，一般需要二个开发类，一具类实现BodyTagSupport接口，另一个类扩展TagExtraInfo类。TagExtraInfo旨在提供标签运行时的信息。

 

IterateTag.java

package com.randy.tag; 

import java.io.IOException; 
import java.util.Collection; 
import java.util.Iterator; 

import javax.servlet.jsp.JspException; 
import javax.servlet.jsp.tagext.BodyTagSupport; 

public class IterateTag extends BodyTagSupport { 

  private String name;// 一个属性名 
  private Iterator it;//要迭代的对象 
  private String type ;//it中对象的类型 
    
  public void setCollection(Collection collection){ 
    it =collection.iterator(); 
  } 
    
  @Override 
  public int doEndTag() throws JspException { 
        try { 
          if(bodyContent != null){ 
          bodyContent.writeOut(bodyContent.getEnclosingWriter()); 
          } 
        } catch (IOException e) { 
          e.printStackTrace(); 

        } 
    return    EVAL_PAGE; 
  } 

  @Override 
  public int doStartTag() throws JspException { 

    if(it == null){ 
      return SKIP_BODY; 
        
    }else{ 
      return continueNext(); 
    } 
  } 

  private int continueNext() { 
    if(it.hasNext()){ 
      pageContext.setAttribute(name, it.next(),pageContext.PAGE_SCOPE); 
      return EVAL_BODY_TAG; 
    }else{ 
        
      return SKIP_BODY; 
    } 
  } 
@Override 
  public int doAfterBody(){     
    return continueNext(); 
  } 

public String getName() { 
  return name; 
} 

public void setName(String name) { 
  this.name = name; 
} 

public String getType() { 
  return type; 
} 

public void setType(String type) { 
  this.type = type; 
} 
    
} 

 

由于BodyTagSupport类实现了IteratorTag接口，所以在开发迭代标签时，可以直接从BodyTagSupport类继承，IterateTag就是从BodyTagSupport类继承的例子。在IterateTag中，有3个属性，它们是name,type和it。name代表了在pageContext中标识的一个属性的名字;type代表了待迭代的内容的类型；it代表了要迭代的内容。在IterateTag中必须提供这些属性的setter方法，并且在JSP中使用这些属性时必须提供对应的值。
在doStartTag方法中，如果it不为null,那么就进行第一次迭代。在continueNext方法中如果it还有下一个，那么就继续迭代，如果没有下一个了，就返回SKIP_BODY，表示不再迭代。
除了上面的标签类外，还需要开发一个表示标签信息的类，如下
IterateTEI.java

package com.randy.tag; 

import javax.servlet.jsp.tagext.*; 
//TagExtraInfo用于提供一些在标签翻译时相关的信息。 
public class IterateTEI extends TagExtraInfo 
{ 
    public IterateTEI() 
    { 
            super(); 
    } 
     
    public VariableInfo[] getVariableInfo(TagData data) 
    { 
            return new VariableInfo[] 
            { 
                    new VariableInfo( 
                            data.getAttributeString("name"), 
                            data.getAttributeString("type"), 
                            true, 
                            VariableInfo.NESTED 
                    ), 
            }; 
    } 
}

Part 8 TagExtraInfo 和 VariableInfo
这两个类结合使用的目的是，在标签外部获取标签处理类中保存在页面的对象。该对象如果是JavaBean，则可以直接用<jsp:getProperty name=”id” property=”xxx”>取得该javabean的属性值，id是所保存的页面对象对应的变量名。标签外部包括：<prefix:mytag>开始到Page结束的范围，</prefix:mytag>开始到Page结束的范围，<prefix:mytag>和</prefix:mytag>中间的范围。
TagExtraInfo类最重要的一个方法是
public VariableInfo[] getVariableInfo(TagData data)
功能是返回所有的与此TagExtraInfo相关联的标签定义类里的变量信息。
VariableInfo类的构造函数
public VariableInfo(String ID,String ClassName,Boolean Declare, int Scope)
ID表示变量名称
ClassName表示类的名称
Declare表示之前是否申明过
Scope表示变量的使用范围：VariableInfo.AT_BEGIN表示从标签起始位置到Page结束，VariableInfo.AT_END表示标签结束位置到Page结束，VariableInfo.NESTED表示标签起止中间的范围。

 

 

使用：

<% 
List list = new ArrayList(); 
list.add("天龙八部"); 
list.add("神雕侠侣"); 
list.add("射雕英雄传"); 

request.setAttribute("list",list); 
%> 

<myTag:iterateTag name="book" type="String" collection="<%=list%>"> 
  <%=book.toString() %> 
</myTag:iterateTag>

 

本文转自 randy_shandong 51CTO博客，原文链接：http://blog.51cto.com/dba10g/282616，如需转载请自行联系原作者