在以前版本的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;
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;
}
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"/>
<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,你可以根据你的需要来选择具体采用何种方式,第二种方法适于动态的属性是由某些其它的标签所生成的值。