首先标签是一个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:
- <taglib>
- <tlibversion>1.0</tlibversion>
- <jspversion>1.1</jspversion>
- <shortname>Application Tag Library</shortname>
- <uri>http:
- <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>
<?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>
<?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>
posted on 2012-03-26 17:44
Terry Zou 阅读(177)
评论(0) 编辑 收藏 所属分类:
struts2.1.6