JavaWeb学习记录（十九）——jstl自定义标签库之传统标签

一、传统标签

（1）JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用它的方法。

public void setPageContext(PageContext pc)， JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。

public void setParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null。

public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。

public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。

public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务，直至停止web应用时，web容器才会调用release方法。

 

（2）tld文件中的四种标签体类型EMPTY  JSP  scriptless  tagdepentend

empty：表示标签没有标签体

scriptless：表示标签体可以包含EL表达式和JSP的动作元素，但不能包含脚本表达式

JSP：表示标签体可以包含JSP代码

tagdependent：表示标签体由标签本身去解析处理。若指定tagdependent，那么在标签体中所写的代码将作为纯文本原封不动地传给标签处理类，而不是将执行结果传给标签处理类

（3）开发人员在编写Jsp页面时，经常还需要在页面中引入一些逻辑：

　　SKIP_BODY                  隐含0：跳过了开始和结束标签之间的代码。

　　EVAL_BODY_INCLUDE隐含1：将body的内容输出到存在的输出流中

　　SKIP_PAGE                  隐含5：忽略剩下的页面。

　　EVAL_PAGE                 隐含6：继续执行下面的页

（4）JSP 1.1和1.2规范中常用的接口主要有以下3个。

　　Tag：此接口定义对于所有标签处理类都需要实现的方法。

　　IterationTag：此接口扩展了Tag接口，增加了控制重复执行标签主体的方法。

　　BodyTag：此接口扩展了IterationTag接口，并增加了访问和操作标签主体内容的方法。

（5）<taglib>元素是标签库描述符的根元素，它包含12个子元素，详细介绍如下。

　　(1)<description>：标签库的一个文本描述。

　　(2)<tlib-version>：指定标签库的版本。

　　(3)<short-name>：为标签定义简短的名字，在taglib指令中可作为首选的前缀名使用。

　　(4)<uri>：定义一个URI，用于唯一地标识此标签库。

　　(5)<tag>：用于指定自定义标签的相关信息。

　　(6)<display-name>：为标签库指定一个简短的别名。

　　(7)<small-icon>：为标签库指定大小为16×16的小图标(gif或jpeg格式)，该图标可在图形界面工具中显示。

　　(8)<large-icon>：为标签库指定大小为32×32的大图标(gif或jpeg格式)，该图标可在图形界面工具中显示。

　　(9)<validator>：为标签库提供一个验证器。

　　(10)<listener>：为标签库提供一个监听器。

　　(11)<tag-file>：用于描述标签文件。

　　(12)<function>：用于指定在表达式语言中使用的函数。

（6）案例说明

　　//根据条件是否成立，决定是否执行标签体
public class TagDemo1 extends TagSupport {

@Override
    public int doStartTag() throws JspException {
        return Tag.SKIP_BODY;
    }
}

页面：
<html>
  <head>    
    <title>控制标签体是否执行</title>
  </head>
 
  <body>
 
  <hytc:demo1>
      xxxxxxxxxxxxxxx
  </hytc:demo1>
  </body>
</html>

2.忽略内容

public class TagDemo2 extends TagSupport {

@Override
    public int doEndTag() throws JspException {
        
        return Tag.SKIP_PAGE;
    }

}

页面：
<hytc:demo2></hytc:demo2>
<html>
  <head>    
    <title>用标签控制整个jsp是否执行</title>
  </head>
 
  <body>
    This is my JSP page. <br>
  </body>
</html>

3.//控制标签体重复执行10次
public class TagDemo3 extends TagSupport {

int x = 10;
    @Override
    public int doStartTag() throws JspException {
        
        return Tag.EVAL_BODY_INCLUDE;
    }

@Override
    public int doAfterBody() throws JspException {
        if(x>1){
            x--;
            return IterationTag.EVAL_BODY_AGAIN;
        }else{
            return Tag.SKIP_BODY;
        }
    }    
}
页面：
<html>
  <head>    
    <title>用标签控制页面内容重复执行</title>
  </head>
 
  <body>
   
   <hytc:demo3>
       aaaa
   </hytc:demo3>
  </body>
</html>

4.
public class TagDemo4 extends BodyTagSupport {

@Override
    public int doStartTag() throws JspException {        
        return BodyTag.EVAL_BODY_BUFFERED;
    }

@Override
    public int doEndTag() throws JspException {
        BodyContent bt = this.bodyContent;
        String content = bt.getString();
        content = content.toUpperCase();
        
        JspWriter out = this.pageContext.getOut();
        try {
            out.write(content);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
        return super.doEndTag();
    }
    
}

页面：
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>    
    <title>修改jsp页面内容</title>
  </head>
 
  <body>
   
   <hytc:demo4>
       aaaaa
   </hytc:demo4>
   
  </body>
</html>

5.配置描述文件

　　<tag>
        <name>demo1</name>
        <tag-class>web_16.tag.TagDemo1</tag-class>
        <body-content>JSP</body-content>
    </tag>
    
     <tag>
        <name>demo2</name>
        <tag-class>web_16.tag.TagDemo2</tag-class>
        <body-content>empty</body-content>
    </tag>
    
     <tag>
        <name>demo3</name>
        <tag-class>web_16.tag.TagDemo3</tag-class>
        <body-content>JSP</body-content>
    </tag>
    
    <tag>
        <name>demo4</name>
        <tag-class>web_16.tag.TagDemo4</tag-class>
        <body-content>JSP</body-content>
    </tag>