深入分析JavaWeb Item25 -- 自定义标签开发案例和打包自定义标签库_web中item

原创 于 2024-09-11 22:14:24 发布
· 438 阅读 · 7 ·
版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#前端 #python #大数据 

package me.gacl.web.simpletag;

import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* when标签和otherwise标签的父标签
 \*/
public class ChooseTag extends SimpleTagSupport {

    /\*\*
 \* 定义一个boolean类型的属性，该属性用于标识该标签下的某一个子标签是否已经执行过了，
 \* 如果该标签下的某一个子标签已经执行过了，就将该属性设置为true
 \*/
    private boolean isExecute;

    @Override
    public void doTag() throws JspException, IOException {
        //输出标签体中的内容
        this.getJspBody().invoke(null);
    }

    public boolean isExecute() {
        return isExecute;
    }

    public void setExecute(boolean isExecute) {
        this.isExecute = isExecute;
    }
}

2、开发when标签和otherwise标签

WhenTag.java

package me.gacl.web.simpletag;

import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* when标签
 \*/
public class WhenTag extends SimpleTagSupport {

    /\*\*
 \* test属性，该属性值为true时，输出标签体中的内容
 \*/
    private boolean test;

    @Override
    public void doTag() throws JspException, IOException {
        //获取标签的父标签
        ChooseTag parentTag = (ChooseTag) this.getParent();
        if (test == true && parentTag.isExecute() == false) {
            //输出标签体中的内容
            this.getJspBody().invoke(null);
            //将父标签的isExecute属性设置为true，告诉父标签，我(when标签)已经执行过了
            parentTag.setExecute(true);
        }
    }

    public void setTest(boolean test) {
        this.test = test;
    }
}

OtherWiseTag.java

package me.gacl.web.simpletag;

import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* otherwise标签
 \*/
public class OtherWiseTag extends SimpleTagSupport {

    @Override
    public void doTag() throws JspException, IOException {
        //获取标签的父标签
        ChooseTag parentTag = (ChooseTag) this.getParent();
        //如果父标签下的when标签没有执行过
        if (parentTag.isExecute() == false) {
            //输出标签体中的内容
            this.getJspBody().invoke(null);
            //设置父标签的isExecute属性为true，告诉父标签，我(otherwise标签)已经执行过了
            parentTag.setExecute(true);
        }
    }
}

3、在WEB-INF目录下tld文件中添加对ChooseTag、WhenTag、OtherWiseTag这三对标签的描述，如下：

<tag>
        <description>choose标签</description>
        <name>choose</name>
        <tag-class>me.gacl.web.simpletag.ChooseTag</tag-class>
        <body-content>scriptless</body-content>
    </tag>
    <tag>
        <description>when标签</description>
        <name>when</name>
        <tag-class>me.gacl.web.simpletag.WhenTag</tag-class>
        <body-content>scriptless</body-content>
        <attribute>
            <description>when标签的test属性</description>
            <name>test</name>
            <rtexprvalue>true</rtexprvalue>
            <required>true</required>
        </attribute>
    </tag>
    <tag>
        <description>otherwise标签</description>
        <name>otherwise</name>
        <tag-class>me.gacl.web.simpletag.OtherWiseTag</tag-class>
        <body-content>scriptless</body-content>
    </tag>

4、测试：在jsp页面中导入标签库并测试when和otherwise标签

<%@ page language="java" pageEncoding="UTF-8"%>
<%--在jsp页面中导入自定义标签库 --%>
<%@taglib uri="/gaclTagLib" prefix="c" %>
<%--在jsp页面中也可以使用这种方式导入标签库，直接把uri设置成标签库的tld文件所在目录
<%@taglib uri="/WEB-INF/TagLib.tld" prefix="c"%>
--%>
<!DOCTYPE HTML>
<html>
  <head>
    <title>when和otherwise标签测试</title>
  </head>

  <body>
      <c:choose>
          <c:when test="${user==null}">
          when标签标签体输出的内容：
              <h3>用户为空</h3>
          </c:when>
          <c:otherwise>
              用户不为空
          </c:otherwise>
      </c:choose>
          <hr/>
      <c:choose>
          <c:when test="${user!=null}">
              用户不为空
          </c:when>
          <c:otherwise>
          otherwise标签标签体输出的内容：
              <h3>用户为空</h3>
          </c:otherwise>
      </c:choose>
  </body>
