首先标签是一个java类,它是运行一个或两个接口的javabean,然后再配合标签描述文件(以.tld为扩展名),两者结合就可以作出自己的自定义标签库了。
自定义标签必须实现下面三个接口中的一个:Tag、IterationTag、BodyTag
Tag接口中的返回常数意义:
EVAL_BODY_INCLUDE:告诉服务器正文的内容,并把这些内容送入输出流
SKIP_BODY:告诉服务器不要处理正文内容
EVAL_PAGE:让服务器继续执行页面
SKIP_PAGE:让服务器不要处理剩余的页面
EVAL_BODY_AGAIN:让服务器继续处理正文内容,只有doAfterBody方法可以返回
EVAL_BODY_BUFFERED:BodyTag接口的字段,在doStartTag()返回
EVAL_BODY_INCLUDE、SKIP_BODY一般由doStartTag()返回,而EVAL_PAPGE、SKIP_PAGE由doEndTag()返回。
一个扩展BodyTagSupport的自定义标记的生命周期如下:
1.创建标记
2.调用Setter方法
3.调用doStartTag()方法
4.调用setBodyContent()方法
5.调用InitBody()方法
6.处理标记的Body
7.doAfterBody();根据返回值,如果为EVAL_BODY_AGAIN,继续执行6,如果不是,执行8
8.调用doEndTag()方法
9.判断标记是否需要重用,如果要,执行4;否则执行release()方法。
标签类代码:
package test.jsp.tags; import javax.servlet.jsp.tagext.BodyTagSupport; import javax.servlet.jsp.tagext.BodyContent; import javax.servlet.jsp.JspTagException; public class BodyTagExample extends BodyTagSupport { private int counts; public BodyTagExample() { super(); } public void setCounts(int counts) { this.counts = counts; } public int doStartTag() throws JspTagException { System.out.println("doStartTag..."); if (counts > 0) { return EVAL_BODY_TAG; } else { return SKIP_BODY; } } public void setBodyContent(BodyContent bodyContent) { System.out.println("setBodyContent..."); this.bodyContent = bodyContent; } public void doInitBody() throws JspTagException { System.out.println("doInitBody...."); } public int doAfterBody() throws JspTagException { System.out.println("do After body..." + counts); if (counts > 1) { counts--; return EVAL_BODY_TAG; } else { return SKIP_BODY; } } public int doEndTag() throws JspTagException { System.out.println("do end Tag..."); try { if (bodyContent != null) { bodyContent.writeOut(bodyContent.getEnclosingWriter()); } } catch (java.io.IOException e) { throw new JspTagException("IO Error: " + e.getMessage()); } return EVAL_PAGE; } }
tld描述文件源码:
<?xml version="1.0" encoding="ISO-8859-1" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" " http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd"> <taglib> <tlibversion>1.0</tlibversion> <jspversion>1.1</jspversion> <shortname>Application Tag Library</shortname> <uri>http://jakarta.apache.org/taglibs/struts-example-1.0</uri> <info>tag loop</info> <tag> <name>loop</name> <tagclass>test.jsp.tags.BodyTagExample</tagclass> <bodycontent>JSP</bodycontent> <attribute> <name>counts</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib>
其中:
tag中的name属性:定义了我们的tag名称,在后面会用到。
tag中的tagclass属性:指定了我们这个tag的实现类。
tage中的bodycontent属性:指定我们的页面内容是什么性质的。(注意:在jsp开发中这里必须写JSP)
tage中的attribute属性:定义了我们的这个tag可能有的属性。
attribute中的name属性:指定了属性的名称。它和我们类中定义的“int counts;”必须一样,并且在类中还必须包含一个setCounts(int counts)方法,否则这个属性就不能设置。
attribute中的required属性:表示这个属性是否是必须的。
attribute中的rtexprvalue属性:表示这个属性是否可以用JSP的程序段的结果输出。
tag写完自后要在web.xml中声明这个tag
web.xml代码如下:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <taglib> <taglib-uri>demotag</taglib-uri> <taglib-location>/WEB-INF/tld/mytag.tld</taglib-location> </taglib> </web-app>
Jsp引用代码:
<%@ page contentType="text/html; charset=GBK" language="java"%> <%@ taglib uri="demotag" prefix="demo" %> <html> <body> <br> <demo:loop counts="5"> 现在时间是:<%=new java.util.Date().toString()%><br> </demo:loop> <br> </body> </html>