开发自定义标签的时候可以继承TagSupport或着BodyTagSupport,实际上bodyTagSupport已经继承了tagSupport这个类.
TagSupport:
当继承TagSupport后,需要至少重写doStartTag这个方法.这个方法将得到标签起始时的一些信息,这个方法的合理返回值有两个,分别为EVAL_BODY_INCLUDE和SKIP_BODY,前者的意思为执行标签体的内容,而后者的意思为跳过标签体的内容.
其次:doAfterBody方法,该方法在每一次标签体执行完成之后执行.其合法的返回值有:SKIP_BODY和EVAL_BODY_AGAIN.前者表示不再执行标签体,后者表示再次执行标签体.
再次为doEndTag()该方法在标签结束的时候调用,该方法的合法返回值有:SKIP_PAGE和EVAL_PAGE前者表示不再执行标签之后的页面内容,后者表示执行标签后的内容.
用一个例子来说明之间的执行关系:
<logic:iterate id="user" name="users"> <bean:write name="user" property="username" /> <bean:write name="user" property="password" /> <br /> </logic:iterate>
在这段代码中,<logic:iterate id="user" name="users">系统执行doStartTag这个方法,其中id和name的值会被set到该标签的实现类中.因为这是一个处理循环的标签,因此doStartTag需要进行是否需要进行标签体的判断.如果需要则返回EVAL_BODY_INCLUDE,否则执行SKIP_BODY.
参看代码:
if (iterator.hasNext()) { Object element = iterator.next(); if (element == null) { pageContext.removeAttribute(id); } else { pageContext.setAttribute(id, element); } lengthCount++; started = true; if (indexId != null) { pageContext.setAttribute(indexId, new Integer(getIndex())); } return (EVAL_BODY_INCLUDE); } else { return (SKIP_BODY); }
如果标签为一个循环,那么系统将返回EVAL_BODY_INCLUDE,并且退出doStartTag这个方法,所以在这个时候,标签体已经被执行了一次,当标签体执行完一次以后,系统会再次调用doAfterBody这个方法,来判断是否还需要进行标签体的循环.
参考代码:
if (iterator.hasNext()) { Object element = iterator.next(); if (element == null) { pageContext.removeAttribute(id); } else { pageContext.setAttribute(id, element); } lengthCount++; if (indexId != null) { pageContext.setAttribute(indexId, new Integer(getIndex())); } return (EVAL_BODY_TAG); } else { return (SKIP_BODY); }
如果仍然有循环,责再次执行标签体,否则退出.
而doAfterTag则执行一些资源释放等的工作.
具体的标签调用如图:
张海杰
2009-11-18