</html>

运行效果如下：

这里写图片描述

1.4、开发foreach迭代标签

1、编写标签处理器类：ForEachTag.java

package me.gacl.web.simpletag;

import java.io.IOException;
import java.util.Iterator;
import java.util.List;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* ForEach迭代标签
 \*/
public class ForEachTag extends SimpleTagSupport {

    /\*\*
 \* 存储集合
 \*/
    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 {
        PageContext pageContext = (PageContext) this.getJspContext();
        Iterator it = items.iterator();
        while (it.hasNext()) {
            //得到一个迭代出来的对象
            Object object = (Object) it.next();
            //将迭代出来的对象存放到pageContext对象中
            pageContext.setAttribute(var, object);
            //输出标签体中的内容
            this.getJspBody().invoke(null);
        }
    }
}

2、在WEB-INF目录下tld文件中添加对该标签的描述，如下：

<tag>
        <description>foreach标签</description>
        <name>foreach</name>
        <tag-class>me.gacl.web.simpletag.ForEachTag</tag-class>
        <body-content>scriptless</body-content>
        <attribute>
            <description>foreach标签的items属性</description>
            <name>items</name>
            <rtexprvalue>true</rtexprvalue>
            <required>true</required>
        </attribute>
        <attribute>
            <description>foreach标签的var属性</description>
            <name>var</name>
            <rtexprvalue>false</rtexprvalue>
            <required>true</required>
        </attribute>
    </tag>

3、测试：在jsp页面中导入标签库并使用foreach标签

<%@page import="java.util.ArrayList"%>
<%@page import="java.util.List"%>
<%@ page language="java" pageEncoding="UTF-8"%>
<%--在jsp页面中导入自定义标签库 --%>
<%@taglib uri="/gaclTagLib" prefix="c" %>
<%--在jsp页面中也可以使用这种方式导入标签库，直接把uri设置成标签库的tld文件所在目录
<%@taglib uri="/WEB-INF/TagLib.tld" prefix="c"%>
--%>
<!DOCTYPE HTML>
<html>
  <head>
    <title>foreach标签测试</title>
  </head>

<%
 List<String> data = new ArrayList<String>();
 data.add("孤傲苍狼");
 data.add("xdp");
 //将集合存储到pageContext对象中
 pageContext.setAttribute("data", data);
%>

  <body>
          <%--迭代存储在pageContext对象中的data集合 --%>
         <c:foreach items="${data}" var="str">
             ${str}<br/>
         </c:foreach>
  </body>
</html>

运行效果如下：

这里写图片描述

目前这个foreach标签的功能较弱，只能遍历list集合，下面我们改造一下，使我们的foreach标签可以遍历所有集合类型，修改后foreach标签的代码如下：

package me.gacl.web.simpletag;

import java.io.IOException;
import java.lang.reflect.Array;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.Map;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* ForEach迭代标签
 \*/
public class ForEachTag extends SimpleTagSupport {

    /\*\*
 \* 存储数据
 \*/
    private Object items;

    /\*\*
 \* 迭代集合时使用的变量
 \*/
    private String var;

    /\*\*
 \* 集合，用于存储items中的数据
 \*/
    private Collection collection;

    @Override
    public void doTag() throws JspException, IOException {
        PageContext pageContext = (PageContext) this.getJspContext();
        //迭代collection集合
        Iterator it = collection.iterator();
        while (it.hasNext()) {
            //得到一个迭代出来的对象
            Object object = (Object) it.next();
            //将迭代出来的对象存放到pageContext对象中
            pageContext.setAttribute(var, object);
            //输出标签体中的内容
            this.getJspBody().invoke(null);
        }
    }

    public void setVar(String var) {
        this.var = var;
    }

    public void setItems(Object items) {
        if (items instanceof Collection) {
            collection = (Collection) items;//list
        }else if (items instanceof Map) {
            Map map = (Map) items;
            collection = map.entrySet();//map
        }else if (items.getClass().isArray()) {
            collection = new ArrayList();
            //获取数组的长度
            int len = Array.getLength(items);
            for (int i = 0; i < len; i++) {
                //获取数组元素
                Object object = Array.get(items, i);
                collection.add(object);
            }
        }
        this.items = items;
    }
}

测试功能增强后的foreach标签，如下：

