在jsp1.2之前如果想要对标签库进行开发,要么继承TagSupport类,要么继承BodyTagSupport类,而且必须覆写其中的doStartTag(),doAfterBody(),doEndTag()方法,而且还必须清楚这些方法的返回值类型;这样的过程太复杂了,到了JSP2.0后,简化标签的开发,专门增加了一个制作简单的标签库SimpleTagSupport类。直接覆写其中的doTag()方法即可;
SimpleTagSupport类的定义如下:
public class TagSupport extends Object implements SimpleTag
此类实现了SimpleTag接口,SimpleTag接口如下:
public interface SimpleTag extends JspTag{ public void doTag() throws JspException,IOException; public void setParent(JspTag parent); public JspTag getParent(); public void setJspContext(JspContext pc); public void setJspBody(JspFragment jspBody); }
SimpleTagSupport类的主要方法:
No | 方法 | 类型 | 描述 |
1 | public void doTag() throws JspException,IOException | 普通 | 完成具体标签功能的编写 |
2 | public JspContext getJspContext() | 普通 | 取得JSP上下文,主要用于输出 |
3 | protected JspFragment getJspBody() | 普通 | 取得JspFragment对象,主要用于迭代输出 |
SimpleDateTag:
package com.keith.tag; import java.io.IOException; import java.text.SimpleDateFormat; import java.util.Date; import javax.servlet.jsp.JspException; import javax.servlet.jsp.tagext.SimpleTagSupport; public class SimpleDateTag extends SimpleTagSupport { //接受格式化数据 private String format; @Override public void doTag() throws JspException, IOException { //日期格式化 SimpleDateFormat sdf = new SimpleDateFormat(this.format); try { //输出格式化后的日期 super.getJspContext().getOut().write(sdf.format(new Date())); } catch (IOException e) { e.printStackTrace(); } } public String getFormat() { return format; } public void setFormat(String format) { this.format = format; } }
simpledatetag.tld:
<?xml version="1.0" encoding="UTF-8"?> <taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1"> <tlib-version>1.0</tlib-version> <short-name>simpledatetag</short-name> <tag> <name>simpledate</name> <tag-class>com.keith.tag.SimpleDateTag</tag-class> <body-content>empty</body-content> <attribute> <name>format</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib>
index.jsp:
<%@ taglib prefix="simpledatetag" uri="simpledate"%> <body> <simpledatetag:simpledate format="yyyy-MM-dd HH:mm:ss.SSS"/> </body>
测试看下结果!
要是面对迭代问题呢?在以前,是通过TagSupport类实现的迭代操作,则可以通过控制返回值的方式,让程序循环执行doAfterBody()方法,但先在通过SimpleTagSupport类实现的doTag()方法,本身没有返回值,如果想达到循环的效果,就必须通过JspFragment类完成控制。
在SimpleTagSupport类中存在一个getJspBody()方法,此方法返回的就是一个Fragment对象,利用此对象的invoke()方法即可完成标签体内容的输出;
SimpleIterateTag:
package com.keith.tag; import java.io.IOException; import java.util.Iterator; import java.util.List; import javax.servlet.jsp.JspException; import javax.servlet.jsp.PageContext; import javax.servlet.jsp.tagext.SimpleTagSupport; public class SimpleIterateTag extends SimpleTagSupport { private String id; private String name; private String scope; @Override public void doTag() throws JspException, IOException { Object value = null; // 是否是page范围 if ("page".equals(this.scope)) { value = super.getJspContext().getAttribute(name, PageContext.PAGE_SCOPE); } else if ("request".equals(this.scope)) { // 是否是request范围 value = super.getJspContext().getAttribute(name, PageContext.REQUEST_SCOPE); } else if ("session".equals(this.scope)) { // 是否是session范围 value = super.getJspContext().getAttribute(name, PageContext.SESSION_SCOPE); } else { // 是否是application范围 value = super.getJspContext().getAttribute(name, PageContext.APPLICATION_SCOPE); } // 如果是List接口的实例 if (value != null && value instanceof List<?>) { Iterator<?> iter = ((List<?>) value).iterator(); while (iter.hasNext()) { super.getJspContext().setAttribute(id, iter.next()); super.getJspBody().invoke(null); } } } public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getScope() { return scope; } public void setScope(String scope) { this.scope = scope; } }
simpleiteratetag.tld:
<?xml version="1.0" encoding="UTF-8"?> <taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1"> <tlib-version>1.0</tlib-version> <short-name>simpleiteratetag</short-name> <tag> <name>iterate</name> <tag-class>com.keith.tag.SimpleIterateTag</tag-class> <!-- 标签体内容, scriptless:表示标签体内容可以是文本,EL,JSP语法.不能包含JSP的脚本元素; empty:没有标签体; JSP:标签体可以包含文本,EL,或JSP标签,但是对于简单标签无效; tagdependent:表示标签体交由标签本身去解析处理,在标签体中的所有代码都会原封不动的交给标签处理器,而不是将执行结果传递给标签处理器; --> <body-content>scriptless</body-content> <attribute> <name>id</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>name</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>scope</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib>
web.xml:
<taglib> <taglib-uri>simpleiterate</taglib-uri> <taglib-location>/WEB-INF/simpleiteratetag.tld</taglib-location> </taglib>
index.jsp:
<%@ taglib prefix="simpleiteratetag" uri="simpleiterate"%> <body> <% List<String> all = new ArrayList<String>(); all.add("Java"); all.add("C"); all.add("Linux"); request.setAttribute("all",all); %> <simpleiteratetag:iterate name="all" scope="request" id="names"> ${names }<br /> </simpleiteratetag:iterate> </body>
访问页面进行测试!
DynamicAttributes接口:
每一个标签都可以定义属性,当使用一个标签时,只能编写指定个数及名称属性。在JSP2.0之后专门增加了一个DynamicAttribute接口,此接口的主要功能是用于完成动态属性的设置,即用户在使用一个标签时可以根据自己的需要,任意设置多个属性。
DynamicAttributes接口的定义如下:
public interface DynamicAttribute{ public void setDynamicAttribute(String uri,String localName,Object value)throws JspException; }
在这个接口里,只定义了一个setDynamicAttribute()方法,在此方法中秩序关心localName(表示动态设置的属性名词)和value(动态设置的属性内容)这2个参数!
下面使用动态属性完成一个动态加法操作,用户可以直接在加法的标签中设置任意多个参数,并通过标签将计算的结果输出:
DynamicAddTag:
package com.keith.tag; import java.io.IOException; import java.util.HashMap; import java.util.Iterator; import java.util.Map; import javax.servlet.jsp.JspException; import javax.servlet.jsp.tagext.DynamicAttributes; import javax.servlet.jsp.tagext.SimpleTagSupport; public class DynamicAddTag extends SimpleTagSupport implements DynamicAttributes{ //实现动态属性接口 private Map<String,Float> num = new HashMap<String,Float>(); @Override public void doTag() throws JspException, IOException { //定义变量保存相加的结果 Float sum = 0.0f; //迭代输出 Iterator<Map.Entry<String,Float>> iter = this.num.entrySet().iterator(); while (iter.hasNext()) { //取出每一个Map.Entry Map.Entry<String, Float> value = iter.next(); //执行累加操作 sum += value.getValue(); } //输出计算的结果 super.getJspContext().getOut().write(sum+""); } public void setDynamicAttribute(String uri, String localName, Object value) throws JspException { //取出设置的动态属性内容 num.put(localName, Float.parseFloat(value.toString())); } }
dynamicaddtag.tld:
<?xml version="1.0" encoding="UTF-8"?> <taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1"> <tlib-version>1.0</tlib-version> <short-name>dynamicadd</short-name> <tag> <name>add</name> <tag-class>com.keith.tag.DynamicAddTag</tag-class> <body-content>empty</body-content> <!-- 接受动态属性 --> <dynamic-attributes>true</dynamic-attributes> </tag> </taglib>
web.xml:
<taglib> <taglib-uri>dynamicaddtest</taglib-uri> <taglib-location>/WEB-INF/dynamicaddtag.tld</taglib-location> </taglib>
index.jsp:
<%@ taglib prefix="dynamicadd" uri="dynamicaddtest"%> <body> 计算结果:<dynamicadd:add num1="11.11" num2="10.12" num3="12.1"/> </body>
测试结果:计算结果:33.33