本篇文章介绍自定义标签，可能在工作中很少涉及到自己来定义一个标签库，因为我们基本上都是使用的大神写的标签库，基本上直接使用即可，但是从自身的发展来看，通往高级程序员的道路上，开发框架就需要大量的使用到标签库技术。本文将从以下几个方面介绍自定义标签库的基本知识点：

  • 背景以及作用
  • 开发简单的标签
  • 开发带属性的标签
  • 开发带标签体的标签
  • 以页面片段为属性的标签
  • 具有动态属性的标签

一、标签库有什么作用

     自定义标签库是一种优秀的表现层技术，之前介绍的MVC模式，我们使用jsp作为表现层，但是jsp语法嵌套在html页面，美工还是很难直接参与开发，并且jsp脚本和html代码耦合在一起，维护成本较高。我们能不能开发一套和html风格类似并且能完成jsp脚本功能的标签来解决这种低效的协作方式呢？于是标签库就诞生了。

这是Java中标签规范的继承体系，实现Tag接口的我们叫做传统式标签库开发，这种开发模式略显发复杂，基本已经被SimpleTag式的简单式开发标签库给取代了。Java中提供了一个默认的实现类SimpleTagSupport来实现自定义标签，我们只要继承此类即可。

二、开发一个最简单的标签库

     开发一个自定义标签库的过程如下：

  • 开发自定义标签处理类
  • 创建*.tld文件，每个此文件对应一个标签库，标签库中可以由多个标签
  • 在jsp页面使用标签

首先我们先从自定义标签处理类开始，正如上文所说，这个类只有继承了SimpleTagSupport这个类可以省去省去重写SimpleTag接口中的一些方法。我们说个doTag()这个方法很重要，这个方法类似于我么main方法一样，当jsp页面加载到我们定义的标签的时候就会过来调用这个方法。

  1. public class MyTag extends SimpleTagSupport {
  3.     @Override
  4.     public void doTag() throws JspException, IOException {
  5.         getJspContext().getOut().write("hello walker");
  6.     }
  7. }

这是一个简单的标签处理类，具体的细节暂时不用关心，只需要知道，它负责向jsp页面输出字符串即可。下面我们看看第二步，创建*tld文件。这个文件我们没有必要重新写一遍，到Tomcat服务器上的webapps/examples/WEB-INF/jsp2中复制一个过来，修改名字存放到我们的项目中WEB-INF的任意子路径下。删除一些标签成如下内容：



我们看到这是一个XML文件，根元素为taglib，而taglib主要有以下几个子元素：

  • description //描述信息
  • tlib-version //指定标签库的版本号，基本不用我们操心
  • short-name //指定标签库的短名字，也是没什么用
  • uri //这是一个重要的子元素，是该标签库的唯一标识
  • tag //看名字就知道，这是定义标签的子元素，很重要

     对于taglib这个根元素，我们主要关心他下面的uri和tag两个子元素，一个标签库可以由多个标签，也就是可以有多个tag标签。关于tag标签，主要有以下几个子元素：

  • description //描述信息
  • name //该标签的唯一标识，很重要
  • tag-class //指定了处理该标签的类，也就是使用该标签谁给我返回结果
  • body-content //标签体，后面详说，很重要
  • attribute //属性，后面介绍，很重要

对于以上标签大家可能已经知道什么意思，但是具体用在什么地方可能不清楚，本小节的最后会综合三个步骤自定义一个简单的标签。接下来介绍在jsp页面是如何使用标签。

     使用标签库也是有两个步骤，首先导入标签库，然后引用标签。我们使用taglib编译指令导入标签库，具体格式如下：

  1. <%@ taglib uri="tld文件中指定的唯一标识" prefix="指定标签前缀"%>

