SimpleTagSupport类顾名思义,就是可以处理一些简单的自订标签需求,它是在JSP
2.0之后新增的类,对于一些简单的自订标签页求,您可以继承它来实现标签处理类,而不用为了处理一些TagSupport、
BodyTagSuppourt类中回传值的问题。
为了使用上的简单而降低了复杂性,另一方面就是SimpleTagSupport类所处理的功能受了些限制,它只处理标签与本体,要不要显示本体文字取
决于您,对于标签之后的页面则不在SimpleTagSupport处理的范围之内(虽然您还是可以使用forward之类的方式来决定要不要显示之后的
页面,但直接实现TagSupport会更方便一些),另外SimpleTagSupport类的本体文字不能设定为JSP,这也是使用
SimpleTagSupport上的一些限制。
尽管有了一些限制,对于简单的自订标签需求,使用SimpleTagSupport还是比较容易的,它实现了SimpleTag接口,您只要覆盖 doTag()方法就可以实现自订标签的处理,先来看一个简单的范例:
package onlyfun.caterpillar; import java.io.*; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; public class SimpleHelloTag extends SimpleTagSupport { public void doTag() throws JspException, IOException { JspWriter out = getJspContext().getOut(); out.println("Hello!World!"); } }
假设在tld档中设定是这样的:
... <tag> <description>Simple Tag</description> <name>hello</name> <tag-class>onlyfun.caterpillar.SimpleHelloTag</tag-class> <body-content>empty</body-content> </tag> ...
则我们就可以在JSP网页中这么使用以显示一段Hello!World!文字:
<caterpillar:hello/>
当然要真正显示字符串,别忘了web.xml中的设定与taglib的设定,前面已经说过好多次,不再重复了。
SimpleTagSupport默认不显示本体文字,如果您想要自订可以显示本体文字的标签,则可以这么撰写:
package onlyfun.caterpillar; import java.io.*; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; public class SimpleHelloTag extends SimpleTagSupport { public void doTag() throws JspException, IOException { JspFragment frag = getJspBody(); frag.invoke(null); } }
getJspBody()方法传回JspFragment对象,它包括了标签本体的相关讯息,使用invoke()方法可以将这些讯息写入指定的
Writer中,如果设定为null,则默认写入getJspContext().getOut()取得的Writer,假设 tld档是这样设定:
... <tag> <description>Simple Tag</description> <name>showbody</name> <tag-class>demo.tags.SimpleTagText</tag-class> <body-content>tagdependent</body-content> </tag> ...
则可以在JSP网页中这么使用它,作用只是将本体文字再显示出来:
<caterpillar:showbody>
显示这段文字。。。。
</caterpillar:showbody>
除了使用上面的方式来包装本体文字至JspFragment中之外,您还可以< jsp:attribute>动作元素,将指定的文字包装为JspFragment,例如先撰写以下的标签处理类:
package onlyfun.caterpillar; import java.io.*; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; public class SimpleFragTag extends SimpleTagSupport { private JspFragment fragment1; private JspFragment fragment2; public void setFragment1(JspFragment fragment1) { this.fragment1 = fragment1; } public void setFragment2(JspFragment fragment2) { this.fragment2 = fragment2; } public void doTag() throws JspException, IOException { fragment2.invoke(null); fragment1.invoke(null); } }
这个处理类将接受两个JspFragment,为了要能包装JspFragment,必须在tld档中指定:
... <tag> <description>Simple Tag</description> <name>fragtest</name> <tag-class>onlyfun.caterpillar.SimpleFragTag</tag-class> <body-content>empty</body-content> <attribute> <name>fragment1</name> <required>true</required> <fragment>true</fragment> </attribute> <attribute> <name>fragment2</name> <required>true</required> <fragment>true</fragment> </attribute> </tag> ...
这次在设定属性时,指定<fragment>为true,表示属性将接受JspFragment对象,接下来这样测试:
<%@taglib prefix="caterpillar" uri="http://caterpillar.onlyfun.net/"%> <html> <body>
<caterpillar:fragtest> <jsp:attribute name="fragment1"> Frag1 Test ..... <br> </jsp:attribute> <jsp:attribute name="fragment2"> Frag2 Test .... <br> </jsp:attribute> </caterpillar:fragtest>
</body> </html>
这个JSP网页的传回结果如下:
<html>
<body>
Frag2 Test .... <br>Frag1 Test ..... <br>
</body>
</html>
如果您想要处理标签的本体文字内容的话该怎么办呢?invoke()方法可以将文字写入指定的Writer中,可以使用StringWriter,将文字写入当中,然后再取得String对象就可以进行处理了,例如:
package onlyfun.caterpillar; import java.io.*; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; public class SimpleDemoTag extends SimpleTagSupport { public void doTag() throws JspException, IOException { JspFragment frag = getJspBody(); JspWriter out = getJspContext().getOut(); StringWriter writer = new StringWriter(); frag.invoke(writer); String str = writer.toString(); out.println(str.replaceAll("<%","<%")); } }
上面的程序示范了如何处理本体文字,这个标签处理类将所有的 <% 置换 <。 |