jsp自定义标签（1）

自定义标签作用

在jsp开发时，当jsp内置标签库满足不了需求时，可以根据自己需求来自定义标签，提高代码的可读性，减少代码冗余

jsp自定义标签特点及生命周期

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

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

jsp自定义标签一般有：ui标签，控制标签，数据标签

JSP自定义标签生命周期：

可以看出jsp自定义标签执行步骤有：

1 实例化标签助手类->doStartTag()—> SKIP_BODY–>doEndTag()
//主要用开发简单标签

                                          SKIP_BODY

2 实例化标签助手类->doStartTag()---->EVAL_BODY_INCLUDE—>doAfterBody—>SKIP_BODY—>doEndTag()

3 实例化标签助手类->doStartTag()---->EVAL_BODY_INCLUDE—>doAfterBody—>EVAL_BODY_AGAIN–>doAfterBody //这里遍历内容，如果没有设置结束条件程序会一直运行

其中：
do StartTag:开始标签
SKIP_BODY:跳过标签体
EVAL_BODY_INLUDE:计算标签主体，并输出
do AfterBODY:标签主体之后
EVAL_BODY_AGAIN:将标签主体重新循环
EVAL_PAGE:计算页面后续类容
SKIP_PAGA:跳过页面剩余类容

环境

Set，out，if标签

下面先使用c标签(标签下使用hr线进行分离):

<h1>c标签</h1>
<c:set var="name" value="kk"> </c:set>
<hr/>
<c:out value="${name }"></c:out>
<hr/>
<c:if test="true">男</c:if>
<hr/>
<c:if test="false">女</c:if>

效果：

可以看出：set无输出设置了值，属于数据标签
out有输出，属于ui标签
if中true，false属于控制标签

自定义jsp标签

开发步骤：

1 创建一个标签助手类(继承BodyTagSupport) 标签属性必须助手类的属性对应、且要提供对应get/set方法

2 创建标签库描述文件(tld)，添加自定义标签的配置 注：tld文件必须保存到WEB-INF目录或其子目录

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

创建set，out，if标签助手类：

==set==

/**
 * 
 */
package com.shegx02;

import java.io.Serializable;

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

/**
 * @author SHE
 *
 * 2020年5月26日下午7:57:03
 *  com.shegx02
 */
public class SetTag extends BodyTagSupport{

	private static final long serialVersionUID = 578578329402641291L;
	private String var;
	private Object value;
	public String getVar() {
		return var;
	}
	public void setVar(String var) {
		this.var = var;
	}
	public Object getValue() {
		return value;
	}
	public void setValue(Object value) {
		this.value = value;
	}
	
	
	/* (non-Javadoc)
	 * @see javax.servlet.jsp.tagext.BodyTagSupport#doStartTag()
	 */
	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		//将value赋值给var，跳过标签体
		pageContext.setAttribute(var, value);
		return SKIP_BODY;
	}
}

==out==

/**
 * 
 */
package com.shegx02;

import java.io.IOException;

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

/**
 * @author SHE
 *
 * 2020年5月26日下午7:57:27
 *  com.shegx02
 */
public class OutTag extends BodyTagSupport{

	private static final long serialVersionUID = -634562528990954608L;
	private Object value;

	public Object getValue() {
		return value;
	}

	public void setValue(Object value) {
		this.value = value;
	}
	/* (non-Javadoc)
	 * @see javax.servlet.jsp.tagext.BodyTagSupport#doStartTag()
	 */
	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		//out属于ui标签，本身具备输出能力
		JspWriter out = pageContext.getOut();
		try {
			out.print(value);
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		return SKIP_BODY;
	}
	
}

==if==

/**
 * 
 */
package com.shegx02;

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

/**
 * @author SHE
 *
 * 2020年5月26日下午7:57:40
 *  com.shegx02
 */
public class IfTag extends BodyTagSupport{
	private boolean test;

	public boolean isTest() {
		return test;
	}

	public void setTest(boolean test) {
		this.test = test;
	}

	
	/* (non-Javadoc)
	 * @see javax.servlet.jsp.tagext.BodyTagSupport#doStartTag()
	 */
	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		//如果if标签test为true计算标签体内的内容，false跳过标签体
		return test ? EVAL_BODY_INCLUDE : SKIP_BODY;
	}
}

标签库:

注意:标签库.tld文件放在WebContent文件中

short-name	自定义jsp标签的前缀
uri	调用tld文件的路径名
name	标签名
tag-class	标签助手类路径
body-content	标签的内容形式，empty表示空标签，jsp表示可以为任何jsp元素
attribute	专门配置属性
name	属性名
required	是否必填
rtexprvalue	是否接收表达式

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
    version="2.0">
    
  <description>JSTL 1.1 core library</description>
  <display-name>JSTL core</display-name>
  <tlib-version>1.1</tlib-version>
  <short-name>s</short-name>
  <uri>/she</uri>
  

  
<!-- Set -->
   <tag>
    <name>set</name>
    <tag-class>com.shegx02.SetTag</tag-class>
    <body-content>JSP</body-content>
   <attribute>
        <name>var</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
    </attribute> 
    <attribute>
        <name>value</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
    </attribute> 
  </tag>
  <!-- OUt -->
  <tag>
    <name>out</name>
    <tag-class>com.shegx02.OutTag</tag-class>
    <body-content>JSP</body-content>
 
    <attribute>
        <name>value</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
    </attribute> 
  </tag>
  
  <!-- if -->
  <tag>
    <name>if</name>
    <tag-class>com.shegx02.IfTag</tag-class>
    <body-content>JSP</body-content>
 
    <attribute>
        <name>test</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
    </attribute> 
  </tag>
  
  
</taglib>

下面是jsp页面:

<%@ 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="s" uri="/she" %>
<!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>自定义标签</title>
</head>
<body>
<!--  -->
<h1>c标签</h1>
<c:set var="name" value="kk"> </c:set>
<hr/>
<c:out value="${name }"></c:out>
<hr/>
<c:if test="true">男</c:if>
<hr/>
<c:if test="false">女</c:if>



 
 <h1>自定义s标签</h1>
<s:set var="sex" value="男"></s:set>
<s:out value="${sex }"></s:out>
<s:if test="true">男</s:if>
<s:if test="false">女</s:if> 


</body>
</html>

结果为：