<%@page import="java.util.HashMap"%>
<%@page import="java.util.Map"%>
<%@page import="java.util.HashSet"%>
<%@page import="java.util.Set"%>
<%@page import="java.util.ArrayList"%>
<%@page import="java.util.List"%>
<%@ page language="java" pageEncoding="UTF-8"%>
<%--在jsp页面中导入自定义标签库 --%>
<%@taglib uri="/gaclTagLib" prefix="c" %>
<%--在jsp页面中也可以使用这种方式导入标签库，直接把uri设置成标签库的tld文件所在目录
<%@taglib uri="/WEB-INF/TagLib.tld" prefix="c"%>
--%>
<!DOCTYPE HTML>
<html>
  <head>
    <title>foreach标签测试</title>
  </head>

<%
 //list集合
 List<String> listData = new ArrayList<String>();
 listData.add("孤傲苍狼");
 listData.add("xdp");

 //对象数组
 Integer intObjArr[] = new Integer[]{1,2,3};

 //基本数据类型数组
 int intArr[] = new int[]{4,5,6};

 //map集合
 Map<String,String> mapData = new HashMap<String,String>();
 mapData.put("a", "aaaaaa");
 mapData.put("b", "bbbbbb");

 //将集合存储到pageContext对象中
 pageContext.setAttribute("listData", listData);
 pageContext.setAttribute("intObjArr", intObjArr);
 pageContext.setAttribute("intArr", intArr);
 pageContext.setAttribute("mapData", mapData);
%>

  <body>
          <%--迭代存储在pageContext对象中的list集合 --%>
         <c:foreach items="${listData}" var="str">
             ${str}<br/>
         </c:foreach>
         <hr/>
         <%--迭代存储在pageContext对象中的数组 --%>
         <c:foreach items="${intObjArr}" var="num">
             ${num}<br/>
         </c:foreach>
         <hr/>
         <%--迭代存储在pageContext对象中的数组 --%>
         <c:foreach items="${intArr}" var="num">
             ${num}<br/>
         </c:foreach>
         <hr/>
             <%--迭代存储在pageContext对象中的map集合 --%>
         <c:foreach items="${mapData}" var="me">
             ${me}<br/>
         </c:foreach>
  </body>
</html>

测试结果：

这里写图片描述

1.5、开发html转义标签

1、编写标签处理器类：HtmlEscapeTag.java

package me.gacl.web.simpletag;

import java.io.IOException;
import java.io.StringWriter;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* html转义标签
 \*/
public class HtmlEscapeTag extends SimpleTagSupport {

    /\*\*
 \* @param message
 \* @return 转义html标签
 \*/
    private String filter(String message) {

        if (message == null){
            return (null);
        }
        char content[] = new char[message.length()];
        message.getChars(0, message.length(), content, 0);
        StringBuilder result = new StringBuilder(content.length + 50);
        for (int i = 0; i < content.length; i++) {
            switch (content[i]) {
            case '<':
                result.append("&lt;");
                break;
            case '>':
                result.append("&gt;");
                break;
            case '&':
                result.append("&amp;");
                break;
            case '"':
                result.append("&quot;");
                break;
            default:
                result.append(content[i]);
            }
        }
        return (result.toString());
    }

    @Override
    public void doTag() throws JspException, IOException {
        StringWriter sw = new StringWriter();
        //将标签体中的内容先输出到StringWriter流
        this.getJspBody().invoke(sw);
        //得到标签体中的内容
        String content = sw.getBuffer().toString();
        //转义标签体中的html代码
        content = filter(content);
        //输出转义后的content
        this.getJspContext().getOut().write(content);
    }
}

2、在WEB-INF目录下tld文件中添加对该标签的描述，如下：

 <tag>
     <description>HtmlEscape标签</description>
     <name>htmlEscape</name>
     <tag-class>me.gacl.web.simpletag.HtmlEscapeTag</tag-class>
     <body-content>scriptless</body-content>
 </tag>

3、测试：在jsp页面中导入标签库并使用htmlEscape标签

<%@ page language="java" pageEncoding="UTF-8"%>
<%--在jsp页面中导入自定义标签库 --%>
<%@taglib uri="/gaclTagLib" prefix="c" %>
<%--在jsp页面中也可以使用这种方式导入标签库，直接把uri设置成标签库的tld文件所在目录
<%@taglib uri="/WEB-INF/TagLib.tld" prefix="c"%>
--%>
<!DOCTYPE HTML>
<html>
  <head>
    <title>html转义标签测试</title>
  </head>

  <body>
          <c:htmlEscape>
              <a href="http://www.cnblogs.com">访问博客园</a>
          </c:htmlEscape>
  </body>
