本文介绍了JSP自定义标签的必要性，如当标准标签库无法满足特定需求时，通过自定义标签来提升代码可读性和减少冗余。文章详细阐述了自定义标签的开发步骤，包括创建标签助手类、编写TLD文件和在JSP中使用。同时，解释了标签的生命周期及其不同流程，如SKIP_BODY和EVAL_BODY_INCLUDE等状态。最后，提供了相关的代码示例。
JSP自定义标签
我们为什么要自定义jsp标签有什么用呢？
在进行JSP页面显示处理的时候，有时候JSTL/Struts/Spring提供的标签库并不能满足项目中显示的需求，特别是对一些要求比较高的定制化服务中，可以使用自定义的标签库去处理。
有些时候如果我们不用自定义标签处理的话那么当我们遇到查询分页、下拉列表回填、复选框回填…，重复代码过多，代码冗余代码的可读性较差，不便于阅读修改。
1. 标签语言特点
<开始标签 属性="属性值">标签体</结束标签>
空标签
<br/><hr/>
<开始标签></结束标签>
<开始标签/>
2. 自定义标签的开发及使用步骤
2.1 创建一个标签助手类(继承BodyTagSupport)
标签属性必须与助手类的属性对应、且要提供对应get/set方法
rtexprvalue
2.2 创建标签库描述文件(tld)，添加自定义标签的配置
注：tld文件必须保存到WEB-INF目录或其子目录
jstl标签库
2.3 在JSP通过taglib指令导入标签库，并通过指定后缀访问自定义标签
3. 标签生命周期
流程A：
SKIP_BODY
3.1 实例化标签助手类->doStartTag()------------->doEndTag()
//主要用开发简单标签
流程B：
EVAL_BODY_INCLUDE SKIP_BODY
3.2 实例化标签助手类->doStartTag()------------->doAfterBody---------------->doEndTag()...
EVAL_BODY_AGAIN
3.3 .....
jrebal 热加载
SKIP_BODY：跳过主体
EVAL_BODY_INCLUDE：计算标签主体内容并[输出]
EVAL_PAGE:计算页面的后续部分
SKIP_PAGE:跳过页面的后续部分
EVAL_BODY_AGAIN:再计算主体一次
大致思路 定义标签 限制，类定义属性，在方法李进行操作
index 代码
<%@page import="java.util.ArrayList"%>
<%@page import="java.util.List"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ taglib prefix="Q" uri="/LQ" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!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>Insert title here</title>
</head>
<body>
<%
String [] s = {"拍一张","zc","sd"};
request.setAttribute("s", s);
List<String> ls = new ArrayList<String>();
ls.add("sdsf");
ls.add("sdfsfds");
ls.add("sdfss1");
pageContext.setAttribute("ls", ls);
pageContext.setAttribute("sss", "ssss343");
%>
<c:forEach items="${s }" var="s" varStatus="vs">
${s }${vs.index }${vs.count }
</c:forEach>
<c:out value="${s }"></c:out>
<c:if test="${! empty s }">
sbbsbsbsbsbsbbsbsbsbsbbsbsbbsbsbbsbsbbsbsbbsbsbsbbsbsbbsbsb
</c:if>
<Q:test>11111111</Q:test>
<h2>pppppyyy</h2>
<Q:ForEach items="${ls }" value="s">
${s }
</Q:ForEach>
<Q:out value="${sss }">${sss }</Q:out>
<Q:if f="${not empty sss }">
<h4>我是大聪明</h4>
</Q:if>
</body>
</html>mytlg.tld 代码
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<!-- 标签库描述符 -->
<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
<!-- 代表标签库的版本号 -->
<tlib-version>1.0</tlib-version>
<!-- 代表jsp的版本 -->
<jsp-version>1.2</jsp-version>
<!-- 你的标签库的简称 -->
<short-name>Q</short-name>
<!-- 你标签库的引用uri -->
<uri>/LQ</uri>
<tag>
<!-- 标签名 -->
<name>test</name>
<!-- 标签工具类 com.zking.tag.TestTag -->
<tag-class>com.zking.tag.TestTag</tag-class>
<!-- 标签的内容类型：empty表示空标签，jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<!-- <attribute>
自定义标签的属性名称
<name>name</name>
true表示必填
<required>true</required>
true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持
<rtexprvalue>false</rtexprvalue>
</attribute> -->
</tag>
<tag>
<!-- 标签名 -->
<name>ForEach</name>
<!-- 标签工具类 com.zking.tag.TestTag -->
<tag-class>com.zking.tag.ForEachTag</tag-class>
<!-- 标签的内容类型：empty表示空标签，jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- //自定义标签的属性名称 -->
<name>items</name>
<!-- //true表示必填 -->
<required>true</required>
<!-- //true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- //自定义标签的属性名称 -->
<name>value</name>
<!-- //true表示必填 -->
<required>true</required>
<!-- //true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 标签名 -->
<name>out</name>
<!-- 标签工具类 com.zking.tag.TestTag -->
<tag-class>com.zking.tag.OutTag</tag-class>
<!-- 标签的内容类型：empty表示空标签，jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- //自定义标签的属性名称 -->
<name>value</name>
<!-- //true表示必填 -->
<required>true</required>
<!-- //true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 标签名 -->
<name>if</name>
<!-- 标签工具类 com.zking.tag.TestTag -->
<tag-class>com.zking.tag.IfTag</tag-class>
<!-- 标签的内容类型：empty表示空标签，jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- //自定义标签的属性名称 -->
<name>f</name>
<!-- //true表示必填 -->
<required>true</required>
<!-- //true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>ForEachTag 代码
package com.zking.tag;
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 String value;
private List<Object> items;
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
public List<Object> getItems() {
return items;
}
public void setItems(List<Object> items) {
this.items = items;
}
/**
* 拿到Iterator
* while(遍历)
* 获取遍历的下一个值
* 将next 存入value
* return 重新计算
*/
//标签之间
@Override
public int doAfterBody() throws JspException {
Iterator<Object> lo = (Iterator<Object>)pageContext.getAttribute("it");//拿到存入的Iterator
while(lo.hasNext()) {
Object next = lo.next();
pageContext.setAttribute(value, next);
//System.out.println(next);
return EVAL_BODY_AGAIN;//重新计算主题
}
return SKIP_BODY;//跳过标签体内容
}
@Override
public int doEndTag() throws JspException {
// TODO Auto-generated method stub
return super.doEndTag();
}
/**
* 1 先判空 判长度
* 获取迭代器
* 存入 next 存入value 和 iterator 也存入
*/
@Override
public int doStartTag() throws JspException {
if(null==this.items||0==this.items.size()) {//筛选
return SKIP_BODY;//跳过标签内容
}
Iterator<Object> iterator = items.iterator();
Object next = iterator.next();
pageContext.setAttribute(value, next);
pageContext.setAttribute("it", iterator);
return EVAL_BODY_INCLUDE;//重新计算并输出
}
}
IfTag 代码
package com.zking.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class IfTag extends BodyTagSupport{
private boolean f ;
public boolean isF() {
return f;
}
public void setF(boolean f) {
this.f = f;
}
public int doAfterBody() throws JspException {
// TODO Auto-generated method stub
return super.doAfterBody();
}
@Override
public int doEndTag() throws JspException {
// TODO Auto-generated method stub
return super.doEndTag();
}
@Override
public int doStartTag() throws JspException {
return f? EVAL_BODY_INCLUDE:SKIP_BODY;
}
}
OutTag 代码
package com.zking.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class OutTag extends BodyTagSupport{
private String value;
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
@Override
public int doAfterBody() throws JspException {
pageContext.setAttribute(value, value);
return SKIP_BODY;
}
@Override
public int doEndTag() throws JspException {
// TODO Auto-generated method stub
return super.doEndTag();
}
@Override
public int doStartTag() throws JspException {
if(this.value==null) {
return SKIP_BODY;
}
//System.out.println(value);
return EVAL_BODY_INCLUDE;
}
}
运行效果
扫一扫
288
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