我们看到这个导入标签库的编译指令主要有两个属性，一个是用于定位我们已经写好的标签库，定位的方法就是读取每个tld文件中的URI元素的值，prefix用于指定我们使用标签时的前缀，等用的时候就很容易理解了，现在解释反而不容易说清楚。我们使用标签的格式如下：

  1. <刚刚指定的前缀 :标签名 />

标签名就是我们标签库中每个tag都会有的name的值，这指定了该语句是引用的那个标签。下面我们通过具体的例子直观感受下。

  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <%@taglib uri="mytid" prefix="mytags"%>
  3. <html>
  4.   <head>
  5.     <title></title>
  6.   </head>
  7.   <body>
  8.     <mytags:hello />
  9.   </body>
  10. </html>
  1. <taglib xmlns="http://java.sun.com/xml/ns/j2ee"
  2.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
  4.     version="2.0">
  5.     <description>A tag library exercising SimpleTag handlers.</description>
  6.     <tlib-version>1.0</tlib-version>
  7.     <short-name>SimpleTagLibrary</short-name>
  8.     <uri>mytid</uri>
  10.     <tag>
  11.         <description>Outputs a colored tile</description>
  12.         <name>hello</name>
  13.         <tag-class>Test.MyTag</tag-class>
  14.         <body-content>empty</body-content>
  15.     </tag>
  17. </taglib>
  1. public class MyTag extends SimpleTagSupport {
  3.     @Override
  4.     public void doTag() throws JspException, IOException {
  5.         getJspContext().getOut().write("hello walker");
  6.     }
  7. }

结果如下：

     这就完成了一个最简单的标签库的定义和使用的过程，首先我们在index.jsp页面通过URI引入mytag标签库，指定了使用该标签库的前缀为mytags，然后<mytags:hello />引用name为hello的tag标签，然而在加载这条语句的时候会通过我们的tag中指定的处理类，找到它并执行，最后通过此标签处理类想我们的jsp页面输出了一个字符串。以上就是一个最简单的自定义标签的过程，为了更好的理解后续的较复杂的自定义标签方式，上述内容值得感受体会。

三、开发带属性的标签

     假如我们通过拦截器获取了从数据库查出来的一个结果集，我们此处希望调用标签来将结果集以表格的形式输出来，此时我们的这个结果集又该如何传到标签处理类中呢？这时我们可以使用属性。具体看代码：

  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <%@taglib uri="mytid" prefix="mytag"%>
  3. <html>
  4.   <head>
  5.     <title></title>
  6.   </head>
  7.   <body>
  8.   <%
  9.     HashMap<String,Integer> maps = new HashMap<String, Integer>();
  10.     maps.put("李四",53);
  11.     maps.put("张三",23);
  12.     maps.put("walker",22);
  13.     pageContext.setAttribute("map",maps);
  14.   %>
  15.       <table>
  16.         <mytag:hello map="map"/>
  17.       </table>
  18.   </body>
  19. </html>
  1. <taglib xmlns="http://java.sun.com/xml/ns/j2ee"
  2.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
  4.     version="2.0">
  5.     <description>A tag library exercising SimpleTag handlers.</description>
  6.     <tlib-version>1.0</tlib-version>
  7.     <short-name>SimpleTagLibrary</short-name>
  8.     <uri>mytid</uri>
  10.     <tag>
  11.         <description>Outputs a colored tile</description>
  12.         <name>hello</name>
  13.         <tag-class>Test.MyTag</tag-class>
  14.         <body-content>empty</body-content>
  15.         <attribute>
  16.             <name>map</name>
  17.             <required>true</required>
  18.             <fragment>true</fragment>
  19.         </attribute>
  20.     </tag>
  22. </taglib>
  1. public class MyTag extends SimpleTagSupport {
  3.     private String map;
  4.     public String getMap(){
  5.         return this.map;
  6.     }
  7.     public void setMap(String map){
  8.         this.map = map;
  9.     }
  10.     @Override
  11.     public void doTag() throws JspException, IOException {
  12.         HashMap<String,Integer> maps = (HashMap<String,Integer>)(getJspContext().getAttribute(map));
  13.         Object[] array = maps.keySet().toArray();
  15.         for (String str : maps.keySet()){
  16.             getJspContext().getOut().write("<tr>");
  17.             getJspContext().getOut().write("<td>");
  18.             getJspContext().getOut().write(str);
  19.             getJspContext().getOut().write("</td>");
  20.             getJspContext().getOut().write("<td>");
  21.             getJspContext().getOut().write(""+maps.get(str));
  22.             getJspContext().getOut().write("</td>");
  23.             getJspContext().getOut().write("</tr>");
  24.         }
  25.     }
  26. }

