SimpleTagSupport类别顾名思义,就是可以处理一些简单的自订标签需求,它是在JSP 2.0之后新增的类别,对于一些简单的自订标签页求,您可以继承它来实作标签处理类别,而不用为了处理一些TagSupport、 BodyTagSuppourt类别中回传值的问题。
为了使用上的简单而降低了复杂性,另一方面就是SimpleTagSupport类别所处理的功能受了些限制,它只处理标签与本体,要不要显示本体文字取决于您,对于标签之后的页面则不在SimpleTagSupport处理的范围之内(虽然您还是可以使用forward之类的方式来决定要不要显示之后的页面,但直接实作TagSupport会更方便一些),另外SimpleTagSupport类别的本体文字不能设定为JSP,这也是使用 SimpleTagSupport上的一些限制。
尽管有了一些限制,对于简单的自订标签需求,使用SimpleTagSupport还是比较容易的,它实作了SimpleTag介面,您只要重新定义 doTag()方法就可以实作自订标签的处理,先来看一个简单的范例:
步骤:
创建web 应用程序xgtimesTag
创建标记库描述符xgtimes.tld
内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="https://java.sun.com/xml/ns/j2ee" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://java.sun.com/xml/ns/j2ee web-jsptaglibrary_2_0.xsd">
<tlib-version>1.0</tlib-version>
<short-name>xgtimes</short-name>
<uri>/WEB-INF/tlds/xgtimes</uri>
</taglib>
创建标记库处理程序xgtimes.tlds.print.java
这里,该标签有三个属性 body 、 loo p 、 br , body 是显示的文字的内容, loop 设置显示的次数, br 设置显示一次是否换行。
完成之后,这些属性会在标记库描述符xgtimes.tld 中增加该标记的属性描述。如下:
<tag>
<name>print</name>
<tag-class>xgtimes.tlds.print</tag-class>
<body-content>scriptless</body-content>
<attribute>
<name>body</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<type>java.lang.String</type>
</attribute>
<attribute>
<name>loop</name>
<rtexprvalue>true</rtexprvalue>
<type>int</type>
</attribute>
<attribute>
<name>br</name>
<rtexprvalue>true</rtexprvalue>
<type>boolean</type>
</attribute>
</tag>
然后我们在标记处理程序xgtimes.tlds.print.java 中输入内容如下:
package xgtimes.tlds;
import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.JspException;
/**
*
* @author 昆仑追风◇XG时代中国
* @version 1.0
*/
public class print extends SimpleTagSupport {
private java.lang.String body;
private int loop;
private boolean br;
public void doTag() throws JspException {
JspWriter out=getJspContext().getOut();
try {
for(int i=0;i<loop;i++){
out.print(this.body);
if(this.br) out.print("<br>");
}
JspFragment f=getJspBody();
if (f != null) f.invoke(out);
} catch (java.io.IOException ex) {
throw new JspException(ex.getMessage());
}
}
public void setBody(java.lang.String value) {
this.body = value;
}
public void setLoop(int value) {
this.loop = value;
}
public void setBr(boolean value) {
this.br = value;
}
}
在部署描述符(web.xml) 中引入标记库
在web-app标记中插入:
<taglib>
<taglib-uri>/xgtimes/tlds</taglib-uri>
<taglib-location>/WEB-INF/tlds/xgtimes.tld</taglib-location>
</taglib>
在index.jsp 中使用定制标签
首先引入标记库到页面
<%@ taglib prefix="xgtimes" uri="/xgtimes/tlds" %>
然后,插入定制标签
<xgtimes:print body="hello,xgtimes!" br="true" loop="10" />
效果如下: