自定义标签_前端自定义标签-优快云博客

文章介绍了JSP自定义标签的概念，包括标签、标签库和标签库描述文件(TLD)。通过一个名为OutTag的例子，展示了自定义标签的开发过程，包括创建标签助手类和编写TLD文件。此外，还提到了自定义标签的生命周期及其相关返回值，如SKIP_BODY和EVAL_BODY_AGAIN等。

一. 什么是自定义标签

一般我们说自定义标签是指JSP自定义标签。自定义标签在功能上逻辑上与javaBean 类似,都封装Java 代码。自定义标签是可重用的组件代码，并且允许开发人员为复杂的操作提供逻辑名称。
JSP开发人员使用标签库创建标签.标签库是按照功能或实现进行分组的自定义标签的集合。
网络上常见的CMS内容管理系统都是采用模板的形式来实现，基本上所有的CMS系统都有一套自己的模板标签书写方法，简称自定义标签。

基本概念

1.1 标签（Tag）：
标签是一种XML元素，通过标签可以使JSP网页变得简洁并且易于维护，还可以方便地实现同一个JSP文件支持多种语言版本。由于标签是XML元素，所以它的名称和属性都是大小写敏感的。
1.2 标签库（Tag library）：
由一系列功能相似、逻辑上互相联系的标签构成的集合称为标签库。
1.3 标签库描述文件（Tag Library Descriptor）：
标签库描述文件是一个XML文件，这个文件提供了标签库中类和JSP中对标签引用的映射关系。它是一个配置文件，和web.xml是类似的。

二. 自定义标签的语言特点

标准标签：

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

空标签：

<开始标签/>

三. 自定义标签的开发及使用步骤

1. 创建一个标签助手类（继承BodyTagSupport）

package com.xissl.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class OutTag extends BodyTagSupport{
	
	private String val;
	private String defaultVal;
	
	public String getVal() {
		return val;
	}
	public void setVal(String val) {
		this.val = val;
	}
	public String getDefaultVal() {
		return defaultVal;
	}
	public void setDefaultVal(String defaultVal) {
		this.defaultVal = defaultVal;
	}
	
	@Override
	public int doStartTag() throws JspException {
		//pageContext为页面上下文对象，用于和jsp共享数据
		JspWriter out = pageContext.getOut();
		try {
			if(val==null || "".equals(val)) {
				out.print(defaultVal);
			}
			else {
				out.print(val);
			}
		} catch (Exception e) {
			
		}
		return SKIP_BODY;
	}

}

2. 编写标签库描述文件（tld），在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-version>1.2</jsp-version>
	<short-name>Simple Tags</short-name>
	<uri>/xissl</uri>
	<tag>
		<!-- 标签名 -->
		<name>out</name>
		<!-- 标签助手类 -->
		<tag-class>com.xissl.tag.OutTag</tag-class>
		<!-- 标签的内容类型，empty表示为空标签，jsp表示为任意 -->
		<body-content>empty</body-content>
		<attribute>
			<!-- 属性名 -->
			<name>val</name>
			<!-- 表示该属性为必要的属性 -->
			<required>true</required>
			<!-- 表示该属性可以接受EL表达式 -->
			<rtexprvalue>true</rtexprvalue>
			<!-- 标签描述：用于说明标签的作用 -->
			<description>out标签val属性，用于输出val的值</description>
		</attribute>
		<attribute>
			<name>defaultVal</name>
			<required>false</required>
			<rtexprvalue>false</rtexprvalue>
		</attribute>
	
	</tag>
</taglib>

3. JSP通过taglib指令导入标签库

<%@ taglib prefix="l" uri="/xissl" %>

4. 在页面中使用自定义标签

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <%@ taglib prefix="l" uri="/xissl" %>
<!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>
<l:out val="我要输出的内容是yhsb"/>

</body>
</html>

运行结果如下：
在这里插入图片描述

四. 自定义标签生命周期

理解：

当我们实例化标签助手类后就可以开始通过doStartTag方法来处理JSP标签，在我们发送响应时，在doStartTag内部会开始判断是否有标签体。如果有标签体就会进入到doAFterBody方法中，在doAFterBody方法里会继续判断里面是否有方法体，如果里面还有方法体未执行完会继续执行doAFterBody方法。当doAFterBody方法里面的标签体处理完了就会执行doEndTag，这样一个JSP生命周期就结束了

在这里插入图片描述