支持动态属性的标签库

在以前版本的JSP环境中，我们必须为标签库中的每一个属性在标签库类中定义对应的getter/setter方 法。这种做法使我们无法根据实际的运行环境增加属性。为了解决这个在实际中经常遇见的问题，JSP2.0的标签库引入一个新特性——动态属性，该特性通过 接口javax.servlet.jsp.tagext.DynamicAttributes来实现，本文将通过一个简单的例子来介绍如何开发支持动态属 性的标签库。

首先描述一下这个简单的例子，我们实现一个把所有的属性值相加并输出相加的结果。接下来还是从标签库的三要素开始

1. 标签库实现类

支持动态属性的标签只需要在原来的基础上实现接口DynamicAttributes，并完成 setDynamicAttribute方法，代码如下

 

package javayou.taglib;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.DynamicAttributes;
import javax.servlet.jsp.tagext.TagSupport;

/**
* @author Winter Lau
* 演示支持动态属性的标签库
*/
public class NumberAddTag extends TagSupport implements DynamicAttributes {

private int total = 0;

public int doStartTag() throws JspException {
try{
pageContext.getOut().print(total);
}catch(IOException e){}
return EVAL_BODY_INCLUDE;
}
/*
* 该方法在接口DynamicAttributes中定义
* @see javax.servlet.jsp.tagext.DynamicAttributes#setDynamicAttribute(
* java.lang.String, java.lang.String, java.lang.Object)
*/
public void setDynamicAttribute(String uri, String localName, Object value)
throws JspException
{
total += Integer.parseInt(value.toString());
}

public void release() {
total = 0;
}
}

编译该类并将class文件拷贝至{webapp}/WEB-INF/classes/javayou /taglib目录下。

2. 标签库定义文件

接下来必须在标签的描述文件javayou.tld中为支持动态属性的标签设置dynamic- attributes属性，值为true，下面是本例中的配置

 

<?xml version="1.0" encoding="GB2312" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
version="2.0">

<description>JavaYou Taglibs</description>
<display-name>JavaYou Demo Taglibs</display-name>
<tlib-version>1.1</tlib-version>
<short-name>demo</short-name>
<uri>http://www.javayou.com/dev/jsp</uri>

<tag>
<name>add</name>
<tag-class>javayou.taglib.NumberAddTag</tag-class>
<body-content>empty</body-content>
<dynamic-attributes>true</dynamic-attributes>
</tag>

</taglib>

把该文件保存在/WEB-INF目录下即可。

3. 使用标签库的页面

最后就是如何使用这个标签库的问题了，有两种办法来调用这个标签库，先来看看测试的页面代码add.jsp

 

<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="demo" uri="http://www.javayou.com/dev/jsp" %>

<demo:add a1="1" a2="2" a3="3" a4="4"/>
&nbsp;
<demo:add>
<jsp:attribute name="a1">1</jsp:attribute>
<jsp:attribute name="a2">2</jsp:attribute>
<jsp:attribute name="a3">3</jsp:attribute>
<jsp:attribute name="a4">4</jsp:attribute>
<jsp:attribute name="a5">5</jsp:attribute>
</demo:add>

在这个页面中的第一种调用方法中，我们给标签赋予几个属性，但是我们并没有在标签定义中定义这些属性，这就是动态属 性意思。JSP 2.0 新增了一个内置的标签jsp:attribute，你可以根据你的需要来选择具体采用何种方式，第二种方法适于动态的属性是由某些其它的标签所生成的值。

可以看到JSP 2.0在易用性上还是做了很多事情，比如这个动态属性就可大大的简化了开发过程