自定义标签 三 simpleTag

1.由于传统标签使用三个标签接口来完成不同的功能，显得过于繁琐，不利于标签技术的推

广， SUN公司为降低标签技术的学习难度，在JSP 2.0中定义了一个更为简单、便于编写和

调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。

2.简单标签共定义了5个方法：

setJspContext方法
用于把JSP页面的pageContext对象传递给标签处理器对象
setParent方法
用于把父标签处理器对象传递给当前标签处理器对象
getParent方法
用于获得当前标签的父标签处理器对象
setJspBody方法
用于把代表标签体的JspFragment对象传递给标签处理器对象
doTag方法
用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出

javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结

束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况

3.当web容器开始执行标签时，会调用如下方法完成标签的初始化
(1)WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象

传递给标签处理器对象。

(2)WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处

理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法。

(3)如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标

签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的

值，然后把值传递给标签处理器对象。

(4)如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传

递进来。

[color=red][size=medium]4.执行标签时：
容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的。[/size][/color]


以下为simpleTag的实现例子 通常继承于SimpleTagSupport
//控制标签体是否执行
public class SimpleTagDemo1 extends SimpleTagSupport {

@Override
public void doTag() throws JspException, IOException {
JspFragment jf = this.getJspBody(); //得到标签体
//jf.invoke(this.getJspContext().getOut());
jf.invoke(null);//等价于上一行代码
}
}

//重复执行标签体
public class SimpleTagDemo2 extends SimpleTagSupport {

@Override
public void doTag() throws JspException, IOException {

JspFragment jf = this.getJspBody();

for(int i=0;i<5;i++){
jf.invoke(null);
}
}
}


//修改标签体内容
public class SimpleTagDemo3 extends SimpleTagSupport {

@Override
public void doTag() throws JspException, IOException {

JspFragment jf = this.getJspBody();
StringWriter sw = new StringWriter();
//StringWriter类可以得到缓存里面的数据。
jf.invoke(sw);

String content = sw.toString();
content = content.toUpperCase();

this.getJspContext().getOut().write(content);
}
}

//余下 的jsp不执行
public class SimpleTagDemo4 extends SimpleTagSupport {

@Override
public void doTag() throws JspException, IOException {
throw new SkipPageException();
}

}

//想要移除在jsp中的代码，可以将jsp页面中的java代码，放在doTag方法里面执行