Java Server Pages

Name

Tag

Synopsis

Interface Name:	javax.servlet.jsp.tagext.Tag
Extends:	None
Implemented by:	Custom action tag handler classes and javax.servlet.jsp.tagext.TagSupport

Description

The Tag interface should be implemented by tag handler classes that do not need access to the body contents of the corresponding custom action element, and that do not need to iterate over the body of a custom action element.

Interface Declarations

public interface Tag {
  // Constants
  public static final int EVAL_BODY_INCLUDE;
  public static final int EVAL_PAGE;
  public static final int SKIP_BODY;
  public static final int SKIP_PAGE;

  // Methods
  public int doEndTag( ) throws JspException;
  public int doStartTag( ) throws JspException;
  public Tag getParent( );
  public void release( );
  public void setPageContext(PageContext pc);
  public void setParent(Tag t)
}

Methods

public int doEndTag( ) throws JspException

Performs actions when the end tag is encountered. If this method returns SKIP_PAGE, execution of the rest of the page is aborted and the _jspService( ) method of JSP page implementation class returns. If EVAL_PAGE is returned, the code following the custom action in the _jspService( ) method is executed.

public int doStartTag( ) throws JspException

Performs actions when the start tag is encountered. This method is called by the JSP container after all property setter methods have been called. The return value from this method controls how the action’s body is handled, if there is one. If it returns EVAL_BODY_INCLUDE ...