关于EVAL_BODY_INCLUDE、SKIP_BODY、EVAL_BODY_AGAIN、EVAL_PAGE、SKIP_PAGE的区别探讨

最近在建立自定义标签并使用时，对于返回的值EVAL_BODY_INCLUDE、SKIP_BODY、EVAL_BODY_AGAIN、EVAL_PAGE、SKIP_PAGE分不太清楚，看网上的相关博客虽然讲得较为清晰，但是为了更加彻底地清楚他们的区别，动手写了一个实例，终于弄明白它们的区别，也是伤不起咯！

 

首先，建一个自定义标签的.tld文件，

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
  "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">

<taglib>
  <tlibversion>1.0</tlibversion>
  <jspversion>1.1</jspversion>
  <shortname>role</shortname>
  <uri>http://www.hhhh.com</uri>
  <info>Test Tags Library</info>
  
  <tag>
  	<name>display</name>
  	<tagclass>com.xxx.tag.TestTag</tagclass>
  	<bodycontent>jsp</bodycontent>
  	<info>just a test</info>
  	<attribute>
  		<name>type</name>
  		<required>true</required>
      		<rtexprvalue>true</rtexprvalue>
  	</attribute>
  </tag>
</taglib>

 

 

这个tld文件里面定义了一个名为display的tag，这个tag包含了一个名为type的属性。

 

在测试页面引用这个自定义标签。

<%@ taglib uri="/WEB-INF/tld/kkfun-test.tld" prefix="test"%>

<test:display type="lala">热血高校</test:display>超级

 

   所以，接下来开始定义相应的标签处理类:

public class TestTag extends BodyTagSupport {
	
	private String type;
	
	@Override
	public int doAfterBody() throws JspException {
		System.out.println("=========doAfterBody=========");
		return SKIP_BODY;//EVAL_BODY_AGAIN;
	}

	@Override
	public int doEndTag() throws JspException {
		System.out.println("========doEndTag=========");
		 JspWriter out = this.pageContext.getOut();    
		      try {    
		           out.println("Hello !!!!");    
		       } catch (IOException e) {    
		           e.printStackTrace();   
		      } 
		      return EVAL_PAGE;//SKIP_PAGE;
	}

	@Override
	public int doStartTag() throws JspException {
		System.out.println("======doStartTag========");
		System.out.println("then you must call " + type.toUpperCase() + " first");
		return SKIP_BODY;//EVAL_BODY_INCLUDE;
	}

	public String getType() {
		return type;
	}

	public void setType(String type) {
		this.type = type;
	}

 需要注意的是，BodyTagSupport extends TagSupport，而我们一般来说用得较多的还是BodyTagSupport 。

 

整理如下：

1）标签处理类中extends BodyTagSupport ，一般来讲实现的三个方法是doStartTag，doAfterBody，doEndTag。

 

2）根据打印结果顺序：

======doStartTag========
then you must call LALA first
========doAfterBody=========
========doEndTag=========

 可以看出标签处理类执行方法的一般顺序为：doStartTag()->doAfterBody()->doEndTag()

 

 

3）doStartTag()方法的合理返回值为EVAL_BODY_INCLUDE和SKIP_BODY

----------返回值为EVAL_BODY_INCLUDE时，表明执行标签体中间的内容，页面上的结果为：热血高校Hello !!!! 超级 

----------返回值为SKIP_BODY时，表明不执行标签体中间的内容，页面上的结果为：Hello !!!! 超级 

 

4）doAfterBody()方法的合理返回值为SKIP_BODY和EVAL_BODY_AGAIN

---------返回值为SKIP_BODY时，表示继续处理标签执行的下一步，页面上的结果为：热血高校Hello !!!! 超级 

---------返回值为为EVAL_BODY_AGAIN时，表示会重复执行标签体中间的内容，页面上的结果为：热血高校热血高校热血高校Hello !!!! 超级 

 

5）doEndTag()的合理返回值为EVAL_PAGE和SKIP_PAGE

 

---------返回值为EVAL_PAGE时，表示标签结束后继续执行页面上的内容，页面上的结果为：热血高校Hello !!!! 超级 

---------返回值为为SKIP_PAGE时，表示不继续执行结束标签后的内容，页面上的结果为：热血高校Hello !!!!

 

 巧妙的实际应用：比如一个管理系统的权限问题，当登录用户的用户类型符合某一集合时，就显示在自定义标签中的内容，此时doStartTag()返回EVAL_BODY_INCLUDE，表明他有权限访问标签体当中的内容；反之，当他不在这个集合中时，doStartTag()返回SKIP_BODY，表明不显示标签体中的内容，也就是没有权限访问。

 

小结：一般而言，doStartTag()返回SKIP_BODY,doAfterBodyTag()返回SKIP_BODY,doEndTag()返回EVAL_PAGE.