jsp自定义标签

顾婉宁

已于 2022-06-14 11:41:00 修改

阅读量355

点赞数

文章标签： html 前端

于 2022-06-10 17:13:33 首次发布

本文链接：https://blog.csdn.net/weixin_64738832/article/details/125224831

版权

1、标签的语言特点

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

空标签

<开始标签></结束标签>

<开始标签/>

2、自定义标签的开发及使用步骤

2.1创建一个标签助手类(继承BodyTagSupport)

注：标签的属性必须与助手类的属性对应，且要提供对应的get/set方法

TestTag类：

package com.zking.jspTag.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
/**
 * 自定义标签开发步骤
 * 1)创建标签助手类并继承BodyTagSupport
 * 注：标签属性必须与助手的属性对应，并且要提供对应get/set方法
 * 2)创建标签描述文件(tld)，必须放置到WEB-INF或其子目录文件下
 * 
 * 3)在页面中通过taglib指令引入自定义标签库
 * @author zjjt
 */
public class TestTag extends BodyTagSupport {
	
	private Object name;
	
	private int count=0;
	
	public Object getName() {
		return name;
	}
	public void setName(Object name) {
		this.name = name;
	}
	/**
	 * doStartTag():表示<开始标签>所应对执行的动作
	 * 例如：对应<z:test>标签所执行的动作
	 * 返回值：
	 * 1)SKIP_BODY:跳过主体内容不输出
	 * 2)EVAL_BODY_INCLUDE:计算主体内容并包含在输出中
	 */
	@Override
	public int doStartTag() throws JspException {
		System.out.println("name="+this.name);
		System.out.println("doStartTag():表示<开始标签>所应对执行的动作");
		return EVAL_BODY_INCLUDE;
	}
	/**
	 * doAfterBody：介于<开始标签>标签体与</结束标签>之间所执行的动作
	 * 例如：介于<z:test>T277与</z:test>之间所执行的动作
	 * 返回值：
	 * 1)SKIP_BODY:跳过主体内容不输出(在此处可把它理解为for循环中的break)
	 * 2)EVAL_BODY_AGAIN:计算主体内容并包含在输出中(可以理解为coutinue)
	 */
	@Override
	public int doAfterBody() throws JspException {
		System.out.println("doAfterBody：介于<开始标签>标签体与</结束标签>之间所执行的动作");
		if(count<3) {
			count++;
			return EVAL_BODY_AGAIN;
		}
		return SKIP_BODY;
	}
	/**
	 * doEndTag():表示<结束标签>所对应执行的动作
	 * 例如:对应</z:test>所执行的动作
	 * 返回值：
	 * 1)SKIP_PAGE:跳过页面的后续内容
	 * 2)EVAL_PAGE:计算页面的后续内容
	 */
	@Override
	public int doEndTag() throws JspException {
		System.out.println("doEndTag():表示<结束标签>所对应执行的动作");
		return EVAL_PAGE;
	}
}

2.2创建标签库描述文件(tld)，添加自定义标签的配置

注：tld文件必须保存到WEB-INF或其子目录下

mytag.ltd文件：

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

	<tag>
		<!-- 标签名 -->
		<name>test</name>
		<!-- 标签工具类 -->
		<tag-class>com.zking.jspTag.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>

2.3在JSP通过taglib指令导入标签库，并通过指定后缀访问自定义标签

index.jsp:

<%@page import="java.util.Arrays"%>
<%@page import="java.util.ArrayList"%>
<%@page import="java.util.List"%>
<%@ 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="/zking" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<%
	List<String> lst=Arrays.asList(new String[]{"zs","ls","ww"});
	//page->request->session->application
	request.setAttribute("lst",lst);
	request.setAttribute("name", "易哲");
%>
<c:forEach items="${lst }" var="n">
${n }
</c:forEach>
<h2>1.自定义test标签</h2>
<z:test name="${name }">T277</z:test>
不被定义的<br/>
坚持的<br/>
勇敢的<br/>
坚定且勇敢的18岁<br/>
</body>
</html>

3、标签生命周期。

流程A：

实例化助手类 -> doStartTag -> doEndTag -> 取消助手类引用

流程B：

实例化助手类 -> doStartTag -> doAfterBody -> doEndTag -> 取消助手类引用

核心方法：

doStartTag：

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

返回值：SKIP_BODY——跳过主体内容不输出

EVAL_BODY_INCLUDE——计算标签体内容并包含在输出中

doAfterBody：对应<开始标签>标签体与</结束标签>之间所执行的动作

返回值：SKIP_BODY——跳过主体内容不输出，充当循环终止的作用（break）

EVAL_BODY_AGAIN——再次计算主体内容并包含在输出中，充当循环跳过的作用（continue）

doEndTag：

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

返回值：SKIP_PAGE——跳过页面的后续内容

EVAL_PAGE——计算页面的后续内容

举例：

package com.zking.jspTag.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
/**
 * 自定义标签开发步骤
 * 1)创建标签助手类并继承BodyTagSupport
 * 注：标签属性必须与助手的属性对应，并且要提供对应get/set方法
 * 2)创建标签描述文件(tld)，必须放置到WEB-INF或其子目录文件下
 * 
 * 3)在页面中通过taglib指令引入自定义标签库
 * @author zjjt
 */
public class TestTag extends BodyTagSupport {
	
	private Object name;
	
	private int count=0;
	
	public Object getName() {
		return name;
	}
	public void setName(Object name) {
		this.name = name;
	}
	/**
	 * doStartTag():表示<开始标签>所应对执行的动作
	 * 例如：对应<z:test>标签所执行的动作
	 * 返回值：
	 * 1)SKIP_BODY:跳过主体内容不输出
	 * 2)EVAL_BODY_INCLUDE:计算主体内容并包含在输出中
	 */
	@Override
	public int doStartTag() throws JspException {
		System.out.println("name="+this.name);
		System.out.println("doStartTag():表示<开始标签>所应对执行的动作");
		return EVAL_BODY_INCLUDE;
	}
	/**
	 * doAfterBody：介于<开始标签>标签体与</结束标签>之间所执行的动作
	 * 例如：介于<z:test>T277与</z:test>之间所执行的动作
	 * 返回值：
	 * 1)SKIP_BODY:跳过主体内容不输出(在此处可把它理解为for循环中的break)
	 * 2)EVAL_BODY_AGAIN:计算主体内容并包含在输出中(可以理解为coutinue)
	 */
	@Override
	public int doAfterBody() throws JspException {
		System.out.println("doAfterBody：介于<开始标签>标签体与</结束标签>之间所执行的动作");
		if(count<3) {
			count++;
			return EVAL_BODY_AGAIN;
		}
		return SKIP_BODY;
	}
	/**
	 * doEndTag():表示<结束标签>所对应执行的动作
	 * 例如:对应</z:test>所执行的动作
	 * 返回值：
	 * 1)SKIP_PAGE:跳过页面的后续内容
	 * 2)EVAL_PAGE:计算页面的后续内容
	 */
	@Override
	public int doEndTag() throws JspException {
		System.out.println("doEndTag():表示<结束标签>所对应执行的动作");
		return EVAL_PAGE;
	}
}

顾婉宁

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
1
评论
jsp自定义标签

标签体空标签注：标签的属性必须与助手类的属性对应，且要提供对应的get/set方法TestTag类：2.2创建标签库描述文件(tld)，添加自定义标签的配置注：tld文件必须保存到WEB-INF或其子目录下mytag.ltd文件：2.3在JSP通过taglib指令导入标签库，并通过指定后缀访问自定义标签index.jsp:3、标签生命周期。......
复制链接

扫一扫