BodyTag接口

接口BodyTag的实现类,它是负责操作主体内容(bodyContent).定义方法:

public void doInitBody();

public int doAtferBody();

提示,那些在doStartTag()方法之后被调用的方法依赖于doStartTag()方法返回值并且看在JSP页面上是否自定义Action元素,而不是怎样在TLD文件中去声明。

在TLD文件中, 若<body-content>empty</body-content>的话,doStartTag()方法只能返回SKIP_BODY

body-content有三个可选值：empty , JSP , tagdependent

若没有设置的话,那么doStartTag()可以返回SKIP_BODY, EVAL_BODY_INCLUDE, or EVAL_BODY_BUFFERED.

返回值的说明:

若SKIP_BODY返回的情况下,body不会被evaluated并且doEndTag()被调用;

若EVAL_BODY_INCLUDE 返回,并且自定义action元素不为空的时候,那么doInitBody(),setBodyContent()不会被调用,而body evaluated并且"通过"当前的out对象。

当action元素为空的时候,只有doStartTag(),doEndTag();

当EVAL_BODY_BUFFERED 返回,并且自定义的action元素不为空的时候,setBodyContent(),doInitBody()被调用,body被evaluated,doAfterBody()被调用,直到大于0次迭代后,doEndTag()才被调用,还有当action元素为空的时候,只有doStartTag(),doEndTag();

servlet容器包含BodyContent对象栈,servlet容器在doStartTag()方法之后调用PageContext.pushBody(),就是说把当前的主体内容推入栈中,其中out变量重定向到当前的主体内容实例主题内容,保留一个到JspWriter对象的引用,即前一个输出,JspWriter将数据写入响应流中.这样就有效地创建了写入器栈。

servlet容器是在调用标记的doAfterBody和doEndTag方法之间调用PageContent.popBody()方法的。

注意请不要在doEndTag()后面去访问BodyContent,因为servlet容器在调用标记处理程序的doEndTag()方法为止,servlet容器可能已经再次使用了该标记的主体内容,使用doEndTag方法访问自己主体内容的标记,可能会访问到其他标记的主体内容,或者可能访问到空值,这样就导致了不确定的行为。

BodyTagSupport类,实现BodyTag接口的类：

public BodyContent getBodyContent();//返回主题内容

public JspWriter getPreviousOut();//返回前一个out对象

实例：

1. import java.io.IOException;

2. import javax.servlet.jsp.JspException;

3. import javax.servlet.jsp.tagext.BodyTagSupport;

4. public class PrintBodyTag extends BodyTagSupport {

5. public int doAfterTag()throws JspException

6. {

7. try

8. {

9. this.getBodyContent().writeOut(getPreviousOut());

10. }catch(IOException e)

11. {

12. throw new JspException(e);

13. }

14. return SKIP_BODY;

15. }

16. }

部署tld文件:

......

<tag>

<name>printBody</name>

<tag-class>PrintBodyTag</tag-class>

</tag>

......

页面加载：

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>

<%@ taglib uri="/taglibs/util.tld" prefix="util"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>

<title>My JSP 'tag.jsp' starting page</title>

</head>

<body>

<util:printBody>AAAAAAAA</util:printBody>

</body>

</html>