自定义标签开发和使用步骤

最新推荐文章于 2024-09-14 14:43:52 发布

小雪生xvx

最新推荐文章于 2024-09-14 14:43:52 发布

阅读量904

点赞数 18

文章标签：笔记

本文链接：https://blog.csdn.net/2301_81912959/article/details/141020291

版权

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

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），添加自定义标签的配置

<!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>test</short-name>
	<!-- 你标签库的引用uri -->
	<uri>/zking</uri>

	<tag>
		<!-- 标签名 -->
		<name>test</name>
		<!-- 标签工具类 -->
		<!--Class.forName(com.zking.tag.TestTag)
		ClASSNotFoundException异常
		-->
		<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>true</rtexprvalue>
		</attribute>
	</tag>
</taglib>

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

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

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

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

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

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

<z:test>demo</z:test>

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

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

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

<z:test>demo</z:test>

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

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

<z:test>demo</z:test>

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

返回值

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