JavaWeb学习之JSTL自定义标签库的使用、JSTL自定义函数库（7）

一、自定义标签，步骤

    * 确定需求

        * <my:date />  输出当前系统的时间  yyyy-MM-dd hh:mm:ss:SSS

    * 编写Java类

        新建包名：com.yxl.tag,新建类MyDateTag，实现SimpleTag接口

        * 只要与此接口有关的实现类，javax.servlet.jsp.tagext.JspTag

        * 需要实现具体的接口

            * javax.servlet.jsp.tagext.SimpleTag,简单标签，JSP2.0**，选择这个

            * javax.servlet.jsp.tagext.Tag，经典标签

        package com.yxl.tag;

        import java.io.IOException;

        import java.text.SimpleDateFormat;

        import java.util.Date;

        import javax.servlet.jsp.JspContext;

        import javax.servlet.jsp.JspException;

        import javax.servlet.jsp.PageContext;

        import javax.servlet.jsp.tagext.JspFragment;

        import javax.servlet.jsp.tagext.JspTag;

        import javax.servlet.jsp.tagext.SimpleTag;

        public class MyDateTag implements SimpleTag {

            public MyDateTag(){

                System.out.println("默认构造");

            }

            private PageContext pageContext;

            /**

             * 1、被调用的方法，tomcat调用

             */

            public void setJspContext(JspContext pc) {

        //        System.out.println(pc);

        //        System.out.println("setJspContext");

                this.pageContext = (PageContext) pc;

            }

            /**

             * 2、tomcat调用

             *  建议，在doTage方法中完成整个tag的功能

             *  需要再doTage方法之前，完成准备工作

             */

            public void doTag() throws JspException, IOException {

        //        System.out.println("doTag");

                //输出当前系统的时间  yyyy-MM-dd hh:mm:ss:SSS

                SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss:SSS");

                String date = format.format(new Date());

                //将获得的时间输出到浏览器

                this.pageContext.getOut().print(date);

            }

            @Override

            public JspTag getParent() {

                // TODO Auto-generated method stub

                return null;

            }

            @Override

            public void setJspBody(JspFragment arg0) {

                // TODO Auto-generated method stub

            }

            @Override

            public void setParent(JspTag arg0) {

                // TODO Auto-generated method stub

            }

        }

    * 编写tld文件

        在WEB-INF下新建文件夹tld，在tld文件夹下新建mytag.tld

        * tld文件是xml文档

        * 扩展名为*.tld

        * 位置：必须放置到WEB-INF目录下

        * 内容：

            <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.0</tlib-version>

                <!-- 建议引入当前便签库是，使用的简写   @taglib prefix="my" -->

                <short-name>my</short-name>

                <!-- 为当前标签库配置文件，起一个名称

                    * 内容：自定义，全球唯一

                 -->

                <uri>http://www.yxl.cn/jsp/mytag</uri>

                <!-- <my:date / >  注册标签 -->

                <tag>

                    <!-- 确定标签名称 -->

                    <name>date</name>

                    <!-- 确定实现类 -->

                    <tag-class>com.yxl.tag.MyDateTag</tag-class>

                    <!-- 格式化当前标签的body内容

                        * empty：当前标签没有标签体

                     -->

                    <body-content>empty</body-content>

                </tag>

            </taglib>

    * 在JSP页面引入

        * <%@ taglib uri="http://www.yxl.cn/jsp/mytag" prefix="my"%>

    * 测试

        * <my:date />

