最近开始学些jsp的自定义标签的使用,顺便把学习的过程记录下来。
jspTag 的API位于javax.servlet.jsp.tagext这个包中,下图是其中的主要的接口和类的框架图:
所有的标签类都要实现JSPTag接口,但该接口只是一个标识接口,其中不包含任何静态常量和方法声明。
接口Tag和SimpleTag都继承该接口。
打开 javax.servlet.jsp.JSPTag 接口的源码:
package javax.servlet.jsp.tagext; public interface JspTag {} //空接口
打开javax.servlet.jsp.Tag接口,源码:
/* * 源码:javax.servlet.jsp.tag接口 * * */ package javax.servlet.jsp.tagext; import javax.servlet.jsp.*; public interface Tag extends JspTag { //静态的状态常量,此接口定义了4个,用于指示标签体的流程 public final static int SKIP_BODY = 0; //作为doStartTag()返回值,表示忽略标签体,不执行 public final static int EVAL_BODY_INCLUDE = 1; //作为doStartTag()的返回值,表示正常的执行标签体中的内容 public final static int SKIP_PAGE = 5; //作为doEndTag()的返回值,表示跳过页面中标签后剩下的jsp程序代码 public final static int EVAL_PAGE = 6; //作为doEndTag()的返回值,表示继续执行页面中标签后的jsp程序代码 //接口定义的方法 void setPageContext(PageContext pc); //jsp容器调用,向当前的标签出离对象传递当前的PageContext对象 void setParent(Tag t); //向当前的对象传递父标签的标签对象 Tag getParent(); //当标签嵌套时,可以获取父标签 int doStartTag() throws JspException; //当jsp容器遇到自定义标签的起始标志,执行该方法,通过返回值来确定执行流程 int doEndTag() throws JspException; // 当jsp容器遇到自定义标签的结束标志,执行该方法,通过返回值来确定后续流程 void release(); }
标签对象由jsp容器来负责创建,当在执行jsp文件时,遇见自定义标签,在缓存中查找该tag 对象,如果没有则创建一个Tag对象放到缓存中,以便重用。
当容器得到Tag对象后,按照如下图中的流程来执行,该标签类对象的具体生命周期如下:
1.jsp容器调用对象的setPageContext()方法设置标签页面的上下文,setParent()来设置标签的父标签
2.jsp容器调用tag对象的其他的setXXX方法来设置tag对象的属性,setXXX()方法是标签支持属性所需的唯一的方法
3.JSP容器调用doStartTag()方法,如果返回SKIP_BODY,则忽略了该标签。如果返回EVAL_BODY_INCLUDE,则执行标签体的内容
4.JSP容器调用doEndTag()方法,如果返回SKIP_PAGE,则此标签后所有的jsp页面代码都不再执行,如果返回EVAL_PAGE,则继续执行标签后的代码