Taglib 原理和实现之嵌套和属性的读取

来源:岁月联盟 编辑:zhuzhu 时间:2007-07-11

1.在request里有一个 Man 对象,它有两个属性:name和age。现在,我们想用一个嵌套的tag,父tag取得对象,子tag取得name属性并显示在页面上。例如,它的形式如下:

 

<diego:with object="${Man}"><diego:output property="name"/></diego:with>

object 支持el表达式,表示取得 Man 对象。output的property表示从该对象取得名为name的属性。

2.如何支持tag之间的嵌套

在子tag里调用getParent 方法,可以得到父tag对象。用 findAncestorWithClass 方法,则可以通过递归找到想要找的tag。例如

 

<diego:with object="${people}"> <!--表示取得一个对象--><diego:withCollection property="men"> <!--表示取得对象里的一个属性,这个属性是个 Collection,Collection里添加了许多man,每个man有名字和年龄--><diego:output property="name"/> <!--取得name属性并显示--></diego:withCollection></diego:with>

对于最内层的outputTag来说,调用getParent,可以得到 withCollectionTag,通过如findAncestorWithClass(this,WithTag.class)的方式,可以得到withTag。得到Tag之后,就可以取得Tag的属性,进行业务逻辑处理,然后输出到jsp

3.如何支持类属性查找功能

显然,在上面的outputTag中,我们要根据属性的名字,查找类中有没有这个属性。然后取出属性的值并显示。通常,这可以编写自己的反射函数来完成。更简单的办法,是通过 BeanUtil 的PropertyUtils方法来完成功能。BeanUtil 是apache上的一个开源项目。

示例如下:

import org.apache.commons.beanutils.PropertyUtils;

......

property = PropertyUtils.getProperty(currentClass, propertyName);

propertyName是待查找属性的名字,例如上面的"name",currentClass是待查找的类,例如上面的People

记得把 commons-beanutils.jar添加到WEB-INF/lib目录下

4.现在让我们实现开篇提出的问题,编写WithTag如下:

 

package diegoyun;import java.io.IOException;import javax.servlet.jsp.JspException;import javax.servlet.jsp.tagext.BodyTagSupport;import org.apache.taglibs.standard.lang.support.ExpressionEvaluatorManager;/*** @author chenys*/public class WithTag extends BodyTagSupport{ private Object value = null; private Object output = null; public void setOutput(Object output) {  this.output = output; } public Object getValue() {  return value; } public void setValue(Object value)throws JspException {  this.value = ExpressionEvaluatorManager.evaluate("value", value.toString(), Object.class, this, pageContext); } public int doStartTag() {  return EVAL_BODY_INCLUDE; } public int doEndTag()throws JspException {  try  {    pageContext.getOut().print(output);  }  catch (IOException e)  {   throw new JspException(e);  }  return EVAL_PAGE; }}

编写 NestedOutputTag 如下:

 

package diegoyun;import javax.servlet.jsp.JspException;import javax.servlet.jsp.tagext.BodyTagSupport;import org.apache.commons.beanutils.PropertyUtils;/*** @author chenys*/public class NestedOutputTag extends BodyTagSupport{ private String property = null; public void setProperty(String property) {  this.property = property; } public int doEndTag()throws JspException {   WithTag parent =(WithTag)getParent();   if(parent==null)    throw new JspException("Can not find parent Tag ");   try   {     Object propertyValue = PropertyUtils.getProperty(parent.getValue(), property);    parent.setOutput(propertyValue);   }   catch (Exception e)   {    throw new JspException(e);   }   return EVAL_PAGE;  }}

在包diegoyun下添加一个包vo,在vo下写一个Man类:

 

package diegoyun.vo;/*** @author chenys*/public class Man{ private String name = null; private int age = 0; public int getAge() {  return age; } public void setAge(int age) {  this.age = age; } public String getName() {  return name; } public void setName(String name) {  this.name = name; }}

写TLD

 

<!--WithTag--><tag><name>with</name><tag-class>diegoyun.WithTag</tag-class><body-content>JSP</body-content><attribute><name>value</name><required>false</required><rtexprvalue>true</rtexprvalue></attribute></tag><!--OutputTag3--><tag><name>nestedout</name><tag-class>diegoyun.NestedOutputTag</tag-class><body-content>empty</body-content><attribute><name>property</name><required>false</required><rtexprvalue>false</rtexprvalue></attribute></tag>

写JSP页面

 

<%@ page language="java" %><%@ page import="diegoyun.vo.*"%><%@ taglib uri="/WEB-INF/tlds/diego.tld" prefix="diego"%><html><body bgcolor="#FFFFFF"><%Man man = new Man();man.setName("diego");request.setAttribute("man",man);%>Test nested tag:<br><diego:with value="${man}"><diego:nestedout property="name"/></diego:with></body></html>

运行页面,则可以看到:

Test nested tag:

diego

5.结束语:

上述例子简单描绘了嵌套的Tag之间如何交互。通常子Tag负责取得数据,然后设置父Tag的属性,最后在父Tag里显示到jsp页面。如上面的例子,父 Tag 的 output 表示待打印的对象,通过 nestedoutTag 取得name的值,设置output,然后打印出来。

通过支持El表达式和动态属性联结,Tag可以实现强大的处理功能。将逻辑都集中到Tag里,极大的简化页面的编写。