支持动态属性的标签库 [ 04-12-30 | 刘冬 ]

支持动态属性的标签库  [ 04-12-30 | 本站原创,刘冬 ]  

在以前版本的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在易用性上还是做了很多事情,比如这个动态属性就可大大的简化了开发过程,我们会陆续介绍JSP 2.0的一些新特性,欢迎继续关注。(www.javayou.com)


posted on 2004-12-31 00:44  笨笨  阅读(1506)  评论(0编辑  收藏  举报

导航