第9章 简单标签
9.1 简单标签知识
在Jsp2.0中定义SimpleTag 接口用于替换传统的标签开发的接口,它只有一个方法doTag() 用于取代传统的doStartTag()、doEndTag()、doAfterBody() 等方法。
1、 JSP引擎调用标签处理器对象的setJspContext(),将JSP页面的pageContext()对象传递给标签处理器对象。
2、 JSP引擎调用setParent(),将父标签处理器对象传递给标签处理器对象。
3、 如果调用标签设置属性,容器将每个属性对应的setter()方法把属性值传递给标签处理器对象。
4、 如果有标签体,容器将标签体封装为JspFragment对象,然后调用setJspBody()将JspFragment对象传递给标签处理器对象。
5、 调用doTag()方法执行标签逻辑。
9.1.1 SimpleTag接口
SimpleTag接口定义方法:
1、 setJspContext()
public void setJspContext(JspContext context);
JSP页面的pageContext对象传递给标签处理器对象。
2、 setParent()
public void setParent(JspTag parent);
把父标签处理器对象传递给当前标签处理器对象。
3、 getParent()
public JspTag getParent();
获取当前父标签处理器对象。
4、 setJspBody()
public void setJspBody(JspFragment jspBody);
把代表标签体的JspFragment对象传递给标签处理器对象。
5、 doTag()
public void doTag();
用于完成标签处理逻辑。
9.1.2 JspFragment类
JSP引擎处理标签体内容时会把标签体内容用一个JspFragement对象表示,并调用标签体处理器对象的setJspBody()把JspFragement对象传递给标签处理器对象,标签开发者根据需要调用JspFragement对象的方法,决定是否执行和输出标签体。
1、 getJspContext()
public abstract JspContext getJspContext();
用于返回调用页面的JspContext对象。
2、 invoke()
public abstract void invoke(Writer out);
用于执行JspFragment对象代表的JSP代码片段。
9.1.3 SimpleTagSupport类
SimpleTagSupport类是SimpleTag接口的实现。
9.2 简单标签实例
public class SimpleTagDemo extends SimpleTagSupport {
private String username;
public void setUsername(String username) {
this.username = username;
}
@Override
public void doTag() throws JspException, IOException {
if ("wangtong".equals(username)) {
JspFragment fragment = this.getJspBody();
fragment.invoke(null);
} else {
getJspContext().getOut().write("用户名不正确");
throw new SkipPageException();
}
}}
<tag> <name>simpleTag</name> <tag-class>tag.simpletag.SimpleTagDemo</tag-class> <body-content>scriptless</body-content> <attribute> <name>username</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag>
<wangtong:simpleTag username="wangtong">
username
</wangtong:simpleTag>
9.3 迭代数组
public class SimpleIterateTag extends SimpleTagSupport {
private String name;
private String items[];
public void setName(String name) {
this.name = name;
}
public void setItems(String[] items) {
this.items = items;
}
@Override
public void doTag() throws JspException, IOException {
for (String i : items) {
getJspContext().setAttribute(name, i);
getJspBody().invoke(null);
}}}
<tag> <name>simpleIterateTag</name> <tag-class>tag.simpletag.SimpleIterateTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>name</name> <required>true</required> </attribute> <attribute> <name>items</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag>
<%
String[] books = { "book1", "book2", "book3" };
%>
<wangtong:simpleIterateTag items="<%=books%>" name="bookname">
${bookname}
</wangtong:simpleIterateTag>
9.4 修改标签体内容
public class ReadFileTag extends SimpleTagSupport {
private String src;
public void setSrc(String src) {
this.src = src;
}
@Override
public void doTag() throws JspException, IOException {
InputStream in;
BufferedReader br;
try {
in = ((PageContext) getJspContext()).getServletContext()
.getResourceAsStream(src);
br = new BufferedReader(new InputStreamReader(in));
String line = br.readLine();
while (line != null) {
this.getJspContext().getOut().write("line" + "\r\n");
line = br.readLine();
}
br.close();
} catch (Exception e) {
e.getMessage();
}}}
public class HtmlFilterTag extends SimpleTagSupport {
@Override
public void doTag() throws JspException, IOException {
JspFragment fragment = this.getJspBody();
StringWriter writer = new StringWriter();
fragment.invoke(writer);
String newBody = filter(writer.toString());
this.getJspContext().getOut().write(newBody);
}
private String filter(String message) {
if (message == null) {
return null;
}
char content[] = new char[message.length()];
message.getChars(0, message.length(), content, 0);
StringBuffer result = new StringBuffer(content.length + 50);
for (int i = 0; i < content.length; i++) {
switch (content[i]) {
case '<':
result.append("<");
break;
case '>':
result.append(">");
break;
case '&':
result.append("&");
break;
case '"':
result.append(""");
break;
default:
result.append(content[i]);
}
}
return result.toString();
}}
<tag> <name>simpleHtmlFilter</name> <tag-class>tag.simpletag.ReadFileTag</tag-class> <body-content>scriptless</body-content> </tag> <tag> <name>simpleReadFile</name> <tag-class>tag.simpletag.HtmlFilterTag</tag-class> <body-content>empty</body-content> <attribute> <name>src</name> <required>true</required> </attribute> </tag>
<wangtong:simpleHtmlFilter>
<wangtong:readfile src="/tag.jsp" />
</wangtong:simpleHtmlFilter>