为什么要用到简单标签？

上一篇博客中我已经讲解了传统标签，想要开发自定义标签，大多数情况下都要重写doStartTag(),doAfterBody()和doEndTag()方法，并且还要知道SKIP_BODY,EVAL_BODY等等的变量代表着什么，在什么方法中使用。这样实在是太麻烦了！

因此，为了简化标签开发的复杂度，在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。。

一般来说，实现了SimpeTag接口的标签称之为简单标签

SimpleTag接口

• 首先我们来看一下它的源码吧：
  

  public interface SimpleTag extends JspTag {
        void doTag() throws JspException, IOException;
        void setParent(JspTag var1);
        JspTag getParent();
        void setJspContext(JspContext var1);
        void setJspBody(JspFragment var1);
    }

setParent()和getParent()方法就不多说了，我们来看一下剩下的3个方法：

    void doTag() throws JspException, IOException;
        void setJspContext(JspContext var1);
        void setJspBody(JspFragment var1);

• 明显地：
  

• doTag()就是我们要写代码处理逻辑地方
  
• setJspContext(JspContext var1)是将PageContext对象传递给标签处理器类(PageContext是JspContext的子类)
  
• setJspBody(JspFragment var1)把代表标签体的JspFragment对象传递给标签处理器对象
  

快速入门

• 一般地，我们做开发都是继承SimpleTagSupport类（该类实现了SimpleTag）来编写自定义标签
  
• 下面我们就来个快速入门吧：
  
• 目标：传入字符串格式就可以显示想要的格式日期，对比之前传统标签的，看有什么不同之处
  
• 标签处理器类：
  

   public class Demo1 extends SimpleTagSupport {
        String format = null;
        @Override
        public void doTag() throws JspException, IOException {
            SimpleDateFormat simpleDateFormat = new SimpleDateFormat(format);
            this.getJspContext().getOut().write(simpleDateFormat.format(new Date()));
        }
        public String getFormat() {
            return format;
        }
        public void setFormat(String format) {
            this.format = format;
        }

tld文件：

   <tag>
        <name>formatDate</name>
        <tag-class>tag.Demo1</tag-class>
        <body-content>tagdependent</body-content>
        <attribute>
            <name>format</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>

效果：

• 简单标签的好处就是不用去理会doStartTag、doEndTag、SKIP_BODY以及一系列的方法和属性！
  
• 简单标签一个doTag()方法走天下！
  

SimpleTagSupport类的执行顺序：

• ①WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象
  
• ②WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。【注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法】
  
• ③如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象。
  
• ④如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来
  
• ⑤执行标签时：容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的。
  

深入简单标签

在我们讲解传统标签的时候，配合着SKIP_BODY、SKIP_PAGE等变量可以实现如下的功能：

1. 控制jsp页面某一部分内容(标签体)是否执行。
   
2. 控制整个jsp页面是否执行。
   
3. 控制jsp页面内容重复执行。
   
4. 修改jsp页面内容输出。
   

• 简单标签可没有这些变量呀，那它怎么才能实现上面那些功能呢？
  
• 在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况，我们来测试一下，在上面例子的代码中添加：
  

thrownewSkipPageException();

• 效果：
  

• 至于其他的功能下面会讲到！
  

带标签体的简单标签

• SimpleTagSupport也可以带标签体，但是处理方法和传统标签完全不同。
  

• 传统标签是这样子的：将标签体的内容通过setBodyContent()注入到BodyContent对象中。
  
• 简单标签是这样子的：通过JspFragment对象实现！
  

• 我们来看一下JspFragment对象的源码吧：
  

    public abstract class JspFragment {
        public JspFragment() {
        }
        public abstract void invoke(Writer var1) throws JspException, IOException;
        public abstract JspContext getJspContext();
    }

JspFragment对象十分简单，重要的只有invoke(Writer var1)方法（获取JspContext对象并不重要，在标签描述器上就可以获取到了）

public abstract void invoke(java.io.Writer out) ：

• 用于执行JspFragment对象所代表的JSP代码片段
  
• 参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中，如果传递给参数out的值为null，则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)
  

• 下面是标签处理器类的代码：
  

   public class Demo1 extends SimpleTagSupport {
        @Override
        public void doTag() throws JspException, IOException {
            //得到代表标签体的对象
            JspFragment jspFragment = getJspBody();
            //invoke方法接收的是一个Writer，如果为null，就代表着JspWriter()，将标签体的数据写给浏览器！
            jspFragment.invoke(null);
        }
    }

效果：

• 写给浏览器的，那么那么那么，我只要控制好invoke()方法，我想干什么就干什么！
  
• 也就是说：
  

• 不调用invoke()方法，标签体内容就不会输出到浏览器上
  
• 重复调用invoke()方法，标签体内容就会被重复执行
  
• 若想在标签处理器中修改标签体内容，只需在调用invoke方法时指定一个可取出结果数据的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的
  

• 来来来，我们来试验一下：
  

  public void doTag() throws JspException, IOException {
        //得到代表标签体的对象
        JspFragment jspFragment = getJspBody();
        //jspFragment.invoke(null);
    }

   public void doTag() throws JspException, IOException {
        //得到代表标签体的对象
        JspFragment jspFragment = getJspBody();
        jspFragment.invoke(null);
        jspFragment.invoke(null);
    }

      //得到代表标签体的对象
        JspFragment jspFragment = getJspBody();
        //创建可以存储字符串的Writer对象
        StringWriter stringWriter = new StringWriter();
        //invoke()方法把标签体的数据都写给流对象中
        jspFragment.invoke(stringWriter);
        //把流对象的数据取出来，流对象的数据就是标签体的内容
        String value = stringWriter.toString();
        //将数据改成是大写的，写到浏览器中
        getJspContext().getOut().write(value.toUpperCase());

• 标签体的内容被改成了大写！
  
• invoke()方法指定别的输出流（StringWriter），将标签体的内容写到流对象中，再通过流对象把数据取出来，达到修改的目的。
  
• 标签体的内容被输出了两次！
  
• 调用两次invoke()方法
  
• 标签体的内容没有输出
  
• 不调用invoke()方法
  

我们可以发现，传统标签能完成的功能，简单标签都可以完成，并且更为简单！