美文网首页
JavaEE-JSP基础-自定义标签

JavaEE-JSP基础-自定义标签

作者: lioilwin | 来源:发表于2017-08-24 22:26 被阅读30次

    作用:
    虽然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

    相关文章

      网友评论

          本文标题:JavaEE-JSP基础-自定义标签

          本文链接:https://www.haomeiwen.com/subject/dtdydxtx.html