自定义标签库开发

 

自定义标签库开发

自定义标签简介

自定义标签主要用于移除Jsp页面中的java代码。

快速入门：使用自定义标签输出客户机IP

移除jsp页面中的java代码，只需要完成两个步骤：

编写一个实现Tag接口的Java类，并覆盖doStartTag方法，把jsp页面中的java代码写到doStartTag方法中。

编写标签酷表舒服（tld）文件，在tld文件中对自定义标签进行描述。

完成以上操作，即可在JSP页面中导入和使用自定义标签。

查看tag接口api文档，分析自定义标签的执行流程

JSP引擎将遇到自定义标签是，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用他的方法。

1、              public void setPageContext(PageContext Pc)，JSP引擎实例化标签处理器后，将调用setPagePageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。

2、              public int doStartTag(),调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。

3、public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。

4、public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。

5、public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法。

Tld文件中的四种标签体类型

EMPTY、JSP、scriptless、tagdepentend

简单标签

在JSP2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。

简单标签共定义了5个方法：

SetJspContext方法

用于把Jsp页面的pageContext对象传递给标签处理器对象

SetParent和getParent方法

用于把父标签处理器对象传递给当前标签处理器对象

SetJspBody方法

用于获得当前标签的父标签处理器对象

Dotage方法

用于把代表标签体的JspFragment对象传递给标签处理器对象

DoTage方法

用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。