</html>

运行结果：

这里写图片描述

1.6、开发out输出标签

1、编写标签处理器类：OutTag.java

package me.gacl.web.simpletag;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/\*\*
 \* @author gacl
 \* 开发输出标签
 \*/
public class OutTag extends SimpleTagSupport {

    /\*\*
 \* 要输出的内容
 \*/
    private String content;

    /\*\*
 \* 是否将内容中的html进行转义后输出
 \*/
    private boolean escapeHtml;

    public void setContent(String content) {
        this.content = content;
    }

    public void setEscapeHtml(boolean escapeHtml) {
        this.escapeHtml = escapeHtml;
    }

    @Override
    public void doTag() throws JspException, IOException {
        if (escapeHtml == true) {
            //转义内容中的html代码
            content = filter(content);
            //输出转义后的content
            this.getJspContext().getOut().write(content);
        }else {
            this.getJspContext().getOut().write(content);
        }
    }

    /\*\*
 \* @param message
 \* @return 转义html标签
 \*/
    private String filter(String message) {

        if (message == null){
            return (null);
        }
        char content[] = new char[message.length()];
        message.getChars(0, message.length(), content, 0);
        StringBuilder result = new StringBuilder(content.length + 50);
        for (int i = 0; i < content.length; i++) {
            switch (content[i]) {
            case '<':
                result.append("&lt;");
                break;
            case '>':
                result.append("&gt;");
                break;
            case '&':
                result.append("&amp;");
                break;
            case '"':
                result.append("&quot;");
                break;
            default:
                result.append(content[i]);
            }
        }
        return (result.toString());
    }
}

2、在WEB-INF目录下tld文件中添加对该标签的描述，如下：

<tag>
        <description>out标签</description>
        <name>out</name>
        <tag-class>me.gacl.web.simpletag.OutTag</tag-class>
        <body-content>empty</body-content>
        <attribute>
            <description>out标签的content属性，表示要输出的内容</description>
            <name>content</name>
            <rtexprvalue>true</rtexprvalue>
            <required>true</required>
        </attribute>
        <attribute>
            <description>out标签的escapeHtml属性，表示是否将内容中的html进行转义后输出</description>
            <name>escapeHtml</name>
            <rtexprvalue>true</rtexprvalue>
            <required>false</required>
        </attribute>
    </tag>

3、测试：在jsp页面中导入标签库并使用out标签

<%@ page language="java" pageEncoding="UTF-8"%>
<%--在jsp页面中导入自定义标签库 --%>
<%@taglib uri="/gaclTagLib" prefix="c" %>
<%--在jsp页面中也可以使用这种方式导入标签库，直接把uri设置成标签库的tld文件所在目录
<%@taglib uri="/WEB-INF/TagLib.tld" prefix="c"%>
--%>
<!DOCTYPE HTML>
<html>
  <head>
    <title>out标签测试</title>
  </head>

  <body>
          <%--使用out标签输出content属性的内容 --%>
          <c:out content="<a href='http://www.cnblogs.com'>访问博客园</a>"/>
          <hr/>
          <%--使用out标签输出 content属性的内容，内容中的html代码会进行转义处理--%>
          <c:out content="<a href='http://www.cnblogs.com'>访问博客园</a>" escapeHtml="true"/>
  </body>
</html>

运行效果如下：

这里写图片描述

二、打包开发好的标签库

我们的标签库开发好之后，为了方便别人使用，可以将开发好的标签库打包成一个jar包，具体的打包步骤如下：

1、新建一个普通的java工程，例如：taglib

这里写图片描述

2、将在JavaWeb_JspTag_study_20140816这个web工程中开发好标签库的java代码拷贝到普通java工程taglib项目中，如下：

这里写图片描述这里写图片描述

此时，我们可以看到，拷贝到taglib项目的标签代码都有错误，这是因为taglib项目中缺少了javaEE的jar包，而标签类是是基于javaEE API进行开发的，所以还需要将javaEE的jar包添加到taglib项目中。

在taglib项目中创建一个【lib】文件夹，用于存放标签类依赖的javaEE的jar包。找到tomcat服务器目录下的lib文件夹，如下图所示：

参考信息
关注
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值