深入理解Jsp自定义标签

1.创建第一个自定义标签

 1> 首先导入tomcat下的自带的lib下的jsp.jar（直接一次全导入lib下的所有包更省事- .-）; 2> 编写一个普通的java类，继承SimpleTagSupport类，叫标签处理器类。

public class ShowIpTag extends SimpleTagSupport {    private JspContext context;    @Override    public void setJspContext(JspContext pc) {        this.context = pc;    }    @Override    public void doTag() throws JspException, IOException {        //doSomething        ...}

 3>在web项目的WEB-INF目录下建立cyy.tld文件，这个tld叫标签库的声明文件。（参考核心标签库的tld文件）;

<?xml version="1.0" encoding="UTF-8" ?><taglib xmlns="http://java.sun.com/xml/ns/javaee"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"    version="2.1">  <!-- 标签库的版本 -->  <tlib-version>1.1</tlib-version>  <!-- 标签库前缀 -->  <short-name>cyy</short-name>  <!-- tld文件的唯一标记 -->  <uri>“填你想填的这里用http://cyy.com.cn”</uri>  <!-- 一个标签的声明 -->  <tag>    <!-- 标签名称 -->    <name>showIp</name>    <!-- 标签处理器类的全名 -->    <tag-class>ShowIpTag</tag-class>    <!-- 输出标签体内容格式 -->    <body-content>scriptless</body-content>  </tag></taglib>

 4>在jsp页面的头部导入自定义标签库

<%@taglib uri="http://cyy.com.cn" prefix="cyy"%>

 5> 在jsp中使用自定义标签

<cyy:showIp>xxxx</cyy:showIp>

2.自定义标签的执行过程
问题： http://localhost:8080/test.jsp 如何访问到自定义标签？

前提： tomcat服务器启动时，加载到每个web应用，加载每个web应用的WEB-INF目录下的所有文件。例如。web.xml, tld文件.

执行过程 :
1）访问test.jsp资源
2）tomcat服务器把jsp文件翻译成java源文件->编译class->构造类对象->调用_jspService（）方法
3）检查jsp文件的taglib指令，是否存在一个名为http://cyy.com.cn的tld文件。如果没有，则报错
4）上一步已经读到cyy.tld文件
5）读到 到cyy.tld文件中查询是否存在为showIp的标签
6）找到对应的标签，则读到内容
7）得到 ShowIpTag。 构造ShowIpTag对象，然后调用ShowIpTag里面的方法

3.自定义标签处理器类的生命周期
SimpleTag接口：

void setJspContext(JspContext pc) –设置pageContext对象，传入pageContext（一定调用）通过getJspCotext()方法得到pageContext对象
void setParent(JspTag parent) –设置父标签对象，传入父标签对象，如果没有父标签，则不 调用此方法。通过getParent()方法得到父标签对象。
void setXXX(值) –设置属性值。
void setJspBody(JspFragment jspBody) –设置标签体内容。标签体内容封装到JspFragment对象 中，然后传入JspFragment对象。通过getJspBody()方法 得到标签体内容。如果没有标签体内容，则不会调用此方法
void doTag() –执行标签时调用的方法。（一定调用）。

4.自定义标签的作用

• 控制标签体内容是否输出；
• 控制标签余下内容是否输出；
• 控制重复输出标签体内容；
• 改变标签体内容；
• 带属性的标签

---

自己写了一个DemoTag试下上面自定义标签几个功能。

public class DemoTag extends SimpleTagSupport {    @Override    public void doTag() throws JspException, IOException {        System.out.println("执行了doTag()---");        /**         * 1）控制标签体内容是否输出         *      输出：调用jspFragment的invoke方法         *      不输出：不调用invoke方法         */        //1.1得到标签体内容        JspFragment jspBody = this.getJspBody();        /**         * 执行invoke方法：把标签体内容输出到指定的Writer对象         */        //1.2 往浏览器输出内容，writer为null就是默认往浏览器输出        //JspWriter out =  this.getJspContext().getOut();        //jspBody.invoke(out);        //jspBody.invoke(null);//等价于上面两句代码        /**         * 3)控制重复输出标签体内容         */        /*for (int i = 0; i < 5; i++) {            jspBody.invoke(null);        }*/        /**         * 4）改变标签体内容         */        //4.1创建StringWriter临时容器        StringWriter sw = new StringWriter();        //4.2把标签体拷贝到临时容器        jspBody.invoke(sw);        //4.3从临时容器中得到标签体内容        String content = sw.toString();        //4.4改变内容        content = content.toLowerCase();        //4.5把改变内容输出到浏览器        this.getJspContext().getOut().write(content);        /**         * 2）控制标签余下内容是否输出         *      输出: 什么都不干！         *      不输出： 抛出SkipPageException异常         */        throw new SkipPageException();    }}