JavaEE-JSP基础-自定义标签

作用:
虽然JSTL标准标签库提供了很多通用标签,
但实际开发需求复杂多变,
这些通用标签是不能完全在JSP页面替代java代码,
因此需要我们自定义标签来替代java代码!

1.传统标签

1).原理

Tag接口       
    |---IterationTag接口
        |---TagSupport类--
        |---BodyTag接口  |
                BodyTagSupprot类

Tag生命周期:
第一次使用时创建实例,从此驻留内存重复利用,每次都会依次执行:
setPageContext(PageContext pc) 传入jsp对象
setParent(Tag t) 传入父标签
doStartTag() 通过返回值来控制标签体是否执行
doEndTag() 通过返回值控制标签后jsp页面是否执行
release() 服务器停止前调用销毁对象

2).自定义步骤:

1).编写一个类实现Tag接口
2).编写一个tld文件描述Tag类
3).在jsp页面中引入tld文件

传统标签自定义相当繁琐,需分析开始标签和结束标签时,还需分析返回标签体控制程序,
一般不推荐使用,简单标签SimpleTag更方便开发！

2.简单标签

1).原理

SimpleTag接口
    |---SimpleTagSupport实现类

SimpleTag生命周期:
每次访问标签时都创建简单标签对象,用完即销毁。
setJspContext(JspContext pc) 传入当前jsp的PageContext对象
setParent(JspTag parent) 若标签有父标签,则调用传入
setXXX() 若标签有属性,则调用传入
setJspBody(JspFragment jspBody) 若标签有标签体,则调用传入
doTag() 处理标签替代的java代码

2).自定义步骤

1).编写一个类继承SimpleTagSupport,覆盖doTag(),调用getJspContext/getJspBody获取JSP内容;
public class MyTag extends SimpleTagSupport {   
    @Override
    public void doTag(){            
        // 标签体重复输出
        for(int i=0;i<attr;i++)
            getJspBody().invoke(null);

    /*  // 默认会执行标签后续JSP页面
        // 抛出SkipPageException异常,不执行后续JSP页面
        throw new SkipPageException();

        // 获取标签体
        StringWriter writer = new StringWriter();
        getJspBody().invoke(writer);
        String str = writer.toString(); 
        // 修改后输出
        getJspContext().getOut().write(str.toUpperCase()); */
    }

    // 自定义标签属性attr
    private int attr;   
    public void setAttr(int attr) {
        this.attr = attr;
    }
}

2).在WEB-INF目录下编写一个tld文件,描述自定义SimpleTag类;
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
    <tlib-version>1.0</tlib-version>
    <short-name>MyTag</short-name>
    <uri>http://www.xxx.com/MyTag</uri>
    <tag>
        <name>myTag</name> 标签名
        <tag-class>com.xx.MyTag</tag-class> 标签处理类           
        <body-content>scriptless/empty</body-content>
                    scriptless不能含Java脚本代码
                    empty代表只能为空         
                    tagdependent不会输出到浏览器
                    JSP代表任意内容,不能在简单标签使用,只能在传统标签使用

        <attribute> 声明属性
            <name>attr</name> 属性名
            <required>true</required> 是否为必须存在
            <rtexprvalue>true</rtexprvalue> 是否支持EL表达式
            <type>int</type> 属性java类型
        </attribute>
    </tag>
</taglib>       

3).在jsp页面中引入tld文件,使用自定义标签
    <%@ taglib uri="http://www.xxx.com/MyTag" prefix="MyTag"%>
    <MyTag:myTag attr="10">循环输出文本</MyTag:myTag>

简书: http://www.jianshu.com/p/55afd8a45a02
CSDN博客: http://blog.csdn.net/qq_32115439/article/details/54695126
GitHub博客：http://lioil.win/2017/01/23/JSP-MyTag.html
Coding博客：http://c.lioil.win/2017/01/23/JSP-MyTag.html