二、案例

    * 需求：<my:maxVal num1="12" num2="13" />

    package com.yxl.tag;

    import java.io.IOException;

    import java.text.SimpleDateFormat;

    import java.util.Date;

    import javax.servlet.jsp.JspContext;

    import javax.servlet.jsp.JspException;

    import javax.servlet.jsp.PageContext;

    import javax.servlet.jsp.tagext.JspFragment;

    import javax.servlet.jsp.tagext.JspTag;

    import javax.servlet.jsp.tagext.SimpleTag;

    public class MyMaxValueTag implements SimpleTag {

        public MyMaxValueTag() {

            System.out.println("默认构造");

        }

        private PageContext pageContext;

        private Integer num1;

        private Integer num2;

        // num1

        public void setNum1(Integer num) {

            this.num1 = num;

        }

        public void setNum2(Integer num) {

            this.num2 = num;

        }

        /**

         * 1、被调用的方法，tomcat调用

         */

        public void setJspContext(JspContext pc) {

            // System.out.println(pc);

            // System.out.println("setJspContext");

            this.pageContext = (PageContext) pc;

        }

        /**

         * 2、tomcat调用 建议，在doTage方法中完成整个tag的功能 需要再doTage方法之前，完成准备工作

         */

        public void doTag() throws JspException, IOException {

            System.out.println(this.num1);

            System.out.println(this.num2);

            // 判断两个数据的大小，然后输出

            if (this.num1 > this.num2) {

                this.pageContext.getOut().print(num1 + "大于" + num2);

            } else if (this.num1 < this.num2){

                this.pageContext.getOut().print(num1 + "小于" + num2);

            }

            else{

                this.pageContext.getOut().print(num1 + "等于" + num2);

            }

        }

        @Override

        public JspTag getParent() {

            // TODO Auto-generated method stub

            return null;

        }

        @Override

        public void setJspBody(JspFragment arg0) {

            // TODO Auto-generated method stub

        }

        @Override

        public void setParent(JspTag arg0) {

            // TODO Auto-generated method stub

        }

    }

    <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.0</tlib-version>

    <!-- 建议引入当前便签库是，使用的简写 @taglib prefix="my" -->

    <short-name>my</short-name>

    <!-- 为当前标签库配置文件，起一个名称 * 内容：自定义，全球唯一 -->

    <uri>http://www.yxl.cn/jsp/mytag</uri>

    <!-- <my:date / > 注册标签 -->

    <tag>

        <!-- 确定标签名称 -->

        <name>date</name>

        <!-- 确定实现类 -->

        <tag-class>com.yxl.tag.MyDateTag</tag-class>

        <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 -->

        <body-content>empty</body-content>

    </tag>

    <!-- <my:maxValue / > 注册标签 -->

    <tag>

        <!-- 确定标签名称 -->

        <name>maxValue</name>

        <!-- 确定实现类 -->

        <tag-class>com.yxl.tag.MyMaxValueTag</tag-class>

        <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 -->

        <body-content>empty</body-content>

        <!-- 确定当前标签使用了哪些属性 -->

        <attribute>

            <!-- 设置属性名称 -->

            <name>num1</name>

            <!-- 设置属性是否必须 * true/false * yes/no -->

            <required>true</required>

            <!-- rtexprvalue 运行时表达式的值 * runtime expression value -->

            <rtexprvalue>true</rtexprvalue>

            <!-- 确定标签类型 -->

            <type>java.lang.Integer</type>

        </attribute>

        <attribute>

            <!-- 设置属性名称 -->

            <name>num2</name>

            <!-- 设置属性是否必须 * true/false * yes/no -->

            <required>true</required>

            <!-- rtexprvalue 运行时表达式的值 * runtime expression value -->

            <rtexprvalue>true</rtexprvalue>

        </attribute>

    </tag>

    </taglib>

    * 需求：<my:toUpperCase>xxYYdfsdDFwerd</my:toUpperCase>

    标签体

    package com.yxl.tag;

    import java.io.IOException;

    import java.io.StringWriter;

    import java.text.SimpleDateFormat;

    import java.util.Date;

    import javax.servlet.jsp.JspContext;

    import javax.servlet.jsp.JspException;

    import javax.servlet.jsp.PageContext;

    import javax.servlet.jsp.tagext.JspFragment;

    import javax.servlet.jsp.tagext.JspTag;

    import javax.servlet.jsp.tagext.SimpleTag;

    public class MyToUpperCaseTag implements SimpleTag {

        public MyToUpperCaseTag() {

            System.out.println("默认构造");

        }

        private PageContext pageContext;

        private JspFragment jspBody;

        /**

         * 1、被调用的方法，tomcat调用

         */

        public void setJspContext(JspContext pc) {

            this.pageContext = (PageContext) pc;

        }

         public void setJspBody(JspFragment jspBody){

                this.jspBody = jspBody;

         }

        /**

         * 2、tomcat调用 建议，在doTage方法中完成整个tag的功能 需要再doTage方法之前，完成准备工作

         */

        public void doTag() throws JspException, IOException {

            StringWriter stringWriter = new StringWriter();

            this.jspBody.invoke(stringWriter);

            String data = stringWriter.toString();

            this.pageContext.getOut().print(data.toUpperCase());

        }

        @Override

        public JspTag getParent() {

            // TODO Auto-generated method stub

            return null;

        }

        @Override

        public void setParent(JspTag arg0) {

            // TODO Auto-generated method stub

        }

    }

    <!-- <my:toUpperCase / > 转换为大写 -->

    <tag>

        <!-- 确定标签名称 -->

        <name>toUpperCase</name>

        <!-- 确定实现类 -->

        <tag-class>com.yxl.tag.MyToUpperCaseTag</tag-class>

        <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 -->

        <!-- JSP：支持JSP所有的语法，在Tag中使用

        scriptless：对于JSP页面的脚本不支持

        tagdependent：标签体不做处理，原样输出 -->

        <body-content>scriptless</body-content>

    </tag>

    <my:toUpperCase>abcd</my:toUpperCase>

    * 需求：循环

    使用extends SimpleTagSupport这种方式实现标签类，SimpleTagSupport已经实现了SimpleTag接口

    三种循环遍历

    <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.0</tlib-version>

    <!-- 建议引入当前便签库是，使用的简写 @taglib prefix="my" -->

    <short-name>my</short-name>

    <!-- 为当前标签库配置文件，起一个名称 * 内容：自定义，全球唯一 -->

    <uri>http://www.yxl.cn/jsp/mytag</uri>

     <!--

    <my:myeach start="0" end="9" step="1" var="ss">

        ${ss} ** <br/>

    </my:myeach>

     -->

     <tag>

         <name>myeach</name>

         <tag-class>com.yxl.tag.MyEachTag</tag-class>

         <body-content>scriptless</body-content>

         <attribute>

             <name>start</name>

             <required>true</required>

             <rtexprvalue>true</rtexprvalue>

         </attribute>

         <attribute>

             <name>end</name>

             <required>true</required>

             <rtexprvalue>true</rtexprvalue>

         </attribute>

         <attribute>

             <name>step</name>

             <required>true</required>

             <rtexprvalue>true</rtexprvalue>

         </attribute>

         <attribute>

             <name>var</name>

             <required>true</required>

             <rtexprvalue>true</rtexprvalue>

         </attribute>

     </tag>

     <!--

     <my:myList items="${listObj}" var="yyyyy">

        ${yyyyy}  ## <br/>

    </my:myList>

      -->

      <tag>

          <name>myList</name>

          <tag-class>com.yxl.tag.MyListTag</tag-class>

          <body-content>scriptless</body-content>

          <attribute>

              <name>items</name>

              <required>true</required>

              <rtexprvalue>true</rtexprvalue>

          </attribute>

          <attribute>

              <name>var</name>

              <required>true</required>

              <rtexprvalue>true</rtexprvalue>

          </attribute>

      </tag>

       <tag>

          <name>forEach</name>

          <tag-class>com.yxl.tag.ForEachTag</tag-class>

          <body-content>scriptless</body-content>

          <attribute>

              <name>items</name>

              <required>true</required>

              <rtexprvalue>true</rtexprvalue>

          </attribute>

          <attribute>

              <name>var</name>

              <required>true</required>

              <rtexprvalue>true</rtexprvalue>

          </attribute>

      </tag>

    </taglib>

    package com.yxl.tag;

    import java.io.IOException;

    import javax.servlet.jsp.JspException;

    import javax.servlet.jsp.tagext.SimpleTagSupport;

    public class MyEachTag extends SimpleTagSupport{

        /*

         * <my:myeach start="0" end="9" step="1" var="ss">

            ${ss} ** <br/>

        </my:myeach>

         */

        private Integer start;

        private Integer end;

        private Integer step;

        private String var;

        public void setStart(Integer start) {

            this.start = start;

        }

        public void setEnd(Integer end) {

            this.end = end;

        }

        public void setStep(Integer step) {

            this.step = step;

        }

        public void setVar(String var) {

            this.var = var;

        }

        public void doTag() throws JspException, IOException {

            //完成功能：将获得的变量信息，输出到浏览器

            for(int i = start ; i <= end ; i +=step){

                //从父类中，获得pagecontext对象

                this.getJspContext().setAttribute(var, i);

                //将el表达式的结果发送到浏览器

                // * el表达式的位置

                // * 如何发送

                this.getJspBody().invoke(null);

                //this.getJspBody().invoke(this.getJspContext().getOut());

            }

        }

    }

    package com.yxl.tag;

    import java.io.IOException;

    import java.util.Iterator;

    import java.util.List;

    import javax.servlet.jsp.JspException;

    import javax.servlet.jsp.tagext.SimpleTagSupport;

    public class MyListTag extends SimpleTagSupport {

        /*

        <my:myList items="${listObj}" var="yyyyy">

            ${yyyyy}  ## <br/>

        </my:myList>

         */

        private List items;

        private String var;

        public void setItems(List items) {

            this.items = items;

        }

        public void setVar(String var) {

            this.var = var;

        }

        @Override

        public void doTag() throws JspException, IOException {

            //完成功能：将获得的list信息遍历输出到浏览器

            Iterator it = items.iterator();

            while(it.hasNext()){

                Object str = it.next();

                //将结果放置到作用域

                this.getJspContext().setAttribute(var, str);

                //将el表达式的结果数据到浏览器

                this.getJspBody().invoke(null);

            }

        }

    }

    package com.yxl.tag;

    import java.io.IOException;

    import java.util.Arrays;

    import java.util.Iterator;

    import java.util.List;

    import java.util.Map;

    import javax.servlet.jsp.JspException;

    import javax.servlet.jsp.tagext.SimpleTagSupport;

    public class ForEachTag extends SimpleTagSupport {

        /*

        <my:myList items="${listObj}" var="yyyyy">

            ${yyyyy}  ## <br/>

        </my:myList>

         */

        private Iterator<Object> items;

        private String var;

        public void setItems(Object items) {

            //list

            if(items instanceof List){

                this.items = ((List)items).iterator();

            }

            //map

            if(items instanceof Map){

                this.items = ((Map)items).entrySet().iterator();

            }

            //object[]

            if(items instanceof Object[]){

                this.items = Arrays.asList((Object[])items).iterator();

            }

        }

        public void setVar(String var) {

            this.var = var;

        }

        @Override

        public void doTag() throws JspException, IOException {

            //完成功能：将获得的list信息遍历输出到浏览器

            while(items.hasNext()){

                Object str = items.next();

                //将结果放置到作用域

                this.getJspContext().setAttribute(var, str);

                //将el表达式的结果数据到浏览器

                this.getJspBody().invoke(null);

            }

        }

    }

    <my:myeach start="0" end="9" step="1" var="eeee">

        ${eeee} ** <br/>

    </my:myeach>

    <%

        List<String> list = new ArrayList<String>();

        list.add("abc");

        list.add("123");

        list.add("wasd");

        pageContext.setAttribute("listObj",list);

    %>

    myList<br/>

    <my:myList items="${listObj}" var="yyyyy">

        ${yyyyy}  ## <br/>

    </my:myList>

    <my:forEach items="${listObj}" var="mm">

        ${mm} <br/>

    </my:forEach>

    <hr/>

    <%

        Map<String,String> map = new HashMap<String,String>();

        map.put("11111","11111");

        map.put("22222","222222");

        map.put("33333","33333");

        pageContext.setAttribute("mapObj",map);

    %>

    遍历Map<br/>

    <my:forEach items="${mapObj}" var="map">

        ${map.key} ---- ${map.value} <br/>

    </my:forEach>

