Tom小猫，让我看清你的五脏六腑5（转）

Tom小猫，让我看清你的五脏六腑5（转）

2007-01-29 19:53

自定义JSP标签库
此技术在JSP 1.1版本中才出现，用来重用某些复杂的逻辑运算和事务，或定义JSP王爷的输出内容和格式。制作一个完整的自定义标签程序，包含3个步骤：

1. 创建标签的处理类
此类必须扩展javax.servlet.jsp.TagSupport类或者javax.servlet.jsp.BodyTagSupport类。
以TagSupport类为例，先了解一下这个类的主要方法：
doStartTag()－JSP容器遇到自定义标签的起始标志时调用该方法；
doEndTag()－JSP容器遇到自定义标签的结束标志时调用该方法；
setValue(String k,Object o)－在标签处理类中设置key/value;
getValue(String k)－在标签处理类中根据key返回匹配的value;
removeValue(String k)－在标签处理类中删除key/value;
setPageContext(PageContext pc)－设置PageContext对象，该方法在调用doStartTag()和doStartTag()前调用；
setParent(Tag t)－设置嵌套当前标签的上层标签的处理类，该方法在调用doStartTag()和doStartTag()前调用；
getParent()－返回嵌套当前标签的上层标签的处理类。

首先调用setPageContext(PageContext pc)和setParent(Tag t)，设置TagSupport类的两个重要属性值。

如果遇到起始标志，调用doStartTag()，此方法返回一个整数值，它有两个可选值：Tag.SKIP_BODY(标签之间的内容被忽略)和Tag.EVAL_BODY_INCLUDE(标签之间的内容正常执行)。
例如：<prefix:mytag>test</prefix:mytag>，如果遇上Tag.SKIP_BODY，test字符串不会显示在页面上；如果遇上Tag.EVAL_BODY_INCLUDE，test字符串将会显示在页面上。

如果遇到结束标志，调用doEndTag()，此方法也返回一个整数值，它有两个可选值：Tag.SKIP_PAGE(表示立刻停止执行JSP页面，网页上未处理的静态内容和JSP程序均别忽略，任何已有的输出内容立刻返回到客户端；)和Tag.EVAL_PAGE(表示按正常流程继续执行JSP页面)。

如果自定义标签包含自定义的属性，例如：<prefix:mytag attribute1="value1">，那么处理类中应该将这个属性做为成员变量，并提供一组get和set方法：
private int attribute1;
public void setAttribute1(int value){
 this.attriubte1 = value;
}
public int getAttribute1(){
 return attribute1;
}

下面是一个用来验证用户登陆的标签处理类例子：

public class ValidateLoginTag extends TagSupport{
    private String name;
    private String password;
    private Log log = LogFactory.getLog(ValidateLoginTag.class);

    public int doEndTag() throws JspException{

       if(name.equals("pepsixp") && password.equals("888888")){
              return(EVAL_PAGE);
          }
        return (SKIP_PAGE);
    }

    public String getName() {
        return name;
    }

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

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

2.创建TLD－Tag Library Descriptor(标签库描述文件)
TLD文件中元素可以分为三类：<tablib>、<tag>、<attribute>
<tablib>－设定标签库的相关信息，包含的子元素有tlibversion、jspversion、shortname、uri、info、tag。
<tag>－用来定义一个标签，包含的子元素有name、tagcalss、bodycontent、info、attribute。
bodycontent的说明：有三个可选值empty、JSP、tagdependent，empty表示标签中没有body，JSP表示body中可以加入JSP程序代码，tagdependent表示body的内容有标签进行处理。
<attribute>－用来定义标签的属性，包含的子元素有name、required、rtexprvalue。
rtexprvalue的说明：表示是否可以使用<%=...%>类型的表达式，
例如：<prefix:mytaglib attribute1="<%=name%>">
下面是一个简单的TLD文件：

<?xml version="1.0" encoding="UTF-8"?>
<!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.2</tlibversion>
    <jspversion>1.1</jspversion>
    <shortname>MY Tag Library</shortname>
    <uri>http://www.blogjava.net/pepsixp/</uri>
    <info></info>
    <tag>
        <name>ifLogin</name>
        <tagclass>com.akazam.struts.taglib.ValidateLoginTag</tagclass>
        <bodycontent>empty</bodycontent>
        <info></info>
        <attribute>
            <name>name</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
        <attribute>
            <name>password</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>
</taglib>

实际中的使用：
<%@ taglib uri="/tags/test" prefix="test" %>
<test:ifLogin name="pepsixp" password="888888"/>

3.在web应用中使用标签
先要在web.xml文件加入声明引用标签所在的标签：

<taglib>
        <taglib-uri>/tags/test</taglib-uri>
        <taglib-location>/WEB-INF/test.tld</taglib-location>
</taglib>

参考：《Tomcat与JavaWeb开发技术详解》