jsp自定义标签实例

jsp自定义标签实例

JSP自定义标签。在自定义标签的起始和结束标签之间的部分为标签体(Body)。

标签处理程序类：定义标签的行为，并在JSP引擎遇到自定义标签时调用执行。

标签库描述符（TLD）文件：描述标签库的XML文档，向JSP引擎提供有关自定义标签的标签处理程序的信息。tag标签相关属性：实现简单标签处理程序 标签处理程序是一个在运行时调用的Java类,它包含在 JSP文件中使用的自定义标签的实现代码.标签处理程序必须实现或扩展javax.servlet.jsp.tagext包中的类和接口.javax.servlet.jsp.tagext含有允许标签处理程序类与JSP容器通信的接口和类。

最近在项目中要用到这种技术，所以自己就写一个经典的HelloWorld实例： 其实对自定义标签已经早有接触了（Struts中使用了很多自定义标签，如html、bean等） 使用这种技术的优点：取代了JSP中的Java程序，并且可以重复使用，方便不熟悉Java编程的网页设计人员。

实现步骤：

首先启动eclipse，新建一个web项目（废话...）

1、修改web.xml文件，增加自定义标签支持。

Java代码

2、创建标签库TLD文件 tlds\helloworld.tld 。Java代码

这里注意：web.xml和xxx.tld这两个XML文件的头信息的版本匹配很重要，否则会导致页面报错找不到标签 。

3、创建标签处理程序类 HelloWorldTag（重写doStartTag和doEndTag方法）。

Java代码

补充：

doStartTag()方法是遇到标签开始时会呼叫的方法，其合法的返回值是EVAL_BODY_INCLUDE与SKIP_BODY,前者表示将显示标签间的文字，后者表示不显示标签间的文字。

doEndTag()方法是在遇到标签结束时呼叫的方法，其合法的返回值是EVAL_PAGE与SKIP_PAGE，前者表示处理完标签后继续执行以下的JSP网页，后者是表示不处理接下来的JSP网页。

doAfterBody(),这个方法是在显示完标签间文字之后呼叫的，其返回值有EVAL_BODY_AGAIN与SKIP_BODY，前者会再显示一次标签间的文字，后者则继续执行标签处理的下一步。

EVAL_BODY_INCLUDE：把Body读入存在的输出流中，doStartTag()函数可用。

EVAL_PAGE：继续处理页面，doEndTag()函数可用。

SKIP_BODY：忽略对Body的处理，doStartTag()和doAfterBody()函数可用。

SKIP_PAGE：忽略对余下页面的处理，doEndTag()函数可用。

EVAL_BODY_BUFFERED：申请缓冲区，由setBodyContent()函数得到的BodyContent对象来处理tag的body，如果类实现了BodyTag，那么doStartTag()可用，否则非法。

EVAL_BODY_AGAIN：请求继续处理body，返回自doAfterBody()，这个返回值在你制作循环tag的时候是很有用的。

预定的处理顺序是：doStartTag()返回SKIP_BODY,doAfterBodyTag()返回SKIP_BODY,doEndTag()返回EVAL_PAGE。如果继承了TagSupport之后，如果没有改写任何的方法，标签处理的执行顺序是：doStartTag() ->不显示文字 ->doEndTag()->执行接下来的网页 。如果您改写了doStartTag(),则必须指定返回值，如果指定了EVAL_BODY_INCLUDE,则执行顺序是：doStartTag()->显示文字->doAfterBodyTag()->doEndTag()->执行下面的网页 。

4、最终测试页面 hello.jsp 。

Java代码

实例完成，HelloWorld再现江湖!!!