三、自定义函数

    * 创建类，但方法必须是静态的

    package com.yxl.domain;

    public class Calculator {

        private String firstNum;

        private String operator;

        private String secondNum;

        private String result;

        public String getFirstNum() {

            return firstNum;

        }

        public void setFirstNum(String firstNum) {

            this.firstNum = firstNum;

        }

        public String getOperator() {

            return operator;

        }

        public void setOperator(String operator) {

            this.operator = operator;

        }

        public String getSecondNum() {

            return secondNum;

        }

        public void setSecondNum(String secondNum) {

            this.secondNum = secondNum;

        }

        public String getResult() {

            return result;

        }

        public void setResult(String result) {

            this.result = result;

        }

        public Calculator() {

        }

        //计算方法

        public static void calculator(Calculator cal){

            //通过运算符，将firstNum和secondNum处理的结果，存放到result

            double first = Double.valueOf(cal.firstNum);

            double second = Double.valueOf(cal.secondNum);

            char ope = cal.operator.charAt(0);

            switch (ope) {

                case '+':

                    cal.result = String.valueOf(first + second);

                    break;

                case '-':

                    cal.result = String.valueOf(first - second);

                    break;

                case '*':

                    cal.result = String.valueOf(first * second);

                    break;

                case '/':

                    cal.result = String.valueOf(first / second);

                    break;

                default:

                    throw new RuntimeException("非法操作符");

            }

        }

    }

    * 书写配置文件tld

        新建myFun.tld

        <?xml version="1.0" encoding="UTF-8" ?>

        <taglib 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"

            version="2.0">

            <tlib-version>1.0</tlib-version>

            <short-name>myfn</short-name>

            <uri>http://www.yxl.cn/mytag/functions</uri>

            <!-- 确定当前函数 myfn:calculator(cal) -->

            <function>

                <name>calculator</name>

                <function-class>com.yxl.domain.Calculator</function-class>

                <!-- 当前使用函数的声明 public static void calculator(Calculator cal) -->

                <function-signature>void calculator(com.yxl.domain.Calculator)</function-signature>

            </function>

        </taglib>

    * 引用

        * <%@ taglib uri="http://www.yxl.cn/mytag/functions" prefix="myFn" %>

    * 测试

        <jsp:useBean id="cal" class="com.yxl.domain.Calculator"></jsp:useBean>

        <jsp:setProperty property="firstNum" value="1" name="cal"/>

        <jsp:setProperty property="operator" value="+" name="cal"/>

        <jsp:setProperty property="secondNum" value="4" name="cal"/>

        ${myFn:calculator(cal)}

        ${cal.result}

四、总结

    * 共同点：

        * 需要引入

            * <%@ taglib uri="http://www.yxl.cn/mytag/myeach" prefix="my" %>

        * 都需要配置tld文件

    * 区别：

        * 自定义标签

            * 创建一个类，完成一个功能或一组功能。

            * 可以选择el表达式

        * 自定义函数

            * 创建一个静态方法，完成一个操作。

            * 必须与EL表达式结合使用

                ${fn:xxxx}