kinman 2003/09/03 16:18:33
Modified: jsr152/src/share/javax/servlet/jsp/tagext IterationTag.java
Log:
- Patch by Mark Roth:
Clarified that doAfterBody() is not called if there is no body.
Revision Changes Path
1.7 +10 -8
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java
Index: IterationTag.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- IterationTag.java 31 Mar 2003 17:52:26 -0000 1.6
+++ IterationTag.java 3 Sep 2003 23:18:32 -0000 1.7
@@ -91,21 +91,23 @@
*
* <p><B>Empty and Non-Empty Action</B>
* <p> If the TagLibraryDescriptor file indicates that the action must
- * always have an empty action, by an <body-content> entry of "empty",
- * then the doStartTag() method must return SKIP_BODY.
+ * always have an empty element body, by a <body-content> entry of
+ * "empty", then the doStartTag() method must return SKIP_BODY.
*
- * Otherwise, the doStartTag() method may return SKIP_BODY or
- * EVAL_BODY_INCLUDE.
+ * <p>Note that which methods are invoked after the doStartTag() depends on
+ * both the return value and on if the custom action element is empty
+ * or not in the JSP page, not on how it's declared in the TLD.
*
* <p>
* If SKIP_BODY is returned the body is not evaluated, and then doEndTag()
* is invoked.
*
* <p>
- * If EVAL_BODY_INCLUDE is returned, the body is evaluated and
- * "passed through" to the current out, then doAfterBody() is invoked
- * and, after zero or more iterations, doEndTag() is invoked.
-*/
+ * If EVAL_BODY_INCLUDE is returned, and the custom action element is not
+ * empty, the body is evaluated and "passed through" to the current out,
+ * then doAfterBody() is invoked and, after zero or more iterations,
+ * doEndTag() is invoked.
+ */
public interface IterationTag extends Tag {
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