我们首先先从index.jsp页面看起，首先我们定义了一个HashMap用来存放一个简单的个人信息，键为姓名值为年龄。最后我们设置共享范围为当前page。然后<mytag:hello map="map"/>，这里的map=“map”，第一个map是属性名，第二个只是一个字符串。下面进入到tld页面看，这个页面基本没有什么改动，只是多了个attribute元素，attribute中有几个子元素，第一个是name指定这个属性的唯一标识，第二个required指定该属性是否是必须属性。第三个fragment指定该属性是否支持jsp脚本。主要关心name这个元素。这个值和jsp页面调用标签时使用的属性名必须一样，并且这个属性值还必须和标签处理类中的私有属性名一样，这就是为了jsp页面的属性值能够自动的传入到标签处理类的属性中，我们看这个标签处理类

     这个类定义了私有属性map，和我们的tld文件中的属性名是一致的。getJspContext().getAttribute(map），首先是获得了调用该标签的jsp页面的pageContext，这就是方法getJspContext的返回值，因为我们在jsp页面设置了一个共享数据（maps），于是我们同名名字获取该对象，这里的map就是我们的私有属性，他的值被自动赋值了，具体的值就是jsp页面传入的参数。后面的代码就很简单了，循环输出数据到jsp页面上。

     稍微理一下思路，这种带属性的标签使用其实和无属性差不多，都是先引入了标签库，加载标签的的时候通过URI找到对应的标签库，只不过这次将一个字符串赋值给了tld中attribute元素中名为map的属性，然后跳向对应的标签处理类，顺便把map属性的值自动赋值处理类中的私有属性，然后执行输出代码。其中需要注意的是属性名一定要统一，另外，如果标签的属性值是8种基本数据类型，那么在JSP页面在传递字符串时，JSP引擎会自动转换成相应的类型，但如果标签的属性值是复合数据类型，那么JSP引擎是无法自动转换的。对于传递非基本数据类型的操作，后续文章会介绍。

     为了篇幅不过于长，还剩下的内容留在下篇，如有错误，望指出！

Java ---自定义标签的更多相关文章

  1. java自定义标签 权限

    <?xml version="1.0" encoding="UTF-8" ?> <taglib xmlns="http://java ...

  2. java 自定义标签 传值

    <?xml version="1.0" encoding="UTF-8" ?>   <taglib xmlns="http://ja ...

  3. Java ---自定义标签（二）

    上篇文章的最后,我们自定义了一个带属性的标签,并使用它完成了一个简单的案例.其实到这我们已经可以看出来,前端jsp页面只需要写一个类似html语法的标签,就可以完成将集合中的数据取出来并展示这么相对复 ...

  4. [转][Java]自定义标签简介

    作用:自定义标签主要用于移除 jsp 页面中的 java 代码. 实现:需要完成以下两个步骤: 编写一个实现 Tag 接口的 Java 类,把页面 java 代码移到这个 java 类中.(标签处理类 ...

  5. JSP2 自定义标签

    实现步骤 实现自定义标签的处理类继承javax.servlet.jsp.tagext.SimpleTagSupport,并重写doTag方法 建立标签库配置文件 在jsp中使用自定义标签 一个简单的标 ...

  6. [Java] JSP笔记 - 自定义标签

    自定义标签的创建步骤: 自定义标签的四大功能: 自定义标签的类结构: 在 1.0 中呢, 可以将 <body-content> 的值设置为 JSP, 2.0中则不允许在自定义标签体中出现j ...

  7. 12 自定义标签/JSTL标签库/web国际化/java web之设计模式和案例

    EL应用      自定义一个标签,实现两个字符串的相加 1回顾      1.1servlet生命周期           init(ServletConfig)           service ...

  8. Java自定义简单标签

     Java自定义简单标签可以方便的在页面输出信息,并且对于权限的控制,和对于Jsp标签和servlet代码的分离有着很好的作用. 下面将以权限的控制为例自定义一个标签: 一.标签类型 <wxt: ...

  9. Java Spring Boot VS .NetCore （十一）自定义标签 Java Tag Freemarker VS .NetCore Tag TagHelper

    Java Spring Boot VS .NetCore (一)来一个简单的 Hello World Java Spring Boot VS .NetCore (二)实现一个过滤器Filter Jav ...

随机推荐

  1. 学习JVM--垃圾回收（二）GC收集器

    1. 前言 在上一篇文章中,介绍了JVM中垃圾回收的原理和算法.介绍了通过引用计数和对象可达性分析的算法来筛选出已经没有使用的对象,然后介绍了垃圾收集器中使用的三种收集算法:标记-清除.标记-整理.标 ...

  2. HTTP基础知识（二）

    接着上一章的内容:HTTP基础知识(一)   二.简单的HTTP协议 1.客户端:请求访问文本或图像等资源的一端称为客户端: 服务器端:提供资源响应的一端   2.以百度为例子 这是请求头: 在起始行 ...

  3. Android通过Apk插件调起微信支付

    App对接微信调起微信支付需要在微信平台注册,鉴别的标识就是App的包名,所以将申请的包名单独打包成一个Apk文件,则在其他的App调起此Apk的时候同样可以起到调用微信支付的功能.这样就实现了调起微 ...

  4. Linux的capability深入分析

    Linux的capability深入分析详见:http://blog.csdn.net/u014338577/article/details/48791953 lxd中对容器能力的限制: 普通用户不能 ...

  5. TypeScript设计模式之单例、建造者、原型

    看看用TypeScript怎样实现常见的设计模式,顺便复习一下. 单例模式 Singleton 特点:在程序的生命周期内只有一个全局的实例,并且不能再new出新的实例. 用处:在一些只需要一个对象存在 ...

  6. Java设计模式之《观察者模式》及应用场景

    原创作品,可以转载,但是请标注出处地址:http://www.cnblogs.com/V1haoge/p/6513651.html 观察者模式,又可以称之为发布-订阅模式,观察者,顾名思义,就是一个监 ...

  7. Servlet+Tomcat日志输出

    刚接触Servlet的时候,为了学习方便总是想验证自己的想法,那么输出日志是最常见的手法了,就自己亲身经历总结了如下几种方法,我用的是Web容器是Tomcat. 使用Log4J 在<Servle ...

  8. Unity Shader 知识点总结（二）

    紧接着上一篇文章的shader入门知识的总结,本文主要总结shader中的纹理贴图.透明度混合.顶点动画.后期特效处理等操作.如果有什么地方有错,请指出更正,谢谢.本文的代码主要来自开源书:unity ...

  9. SQL_Join 小总结

    原文出自 :http://www.nowamagic.net/librarys/veda/detail/936 对于SQL的Join,在学习起来可能是比较乱的.我们知道,SQL的Join语法有很多in ...

  10. Weexpack 使用教程

    简介 weexpack 是 weex 新一代的工程开发套件,是基于weex快速搭建应用原型的利器.它能够帮助开发者通过命令行创建weex工程,添加相应平台的weex app模版,并基于模版从本地.Gi ...