BodyContent揭秘及定制复杂的JSP标签
分类：
jsp中的定制标签功能可以帮助我们来更好地实现presentation layer。我在学习的时候，感觉最困难的就是BodyContent这个类，Sun在API和specification中对BodyContent介绍的非常少，以至于很多程序员对这个类知之甚少。
本文的目的就是带领读者揭开这层面纱，直捣BodyContent的核心，帮助读者了解BodyContent背后的设计模式，本文还将带领读者写一个模拟while循环的标签，这个标签完全可以替代JSTL中的循环标签。
BodyContent揭秘
BodyContent类继承了JspWriter，同时又对JspWriter实现了包装模式(wrapper)，实质就是JspWriter的层层包装，你可以把这种结构想象成一个洋葱。图1表明了BodyContent和JspWriter的关系：
图1：BodyContent和JspWriter的关系
对于一个两层的嵌套的标签：
<c:parent>
parent1
<c:child>
child
</c:child>
parent2
</c:parent>
一开始，容器遇到<c:parent>起始标签。由容器创建了一个BodyContent对象，这个对象包装了真正的响应流 (即response.getWriter()得到的流)，然后让隐含的out引用指向这个BodyContent对象。于是，就形成了两层的JspWriter流包装层次：最内层是真正的响应流，最外层是<c:parent>标签的BodyContent对象。
然后，容器对<c:parent>标签的正文求值，把"parent1"字符串写入到out引用指向的JspWriter当中。这时，最外层的JspWriter中的内容是"parent1",最内层真正的响应流中没有内容。
接下来，容器又遇到了<c:child>起始标签。同样，容器创建一个BodyContent对象，这个对象包装了out引用指向的JspWriter，然后让out引用指向这个新创建的BodyContent对象。于是，就有了一个三层的JspWriter包装层次：最内层是真正的响应流，中间层是<c:parent>标签的BodyContent对象，最外层是<c:child>标签的BodyContent对象。
然后，容器遇到了字符串"child"，把它写入到out引用指向的JspWriter当中。这时，最内层中仍然没有内容，中间层中的内容是"parent1"，最外层中的内容是"child"。此时的情景如图2所示：
图2：三层的流包装层次
到目前为止，3层的流包装层次已经形成：最内层是真正的响应流，中间层是<c:parent>标签的BodyContent对象，最外层就是<c:child>标签的BodyContent对象。每一层流当中都有一些被输入的内容。out引用总是指向最外层的JspWriter。注意，流包装嵌套的顺序和标签嵌套的顺序正好是反向的。
像不像是一颗洋葱呢？接下来，看看容器是怎样一层一层剥洋葱的。
接下来，容器遇到了</c:child>结束标签，把标签的JspWriter中的全部内容写入到内层的JspWriter中，然后该层JspWriter就从流包装层次中剥离出来，然后容器重新设定out引用指向最外层的JspWriter。这时候，三层的流包装层次变成了两层的流包装层次：最内层是真正的响应流，仍然没有内容，最外层是<c:parent>标签的JspWriter对象，内容是"parent1 child"。此时的情景如图3所示：
图3：<c:child>的JspWriter剥离后的两层流包装层次
然后，容器遇到了"parent2"字符串，并把它写入到out引用指向的JspWriter当中。这时，最内层流是真正的响应流，没有内容，最外层是<c:parent>标签的JspWriter对象，内容是"parent1 child parent2"。此时的情景如图4所示：
图4："parent2"被写入到<c:parent>标签的JspWriter之后的流包装层次
最后，容器遇到了</c:parent>结束标签，把标签的JspWriter中的全部内容写入到内层JspWriter当中，然后标签的JspWriter就从流包装层次中剥离出来。这时，流包装层次中只剩下真正的响应流了，它当中的内容是刚被写进去的"parent1 child parent2"。此时的情景如图5所示：
图5：最后只剩下真正的响应流JspWriter对象
这样，所有流包装层次中的内容最终都会汇集到真正的响应流当中。你可以把这个过程想象成剥洋葱。
while循环标签
了解了BodyContent，接下来就实践一下，做一个while循环的标签。标签的语法：
<while>
<condition value="<%=布尔表达式%>"/>
<do> JSP </do>
</while>
其中有三个标签：while标签、condition标签和do标签，因此需要设计三个标签处理器类。While标签和do标签的处理器要继承BodyTagSupport这个类，因为它们要处理正文内容，而condition标签只需要继承TagSupport就可以了。
我所预期的处理流程是这样的：如果condition标签中的value属性值为true，则处理do标签的正文，并继续下一轮循环；如果condition标签中的value属性值为false，则不处理do标签的正文，并跳出循环。
这就需要do标签和condition标签之间有某种通讯机制。幸运的是，在BodyTagSupport中有setValue()和getValue()方法，这样，condition标签和do标签的处理器就可以通过在while标签的处理器中设置一些值来进行通讯。
下面是while标签的处理器的源码：
package coreservlets.tags.loop;
import Java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.*;
public class WhileHandler extends BodyTagSupport {
public int doStartTag () {
// "conditionCount" 属性和 "doCount" 属性,
// 为保证 <condition> 和 <do> 的个数和顺序
setValue ("conditionCount", new Integer (0));
setValue ("doCount", new Integer (0));
// "condition" 属性，为保证不满足条件就退出循环
setValue ("condition", new Boolean (false));
return BodyTag.EVAL_BODY_BUFFERED;
}
public int doAfterBody () throws JspException {
// 取得 "doCount" "conditionCount" "condition" 的属性值
int doCount = ((Integer) getValue ("doCount")).intValue ();
int conditionCount = ((Integer) getValue ("conditionCount")).intValue ();
boolean condition = ((Boolean) getValue ("condition")).booleanValue ();
if ((doCount != 1) || (conditionCount != 1)) {
throw new JspException ("tag format error");
}
// 设置 "doCount" "conditionCount" "condition" 的属性值
setValue ("doCount", new Integer (0));
setValue ("conditionCount", new Integer (0));
setValue ("condition", new Boolean (false));
// 判断 condition 条件，决定是否继续循环
return (condition ? IterationTag.EVAL_BODY_AGAIN : Tag.SKIP_BODY);
}
public int doEndTag () throws JspException {
try {
BodyContent bc = getBodyContent ();
bc.getEnclosingWriter().write (bc.getString());
// 不推荐使用
// bc.writeOut (this.getPreviousOut ());
} catch (IOException ie) {
throw new JspException (ie.getMessage ());
}
return Tag.EVAL_PAGE;
}
}
在doEndTag()方法中需要把BodyContent中的内容写入它包装的内层的JspWriter中。bc.getEnclosingWriter()用来得到BodyContent包装的JspWriter，bc.getString()用来得到BodyContent中的内容。作者不推荐使用BodyTagSupport.getPreviousOut()和BodyContent.writeOut()方法。到此，bc.getEnclosingWriter ().write (bc.getString ())这个语句的意思就十分清晰了。就跟剥洋葱一样。
BodyTagSupport中doStartTag()、doAfterBody()和doEndTag()这些方法的返回值的意义非常重大，应该重点理解。
WhileHandler在它的doAfterBody()方法判断condition属性是真还是假，由此来决定是否继续下一轮循环。你可能以为condition属性是不是永远为false呢？不是的，在condition标签的处理器中会修改WhileHandler的condition属性。
下面是condition标签的处理器的源码：
package coreservlets.tags.loop;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.*;
public class ConditionHandler extends TagSupport {
private boolean condition;
public void setValue (boolean condition) {
this.condition = condition;
}
public int doStartTag () throws JspException {
BodyTagSupport parent = (BodyTagSupport) getParent ();
if (parent == null) {
throw new JspException ("tag format error");
}
int conditionCount = ((Integer) parent.getValue ("conditionCount")).intValue ();
// 设置 "conditionCount" "condition" 属性值
parent.setValue ("conditionCount", new Integer (++conditionCount));
parent.setValue ("condition", new Boolean (condition));
return Tag.SKIP_BODY;
}
}
可以看到，condition标签的处理器修改了while标签处理器的condition属性值。因为condition标签没有正文，所以doStartTag()方法返回Tag.SKIP_BODY。
下面是do标签的处理器的源码：
package coreservlets.tags.loop;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.*;
public class DoHandler extends BodyTagSupport {
public int doStartTag () throws JspException {
BodyTagSupport parent = (BodyTagSupport) getParent ();
if (parent == null) {
throw new JspException ("tag format error");
}
// 取得 "doCount" "condition" "conditionCount" 的属性值
int doCount = ((Integer) parent.getValue ("doCount")).intValue ();
int conditionCount = ((Integer) parent.getValue ("conditionCount")).intValue ();
boolean condition = ((Boolean) parent.getValue ("condition")).booleanValue ();
if (conditionCount != 1) {
throw new JspException ("tag format error");
}
// "doCount" 属性值加1
parent.setValue ("doCount", new Integer (++doCount));
// 根据 "condition" 属性值决定是否对正文求值
return (condition ? BodyTag.EVAL_BODY_BUFFERED : Tag.SKIP_BODY);
}
public int doAfterBody () throws JspException {
try {
BodyContent bc = getBodyContent ();
bc.getEnclosingWriter ().write (bc.getString ());
} catch (IOException ie) {
throw new JspException (ie.getMessage ());
}
return Tag.SKIP_BODY;
}
}
在do标签的处理器的doStartTag()方法中，取得while标签的处理器的condition属性，并根据condition属性值来决定是否对正文求值。如果condition为true，则对正文求值，然后就到了doAfterBody()方法，在这里需要把do标签的BodyContent中的内容写入到它包装的内层JspWriter中(也就是while标签的BodyContent)；如果condition为false，则跳过do标签的正文。
转自http://hi.baidu.com/ta22/blog/item/1cf5993e87d26bfb838b1371.html
