自定义标签作用
在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>
结果为: