J2EE从入门到入土09.自定义jsp标签(上)

也跌

已于 2022-07-11 18:22:57 修改

阅读量331

点赞数 2

分类专栏： J2EE 文章标签： java java-ee servlet

于 2022-07-08 08:37:09 首次发布

本文链接：https://blog.csdn.net/github_67177094/article/details/125670717

版权

J2EE 专栏收录该内容

9 篇文章 0 订阅

订阅专栏

目录

什么是jsp标签库

jstl标签库的概念

jsp自定义标签的生命周期

自定义标签

自定义标签类

out标签类

if标签类

编写标签库描述文件

测试自定义标签

什么是jsp标签库

标签的概念

是标记语言(Mark Language)，是一种注释文本的语言，以便于计算机可以操作。很多与“ML”结尾的语言都是标记语言，比如：HTML，XML，XHTML，VML等等
标记语言与其他语言一样，也需要运行它们的环境，比如HTML的运行环境时浏览器，XML也要自己的解析和运行的环境

标签类型

UI标签，输出页面元素
控制标签，如if标签，foreach标签等
数据标签，用于向页面输入数据

基本结构

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

空标签(没有标签体)

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

jstl标签库的概念

是一个JSP标签集合，它封装了JSP应用的通用核心功能，基于JSP标签我们可以理解为，是JSP应该通用功能的一种封装方式

jsp自定义标签的生命周期

在标签助手类中首先执行doStartTag方法，这个方法会有一个返回值，如果返回值为SKIP_BODY那么会判断为无标签体，则执行doEndTag方法；如果返回值为EVAL_BODY_INCLUDE则代表有返回值，在执行doAfterBody方法，这个方法也会有返回值，如果返回值为EVAL_PAGE则标签体结束，如果返回值为EVAL_BODY_AGAIN则继续返回标签体，执行标签体内代码，再次判断返回值为何。当跳过标签体后也会执行doEndTag方法，这个方法中也有EVAL_PAGE和SKIP_PAGE两个返回值。当doEndTag方法执行完成，取消标签助手类。

自定义标签

自定义标签类

out标签类

/**
*     out 标签作用：向JSP页面中写入数据
*/
public class OutTag extends BodyTagSupport{  
  
    private String val;
	private String defaultVal;
 
	public void setVal(String val) {
		this.val = val;
	}
    //为空时设置默认值的方法
	public void setDefaultVal(String defaultVal) {
		this.defaultVal = defaultVal;
	}
    
    //标签的开始方法(需要给自定义的标签添加什么操作，就重写对应的生命周期中的方法)
	@Override
	public int doStartTag() throws JspException {
        //this.pageContext：通过当前类获取pageContext对象
        //pageContext对象中有一个getOut写出方法
		JspWriter out = this.pageContext.getOut();		
		try {
			if(val==null&&val.equals("")) {
				out.println(this.defaultVal);
			} else {
				out.println(this.val);
			}
		} catch (Exception e) {
			e.printStackTrace();
		}		
        //跳过标签体，out定义的是空标签
		return SKIP_BODY;
	}
}

if标签类

@SuppressWarnings("serial")
public class IfTag extends BodyTagSupport{
	private boolean test;
	public boolean isTest() {
		return test;
	}
	public void setTest(boolean test) {
		this.test = test;
	}	
	@Override
	public int doStartTag() { 		
		if(this.isTest()) {
            //判断标签体时
			return EVAL_BODY_INCLUDE;
		} 
		return SKIP_BODY;		
	}
}

编写标签库描述文件

<!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>/zking</uri>
	
	<tag>
		<name>out</name>
		<tag-class>com.myjstl.OutTag</tag-class>
		<body-content>empty</body-content>
		<attribute>
			<name>val</name>
			<required>true</required>
			<rtexprvalue>true</rtexprvalue>
			<description>out标签val属性，用于输出val的值</description>
		</attribute>
		<attribute>
			<name>defaultVal</name>
			<required>false</required>
			<rtexprvalue>false</rtexprvalue>
			<description>用于定义默认值</description>
		</attribute>
	</tag>
	
	<tag>
		<name>if</name>
		<tag-class>com.myjstl.IfTag</tag-class>
		<body-content>jsp</body-content>
		<attribute>
			<name>test</name>
			<required>true</required>
			<rtexprvalue>true</rtexprvalue>
			<description>if标签</description>
		</attribute>
	</tag>
</taglib>

解释文档

<tag></tag>：里面放一个自定义标签的所有格式规范
<name>out</name>：表示自定义的标签名
<tag-class>com.zking.mymvc.tag.OutTag</tag-class>：表示第一步中自定义的标签类的完整类名(这里是通过反射机制找到自定义的标签类的)
<body-content>empty</body-content>：代表没有标签体，填jsp就代表有
<attribute>：代表自定义的标签类中的属性规范 <name>val</name>：自定义的属性名字
<required>true</required>：自定义的标签中必须写出的属性
<rtexprvalue>true</rtexprvalue>：属性值是否可以使用EL表达式
<description>out标签val属性，用于输出val的值</description>：自定义属性的描述
</attribute>

测试自定义标签

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@taglib prefix="z" uri="/zking" %>
<!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>
 
	<%
		request.setAttribute("name", null);
	%>
	<!-- out 标签 -->
	<z:out val="${name}" defaultVal="输入内容不正确"/>
	
	
	<z:if test="${100 == 100}">
		测试if(100 == 100)
	</z:if>
	
	<z:if test="${100 != 200}">
		测试if(100 != 200)
	</z:if>
</body>
</html>