在以前版本的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"/> <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在易用性上还是做了很多事情,比如这个动态属性就可大大的简化了开发过程