2025-05-26 06:30:42自定义标签开发和使用步骤

目录

为什么要使用自定义标签？

1.自定义标签作用

2.自定义标签使用步骤

2.1.第一步 ：创建标签助手类并继承BodyTagSupport

2.2.导入或创建标签描述文件 （.tld），添加自定义标签的配置

2.3.第三步：在指定的jsp页面引入自定义标签库

3.自定义标签的生命周期和运行流程

doStartTag：对应开始标签所执行的动作

doEndTag ：对应结束标签所执行的动作

doAfterBody： 用于执行循环之类的操作，介于<开始标签>标签体 之间所执行的动作

返回值

运行流程

为什么要使用自定义标签？

我们在javaweb中常常会用到一些jsp的标签，比如c:foreach、c:if、fmt:formatDate等标签，但是sun公司提供的这些标签虽然能够满足我们大部分的应用需求，但是对于一些特殊应用需求就不能满足了，这时候我们就需要自定义一些我们自己的标签库

1.自定义标签作用

移除jsp页面的java代码控制jsp页面某一部分内容是否执行（内容权限控制）控制整个jsp页面是否执行（页面权限控制）控制jsp页面内容（标签体）重复执行修改jsp页面的内容输出

标签由三部分组成：

<开始标签 属性="属性值">标签体

分为：

空标签（单标签） ：<开始标签/>标准标签（双标签）：<开始标签>标签体

2.自定义标签使用步骤

1，创建标签助手类并继承BodyTagSupport

2，在WEB-INF目录或其子目录下导入或创建标签描述文件 （.tld）

3，在指定的jsp页面引入自定义标签库

2.1.第一步 ：创建标签助手类并继承BodyTagSupport

public class TestTag extends BodyTagSupport {

...

}

注： 标签助手类中的属性名要与描述文件中的属性名一致，且必须提供get/set方法

2.2.导入或创建标签描述文件 （.tld），添加自定义标签的配置

PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"

"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">

1.0

1.2

test

/zking

test

com.zking.tag.TestTag

jsp

name

true

true

注：(.tld) 必须保存到在WEB-INF目录或其子目录下哦！

2.3.第三步：在指定的jsp页面引入自定义标签库

<%@taglib prefix="z" uri="/zking" %>

3.自定义标签的生命周期和运行流程

doStartTag：对应开始标签所执行的动作

当JSP容器遇到自定义标签的起始标志，就会调用doStartTag()方法,doStartTag()方法返回一个整数值，用来决定程序的后续流程。

demo

当执行到z:test开始标签时，将会执行对应标签工具类中的doStartTag方法

doEndTag ：对应结束标签所执行的动作

当JSP容器遇到自定义标签的结束标志，就会调用doEndTag()方法。doEndTag()方法也返回一个整数值，用来决定程序后续流程

demo

当当执行到/z:test结束标签时，将会执行对应标签工具类中的doEndTag方法

doAfterBody： 用于执行循环之类的操作，介于<开始标签>标签体 之间所执行的动作

demo

调用z:test并执行动作之后(输出了一次标签主体内容之后)，在/z:test执行动作之前所执行的动作

返回值

方法返回值注释SKIP_BOOY跳过标签内容体不输出EVAL_BOOY_INCLUOE计算标签体内容并包含在输出中EVAL_BOOY_AGAIN再次计算输出标签体内容SKIP_PAGE跳过页面的后续内容EVAL_PAGE计算页面的后续内容

运行流程

流程A

流程B （有循环体）