本文详细介绍了JSP自定义标签的开发和使用步骤，包括标签语言特点、自定义标签生命周期、开发助手类、创建TLD文件以及各种自定义数据标签的实例，旨在提高开发效率。
JSP定义标签
一.jsp标签语言特点
<开始标签 属性=“属性值”>标签体</结束标签>
例如：
<b:set var="name" value="zs"></b:set>
空标签：
<br/> <hr/>
开始标签和结束标签：
<body></body>
还有我们的 “c”指令标签
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
要使用“C”指令标签的话要到jar包：（如下图）
自定义jsp标签的意义： 便捷自己的开发，能够根据自己的需求来调整标签的功能，动态的实现一些功能，提高开发效率。
了解一下jsp标签的生命周期：
1.1. doStartTag（）方法的返回值：通常可以取两个值
1.2. EVAL_BODY_INCLUDE——包含标记体，本例中要编写自结束标记所以不使用该值；
1.3. SKIP_BODY——跳过标记体，即不处理标记体，开发自结束标记应该使用该值。
1.4. doEndTag（）方法的返回值：通常可以取两个值：
1.5. SKIP_PAGE——返回这个值，则终止页面执行；
1.6. EVAL_PAGE——返回该值则处理完当前标记后，JSP 页面中止运行。
二. 自定义标签的开发及使用步骤
（1）首先我们先写一个助手类，
思路： 我们先建一个class 名字比如（domTag）然后继承BodyTagSupport
然后我们在这个类里面写属性、这个类只写了一个属性test, 标签属性必须和助手类的属性对应，然后我们在这个类还有调用get/set方法。然后我们要调用3个方法：
doStartTag() 开始标签
doAfterBody() 主体部分
doEndTag() 结束标签；
package com.bowen.jsp;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class DemoTag extends BodyTagSupport {
//序列号的作用是方便对象序列化（序列化实际上就是将对象按照特定的规则持续化到硬盘）
private static final long serialVersionUID = 7418230126172807851L;
private String test;
public String getTest() {
return test;
}
public void setTest(String test) {
this.test = test;
}
@Override
public int doStartTag() throws JspException {
// TODO Auto-generated method stub
System.out.println("------------doStartTag-----------");
return super.doStartTag();
}
@Override
public int doAfterBody() throws JspException {
// TODO Auto-generated method stub
System.out.println("----------doAfterBody----------");
return super.doAfterBody();
}
@Override
public int doEndTag() throws JspException {
// TODO Auto-generated method stub
System.out.println("-----------doEndTag-------");
return super.doEndTag();
}
}
（2）创建标签库描述文件(tld)，添加自定义标签的配置
注意： tld文件必须保存到WEB-INF目录或其子目录
接下来我们来看看我写的z.tld文件(自己命名)：
这个z.tld文件里面有一个属性是助手类定义的:test属性。
<?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">
<description>bowen 1.1 core library</description>
<display-name>bowen core</display-name>
<tlib-version>1.1</tlib-version>
<short-name>c</short-name>
<uri>/bowen</uri>
<tag>
<!-- 填写的是标签中的标签名 -->
<name>demo</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.DemoTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>test</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
</tag>
</taglib>
（3）我们开始写jsp页面
思路： 首先我们要导包，导入我们自己写的标签库 ，然后我们可以在里面写 <z:demo>了。这个是有方法体的，我们先执行一下这个。如果有方法体他会调用 doAfterBody() 主体部分。
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="z" uri="/bowen" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>jsp1</title>
</head>
<body>
<z:demo test="xxx">标签类别</z:demo>
<select></select>
</body>
</html>
结果如下：
然后我们写一个没有标签体的
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="z" uri="/bowen" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>jsp1</title>
</head>
<body>
<z:demo test="xxx">标签类别</z:demo>
<select></select>
</body>
</html>
结果如下：
它不会调用doAfterBody() 主体部分
三.数据标签
（1）set 这个数据标签
（2）我们用一个setTag这个类来举例，当然这个类也称为助手类
1 创建一个标签助手类(继承BodyTagSupport)
标签属性必须助手类的属性对应、且要提供对应get/set方法
package com.bowen.jsp;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;public class SatTag extends BodyTagSupport { private static final long serialVersionUID = 1L; private String var;
private String value;
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
@Override
public int doStartTag() throws JspException {
//pageContext最小的域 当前页面传值
pageContext.setAttribute(var, value);
return SKIP_BODY;//没有标签体我们就返回一个SKIP_BODY。
}
然后我们在去写.tld文件，
大概大家对这个文件里面的一下标签也认识了吧，
上面一个文件，我有注释里面标签的意思
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
version="2.0"> <description>tan 1.1 core library</description>
<display-name>tan core</display-name>
<tlib-version>1.1</tlib-version>
<short-name>z</short-name>
<uri>/tan</uri>
<tag>
<name>set</name>
<tag-class>com.bowen.jsp.SatTag</tag-class>
<body-content>JSP</body-content>
<attribute>
<name>var</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
我们来写一下 t:select 这个案例
老规矩：我们先写一个助手类：
首先我们看一下它的助手类写的属性：
private String id;//值的传递
private String name;//值的传递
private List<Object> items=new ArrayList<Object>();//数据源(items)
private String textKey; //存入数据库中的值
private String textVal;//,展示列
private String headTextKey; //默认的头部属性值
private String headTextVal; //默认的展示列值
private String selectedVal;//加入属性，能够实现数据回显的功能selectedVal
在调用set/get方法：
private String id;//值的传递
private String name;//值的传递
private List<Object> items=new ArrayList<Object>();//数据源(items)
private String textKey; //存入数据库中的值
private String textVal;//,展示列
private String headTextKey; //默认的头部属性值
private String headTextVal; //默认的展示列值
private String selectedVal;//加入属性，能够实现数据回显的功能selectedVal
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public List<Object> getItems() {
return items;
}
public void setItems(List<Object> items) {
this.items = items;
}
public String getTextKey() {
return textKey;
}
public void setTextKey(String textKey) {
this.textKey = textKey;
}
public String getTextVal() {
return textVal;
}
public void setTextVal(String textVal) {
this.textVal = textVal;
}
public String getSelectedVal() {
return selectedVal;
}
public void setSelectedVal(String selectedVal) {
this.selectedVal = selectedVal;
}
public String getHeadTextKey() {
return headTextKey;
}
public void setHeadTextKey(String headTextKey) {
this.headTextKey = headTextKey;
}
public String getHeadTextVal() {
return headTextVal;
}
public void setHeadTextVal(String headTextVal) {
this.headTextVal = headTextVal;
}
然后我们要调用doStartTag()
因为写代码上去很乱，所有图片很清晰
toHtml()自己定义的，主要就是输出一个StringBuffer 的字符串；
@Override
public int doStartTag() throws JspException {
JspWriter out=pageContext.getOut();//获取JSP的输出流
try {
out.write(toHTML());//自己定义的
} catch (IOException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
};
return super.doStartTag();
}
private String toHTML() throws Exception, Exception {
StringBuilder sb=new StringBuilder();
sb.append("<select id='"+id+"' name='"+name+"'>");
if((headTextKey==null || "".equals(headTextKey)) || headTextVal==null || "".equals( headTextVal)) {
sb.append("<option value='"+headTextKey+"' selexted>"+headTextVal+"</option>");
}
String val;
String html;
for (Object obj : items) {
//要让学生ID存入数据库，让学生的名字展示
//下面的代码使用反射
Field field=obj.getClass().getDeclaredField(textKey);//拿到textKey值
field.setAccessible(true);//打开访问权限；
val=(String) field.get(obj);
//这个方法跟上面的是一样的，这个要导包
html=BeanUtils.getProperty(obj, textVal);
if(val.equals(selectedVal)) {
sb.append("<option value='"+val+"' selexted>"+html+"</option>");
}else {
sb.append("<option value='"+val+"' >"+html+"</option>");
}
}
sb.append("</select>");
return sb.toString();
}
之后就是我们的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">
<description>bowen 1.1 core library</description>
<display-name>bowen core</display-name>
<tlib-version>1.1</tlib-version>
<short-name>c</short-name>
<uri>/cbw</uri>
<tag>
<!-- 填写的是标签中的标签名 -->
<name>set</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.setTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>var</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>value</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 填写的是标签中的标签名 -->
<name>out</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.outTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>value</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>value</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 填写的是标签中的标签名 -->
<name>if</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.DemoIFTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>test</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 填写的是标签中的标签名 -->
<name>select</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.DemoForEchTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>id</name>
<!-- 属性是否必填 -->
<required>false</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>name</name>
<!-- 属性是否必填 -->
<required>false</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>items</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>textKey</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>textVal</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>headTextVal</name>
<!-- 属性是否必填 -->
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<name>headTextKey</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>selectedVal</name>
<!-- 属性是否必填 -->
<required>false</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
再就是我们的JSP页面：
<%
List<Stutend> list=new ArrayList();
list.add(new Stutend("s001","zs"));
list.add(new Stutend("s002","za"));
list.add(new Stutend("s003","zb"));
list.add(new Stutend("s004","zc"));
request.setAttribute("stus", list);
%>
<b:select textVal="name" items="${stus}" textKey="id" headTextVal="---请选择---" headTextKey="-1"></b:select>
运行结果：
案例：（b:if b:forach b:set b:out）
案例（b:if）
首先先写一个助手类：
package com.bowen.jsp;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class DemoIFTag extends BodyTagSupport{
private boolean test;
public boolean getTest() {
return test;
}
public void setTest(boolean test) {
this.test = test;
}
@Override
public int doStartTag() throws JspException {
/* 一个标签属性：test,然后配置
然后调用doStartTag();
下面返回值，EVAL_BODY_INCLUDE（进入计算标签主体内容 ），SKIP_BODY （跳过主体）*/
return test? EVAL_BODY_INCLUDE:SKIP_BODY;
}
}
在去tld;
<tag>
<!-- 填写的是标签中的标签名 -->
<name>if</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.DemoIFTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>test</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
jsp页面
<b:if test="true">啊哈哈哈</b:if>
<b:if test="false">五五</b:if>
运作之后得到内容（啊哈哈哈）即可；
案例（b:forach ）
首先先写一个助手类：
package com.bowen.jsp;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class ForeachTag extends BodyTagSupport{
private static final long serialVersionUID = 7582536045390044131L;
private String var;
private List<Object> items=new ArrayList<>();
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
public List<Object> getItems() {
return items;
}
public void setItems(List<Object> items) {
this.items = items;
}
@Override
public int doStartTag() throws JspException {
Iterator<Object> it=items.iterator();
pageContext.setAttribute(var,it.next());
pageContext.setAttribute("it", it);
return EVAL_BODY_INCLUDE;
}
@Override
public int doAfterBody() throws JspException {
Iterator<Object> in= (Iterator<Object>) pageContext.getAttribute("it");
if(in.hasNext()) {
pageContext.setAttribute(var, in.next());
pageContext.setAttribute("it", in);
return EVAL_BODY_AGAIN;
}else {
return EVAL_PAGE;
}
}
}
之后是tld；
<tag>
<!-- 填写的是标签中的标签名 -->
<name>forEach</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.ForeachTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>var</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>items</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
JSP页面：
<%
List<Stutend> list=new ArrayList();
list.add(new Stutend("s001","zs"));
list.add(new Stutend("s002","za"));
list.add(new Stutend("s003","zb"));
list.add(new Stutend("s004","zc"));
request.setAttribute("stus", list);
%>
<b:forEach var="i" items="${stus}">
${i.id}
${i.name}<br>
</b:forEach>
运行结果如下；
案例（b:set b:out）
首先先写两个个助手类（一个setTag一个outTag）：
先是setTag:
package com.bowen.jsp;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class setTag extends BodyTagSupport {
/**
* 数据标签
* 作用：
* 是将value值赋给变量var
*
*/
private static final long serialVersionUID = 7418230126172807851L;
private String var;
private Object value;
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
public Object getValue() {
return value;
}
public void setValue(Object value) {
this.value = value;
}
@Override
public int doStartTag() throws JspException {
pageContext.setAttribute(var,value);
return SKIP_BODY;
}
}
在是getTag;
package com.bowen.jsp;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;
/**
* out属于uI标签（需要展示效果，是依靠标签属性展示效果）
* JspWriter
* @author 125x
*
*/
public class outTag extends BodyTagSupport {
private static final long serialVersionUID = 2126442038108738978L;
private Object value;
public Object getValue() {
return value;
}
public void setValue(Object value) {
this.value = value;
}
@Override
public int doStartTag() throws JspException {
JspWriter out= pageContext.getOut();
try {
out.print(value);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return super.doStartTag();
}
}
之后是tld
<tag>
<!-- 填写的是标签中的标签名 -->
<name>set</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.setTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>var</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>value</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 填写的是标签中的标签名 -->
<name>out</name>
<!-- 标签对应后台助手 -->
<tag-class>com.bowen.jsp.outTag</tag-class>
<!-- 标签类别 -->
<body-content>JSP</body-content>
<attribute>
<!-- 自定义标签中属性 -->
<name>value</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签中属性 -->
<name>value</name>
<!-- 属性是否必填 -->
<required>true</required>
<!-- 是否支持表达式 EL表达式、ognl表达式-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
JSP页面：
<b:set var="name" value="zs"></b:set>
<b:out value="${name}"></b:out><br>
只要在页面上显示 （zs）就行了；
扫一扫
257
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
