首先,我们从下图先了解标签tagSupport和bodyTagSupport的关系。
由图我们可以看出,bodyTagSupport是继承tagSupport的,因此,我们可以知道bodyTagSupport的功能会比较的多。用TagSupport实现的标签,都可以用BodyTagSupport来实现。
TagSupport与BodyTagSupport的区别主要是标签处理类是否需要与标签体交互,如果不需要交互的就用TagSupport,否则就用BodyTagSupport。
交互就是标签处理类是否要读取标签体的内容和改变标签体返回的内容。
tagSupport实例:
效果图:
一、编写tag的java类:(自定义标签类)
public class MyTagSupport extends TagSupport{
private static final long serialVersionUID = 1L;
private String url;
private String text;
@Override
public int doStartTag() throws JspException {
try {
JspWriter out = this.pageContext.getOut();
out.println("<table width='500px' border='1' align='center'>");
out.println("<tr>");
out.println("<td width='20%'>"+text+":</td>");
out.println("<td>" + url + "</td>");
out.println("</tr>");
out.println("<tr>");
out.println("</table>");
} catch(Exception e) {
throw new JspException(e.getMessage());
}
return SKIP_BODY;
}
@Override
public int doEndTag() throws JspException {
return EVAL_PAGE;
}
@Override
public void release() {
super.release();
this.url = null;
}
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
public String getText() {
return text;
}
public void setText(String text) {
this.text = text;
}
}
二、编写标签描述文件**.tld
在web-info文件夹下创建mTagSupport.tld<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-jsptaglibrary_2_0.xsd">
<!--版本号-->
<tlib-version>1.0</tlib-version>
<jsp-version>2.0</jsp-version>
<short-name>mytag1</short-name>
<tag>
<!--指定标签名 -->
<name>show</name>
<!--指定标签类文件的全路径 -->
<tag-class>tagSupport.MyTagSupport</tag-class>
<!--如果不需要标签体则设置empty,反之设定jsp -->
<body-content>empty</body-content>
<!--设定属性(如果有的话) -->
<attribute>
<!--指定标签名 -->
<name>url</name>
<!--是否是必须,如果非必须没设置则为空 -->
<required>false</required>
<rtexprvalue>true</rtexprvalue><!--是否可在属性中使用表达式 -->
</attribute>
<attribute>
<!--指定标签名 -->
<name>text</name>
<!--是否是必须,如果非必须没设置则为空 -->
<required>false</required>
<rtexprvalue>true</rtexprvalue><!--是否可在属性中使用表达式 -->
</attribute>
</tag>
</taglib>
三、在web.xml里添加
<jsp-config>
<taglib>
<!--
标签库的uri路径
即jsp头文件中声明<%@ taglib uri="/mytaglib" prefix="cc"%>
的uri
-->
<taglib-uri>/mytagSupport</taglib-uri>
<!-- tld文件所在的位置-->
<taglib-location>/WEB-INF/mytagSupport.tld</taglib-location>
</taglib>
</jsp-config>
<taglib-uri>/mytagSupport</taglib-uri><!-- tld文件所在的位置--> <taglib-location>/WEB-INF/mytagSupport.tld</taglib-location> </taglib> </jsp-config>
四、页面中添加
<%@ taglib uri="/mytagSupport" prefix="mytag1"%>
<mytag1:show url="123123" text="列名"/>
这样就完成了一个标签库的编辑。
标签类说明:
我们创建的UserInfoTag类继承了TagSupport类,而它又实现了Tag接口,Tag接口的生命周期由其所在的容器控制,如下图:
setPageContext() 将所在jsp页面的pageContext注入进来,目的是为了在后面的方法中可以访问到jsp页面对象的pageContext属性
setParent() 设置此标签的父标签
setAttribute() 将标签中的属性注入到此class的属性,不需要自己实现但要提供属性的get与set方法
doStartTag() 在开始标签属性设置后调用,如果返回SKIP_BODY则忽略标签之中的内容,如果返回EVAL_BODY_INCLUDE则将标签体的内容进行输出
doEndTag() 在结束标签之前调用,返回SKIP_PAGE跳过整个jsp页面后面的输出,返回EVAL_PAGE执行页面余下部分
release() 生命周期结束时调用