今天闲来无事，于是想起自己之前一直使用的标签，无论是jstl，struts标签还是springmvc标签，使用起来都觉得很方便，于是自己想尝试定义自己的标签。
下面把今天自己的成果给大家分享下。要自定义标签并使用标签，需要以下几步：
1、定义自己的标签解析类，一般都是继承TagSupport类（servlet-api.jar），Override该类的doStartTag()或者doEndTag()方法；
2、定义.tld文件；
3、在web.xml中声明要使用的标签(也可以不声明)；
4、在jsp中使用自定义的标签。
下面通过一个例子来给大家详细的讲解：
1、定义自己的第一个标签解析类：
package com.jrj.tag.example;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
@SuppressWarnings("serial")
public class FirstTag extends TagSupport{
@Override
public int doEndTag() throws JspException {
try {
pageContext.getOut().write("hello world");
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return EVAL_PAGE;
}
}
2、在web-inf下新建一个tagFile文件夹，然后在文件中新建一个example.tld，内容如下：
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>em</short-name>
<uri>http://com.jrj.tag/em</uri>
<display-name>Example</display-name>
<description>em 1.0 library</description>
<tag>
<name>out</name>
<tag-class>com.jrj.tag.example.FirstTag</tag-class>
<body-content>JSP</body-content>
<description>writer out the cotentes</description>
</tag>
</taglib>
3、如果你想在web.xml文件中添加标签的声明，在web.xml中添加如下一段代码：
<jsp-config>
<taglib>
<taglib-uri>/em</taglib-uri>
<taglib-location>/WEB-INF/tagFile/example.tld</taglib-location>
</taglib>
</jsp-config>
note:在今天讲解的这些事例中，我没有在web.xml中添加以上代码，如果添加了那么在后面jsp的引用标签时会有所不同，希望大家注意！
4、在jsp中使用标签，在使用之前需要先引用标签：
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib uri="http://com.jrj.tag/em" prefix="em" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
</head>
<body>
<em:out></em:out>
</body>
</html>
下面我给大家扩展两个其他的例子，一个是关于条件表达式，一个是关于迭代以及标签的嵌套：
1、关于条件表达式，按照上面给大家讲解的步骤：
1)、
package com.jrj.tag.example;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
@SuppressWarnings("serial")
public class IfTag extends TagSupport{
private boolean condition;
@Override
public int doStartTag() throws JspException {
return condition?EVAL_BODY_INCLUDE:SKIP_BODY;
}
public boolean isCondition() {
return condition;
}
public void setCondition(boolean condition) {
this.condition = condition;
}
}
2)、在example.tld中添加如下内容：
<tag>
<name>if</name>
<tag-class>com.jrj.tag.example.IfTag</tag-class>
<body-content>JSP</body-content>
<description>If Condition</description>
<attribute>
<name>condition</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<type>boolean</type>
<description>condition</description>
</attribute>
</tag>
3)、jsp中使用，jsp修改完后变成如下：
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib uri="http://com.jrj.tag/em" prefix="em" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
</head>
<body>
<em:out></em:out>
<em:if condition="${1==1}">
if is validate
</em:if>
</body>
</html>
2、关于迭代及标签的嵌套
1）、标签解析类
package com.jrj.tag.example;
import java.util.Collection;
import java.util.Iterator;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
@SuppressWarnings("serial")
public class ForEachTag extends BodyTagSupport {
@SuppressWarnings("rawtypes")
private Collection items;
private String var;
@SuppressWarnings("rawtypes")
private Iterator it;
@Override
public int doStartTag() throws JspException {
if(items==null||items.size()==0)
return SKIP_BODY;
it = items.iterator();
if(it.hasNext()){
pageContext.setAttribute(var, it.next());
}
return EVAL_BODY_INCLUDE;
}
@Override
public int doAfterBody() throws JspException {
if(it.hasNext()){
pageContext.setAttribute(var, it.next());
return EVAL_BODY_AGAIN;
}
return SKIP_BODY;
}
@Override
public int doEndTag() throws JspException {
return EVAL_PAGE;
}
@SuppressWarnings("rawtypes")
public Collection getItems() {
return items;
}
@SuppressWarnings("rawtypes")
public void setItems(Collection items) {
this.items = items;
}
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
}
2)、在example.tld中添加如下内容：
<tag>
<name>foreach</name>
<tag-class>com.jrj.tag.example.ForEachTag</tag-class>
<body-content>JSP</body-content>
<description>ForEach The Collection</description>
<attribute>
<name>var</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>items</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
3)、jsp中使用，jsp内容如下：
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib uri="http://com.jrj.tag/em" prefix="em" %>
<%@ page import="java.util.*" %>
<%
String path = request.getContextPath();
ArrayList<String> values = new ArrayList<String>();
values.add("zhouming");
values.add("xiaoshou");
values.add("minggou");
pageContext.setAttribute("values", values);
%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
</head>
<body>
<em:out></em:out>
<em:if condition="${1==1}">
if is validate
</em:if>
<em:foreach items="${pageScope.values}" var="val">
<em:out></em:out>
${val}
</em:foreach>
</body>
</html>
下面大家可能会对两个方面有疑问：一是java类中每个方法的返回值的含义，二是tld文件中一些元素代表的意思。
1、在我们创建自定义的标签时，在复写父类的方法是，需要注意返回值的含义，不同的返回值代表不同的处理，下面是不同返回值所代表的含义：
EVAL_BODY_INCLUDE：把Body读入存在的输出流中，doStartTag()函数可用
EVAL_PAGE：继续处理页面，doEndTag()函数可用
SKIP_BODY：忽略对Body的处理，doStartTag()和doAfterBody()函数可用
SKIP_PAGE：忽略对余下页面的处理，doEndTag()函数可用
EVAL_BODY_TAG：已经废止，由EVAL_BODY_BUFFERED取代
EVAL_BODY_BUFFERED：申请缓冲区，
由setBodyContent()函数得到的BodyContent对象来处理tag的body，
如果类实现了BodyTag，那么doStartTag()可用，否则非法
2、如果我们需要对body里面的内容进行循环处理，我们自定义的标签解析类需要实现BodyTag接口或者继承BodyTagSupport类
3、在我们自定义的tld文件中，需要注意attribute元素下的rtexprvalue(Run-time Expression value)元素的值，如果该值为true，表示该属性的值可以通过直接指定或者
通过表达式来指定，如果该值为false，则表示该属性的值必须直接指定。
以上就是自定义标签的基本步骤，我今天在做的过程中借鉴了jstl的实现过程以及上网找了一些资料。我觉得这种方式效率很高，如果大家还有什么更加高效的方法，
可以分享出来，大家一起进步！我们下期再见！
分享到：
相关推荐
本文将详细讲解如何利用JSP自定义标签库实现数据列表的显示，以及涉及到的相关技术。 首先，`UserListTag.java` 是自定义标签的核心类，它继承了`javax.servlet.jsp.tagext.TagSupport` 或 `javax.servlet.jsp....
**JSP自定义标签库详解** 在JavaServer Pages (JSP) 技术中，自定义标签库（Custom Tag Libraries）是一种强大的特性，允许开发者创建可重用的、封装复杂功能的标签，使得JSP页面更加简洁易读。这篇内容将深入探讨...
【jsp自定义标签库注意事项】 在Java服务器页面（JSP）开发中，自定义标签库是一种强大的工具，它能够帮助开发者创建可重用的代码片段，提高代码的可读性和可维护性。以下是对JSP自定义标签库的详细解释和使用注意...
本教程将深入讲解JSP自定义标签库的学习，包括其原理、配置以及如何创建和使用自定义标签。 **一、JSP自定义标签库的概念** JSP自定义标签库是一组预定义的标签，它们扩展了HTML或XML，提供了一种更加结构化和面向...
### jsp自定义标签库知识点详解 #### 一、什么是jsp自定义标签？ 1. **概念**：JSP 自定义标签是一种将复杂的功能封装成一个简单的标签的方式，它允许开发者创建可重用的代码组件，这些组件可以在 JSP 页面中像...
本实例将深入探讨如何实现一个简单的JSP自定义标签。 首先，自定义标签的实现主要依赖于两个核心概念：Tag接口和TagSupport类。`Tag`接口定义了自定义标签必须实现的方法，如`doStartTag()`和`doEndTag()`，它们...
3. **在JSP页面中使用**：在JSP页面中，通过`<%@ taglib %>`指令引入自定义标签库，然后就可以像使用内置标签一样使用自定义标签了。 二、分页封装 分页是网页应用中常见的需求，通过自定义标签可以方便地实现。...
本篇学习笔记将深入探讨JSP自定义标签的相关概念、创建方法以及实际应用。 一、概述 1.1 使用简单标签机制 JSP自定义标签提供了类似HTML标签的语法结构，通过自定义标签，开发者可以封装复杂的Java代码，使得页面...
部署自定义标签库通常需要将TLD文件和对应的Java类打包成JAR文件，然后将JAR文件放入Tomcat的`WEB-INF/lib`目录下。之后，在JSP页面中通过`<%@ taglib %>`指令引入标签库，即可在页面中使用。 在提供的链接中，`...
通过以上步骤，开发者可以创建自己的JSP自定义标签库，实现特定的功能，提高代码复用性和可维护性。在实际开发中，自定义标签常常用于复杂的业务逻辑，如循环、条件判断、数据处理等，使得JSP页面更加清晰易读。
在提供的`GlobalTags`文件中，可能包含了整个自定义标签库的相关代码，包括TLD文件、标签处理类以及可能的辅助工具类。通过分析这些代码，我们可以更深入地理解自定义标签的工作原理以及如何在JSP项目中实现自动完成...
本教程将深入探讨JSP自定义标签的实例与详细讲解。 一、JSP自定义标签概述 JSP自定义标签是类似于HTML标签的自定义组件，但它们提供了更强大的功能，可以封装Java代码，提供复杂的业务逻辑。自定义标签通过TLD（Tag...
在使用JSP自定义标签时，开发者可能会遇到一些报错问题，这通常涉及到项目结构、类路径设置或自定义标签的编译与打包方式。在本文中，我们将深入探讨这些问题，以及如何解决“JspException”这个特定异常。 首先，...
2. **定义TLD（Tag Library Descriptor）文件**：TLD文件是JSP自定义标签库的元数据，它定义了标签的名称、属性、行为等。TLD通常放在WEB-INF目录下的tags子目录下，并以`.tld`为扩展名。在TLD文件中，你需要声明你...
在JSP页面中，通过`指令`引入自定义标签库，并使用`属性...</tag-name>`的格式调用自定义标签。 **二、自定义标签函数** 自定义标签函数是在JSP 2.0中引入的一种新的特性，它允许开发者像使用EL（Expression ...
本篇将深入探讨“JSP自定义标签之日期显示”，以及如何通过自定义标签来优雅地处理日期格式化和展示。 首先，我们要理解JSP自定义标签的基本概念。自定义标签是JSP的一种扩展，它不是Java内置的标签，而是由开发者...
本教程将深入探讨如何利用JSP自定义标签来编写一个灵活、可扩展的分页系统，该系统不依赖于特定的数据库，具有很高的通用性。 首先，理解JSP自定义标签的工作原理至关重要。自定义标签由三部分组成：标签库描述符...
本文将深入讲解JSP自定义标签的相关概念、格式、处理过程以及创建和使用自定义标签库的基本步骤。 1. 基本概念： - **标签**：JSP标签是XML元素，用于简化JSP页面，使其更易读且支持多语言版本。标签名和属性区分...