1. 标签语言特点
<开始标签 属性="属性值">标签体</结束标签>
空标签
<br/><hr/>
<开始标签></结束标签>
<开始标签/>
2. 自定义标签的开发及使用步骤
2.1 创建一个标签助手类(继承BodyTagSupport)
标签属性必须与助手类的属性对应、且要提供对应get/set方法
rtexprvalue
2.2 创建标签库描述文件(tld),添加自定义标签的配置
注:tld文件必须保存到WEB-INF目录或其子目录
jstl标签库
2.3 在JSP通过taglib指令导入标签库,并通过指定后缀访问自定义标签
3. 标签生命周期
流程A:
SKIP_BODY
3.1 实例化标签助手类->doStartTag()------------->doEndTag()
//主要用开发简单标签
流程B:
EVAL_BODY_INCLUDE SKIP_BODY
3.2 实例化标签助手类->doStartTag()------------->doAfterBody---------------->doEndTag()...
EVAL_BODY_AGAIN
3.3 .....
jrebal 热加载
SKIP_BODY:跳过主体
EVAL_BODY_INCLUDE:计算标签主体内容并[输出]
EVAL_PAGE:计算页面的后续部分
SKIP_PAGE:跳过页面的后续部分
EVAL_BODY_AGAIN:再计算主体一次
自定义out输出标签、if条件标签、forEach循环标签(控制标签)
自定义deptList数据标签,select标签
作用域 page(当前页面) request(一次请求) session (一次会话) application(当前应用程序)
Mytag.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的版本 -->
<jsp-version>1.2</jsp-version>
<!-- 你的标签库的简称 -->
<short-name>test</short-name>
<!-- 你标签库的引用uri -->
<uri>/zking</uri>
<tag>
<!-- 标签名 -->
<name>out</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.OutTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>value</name>
<!--
true表示必填
false表示可不填
-->
<required>true</required>
<!--
true支持动态值,可以向值里面填jsp表达式(${})
、EL表达式,false则不支持 (只可以填写数据或者变量)
-->
<rtexprvalue>false</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 标签名 -->
<name>if</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.IfTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>text</name>
<!--
true表示必填
false表示可不填
-->
<required>true</required>
<!--
true支持动态值,可以向值里面填jsp表达式(${})
、EL表达式,false则不支持 (只可以填写数据或者变量)
-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 标签名 -->
<name>foreach</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.ForeachTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>items</name>
<!--
true表示必填
false表示可不填
-->
<required>true</required>
<!--
true支持动态值,可以向值里面填jsp表达式(${})
、EL表达式,false则不支持 (只可以填写数据或者变量)
-->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>var</name>
<!--
true表示必填
false表示可不填
-->
<required>true</required>
<!--
true支持动态值,可以向值里面填jsp表达式(${})
、EL表达式,false则不支持 (只可以填写数据或者变量)
-->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>varStatus</name>
<!--
true表示必填
false表示可不填
-->
<required>false</required>
<!--
true支持动态值,可以向值里面填jsp表达式(${})
、EL表达式,false则不支持 (只可以填写数据或者变量)
-->
<rtexprvalue>false</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 标签名 -->
<name>select</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.IfTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>text</name>
<!--
true表示必填
false表示可不填
-->
<required>true</required>
<!--
true支持动态值,可以向值里面填jsp表达式(${})
、EL表达式,false则不支持 (只可以填写数据或者变量)
-->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<!-- 标签名 -->
<name>select</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.SelectTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>empty</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>items</name>
<!-- true表示必填 -->
<required>true</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>name</name>
<!-- true表示必填 -->
<required>false</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>valueKey</name>
<!-- true表示必填 -->
<required>true</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>textKey</name>
<!-- true表示必填 -->
<required>true</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>headText</name>
<!-- true表示必填 -->
<required>false</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>selectOptionValue</name>
<!-- true表示必填 -->
<required>false</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<!-- 自定义标签的属性名称 -->
<name>cssStyle</name>
<!-- true表示必填 -->
<required>false</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>false</rtexprvalue>
</attribute>
</tag>
</taglib>
Foreach实现
package com.zking.tag;
import java.util.Iterator;
import java.util.List;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class ForeachTag extends BodyTagSupport {
//jsp中定义的标签名循环的数据
private Object items;
//jsp中定义的标签名循环名
private String var;
//用来数据判断
private String varStatus;
private Object[] values;
//用来数据判断
private List<Object> list;
public String getVarStatus() {
return varStatus;
}
public void setVarStatus(String varStatus) {
this.varStatus = varStatus;
}
public static class varStatusa{
private int index;
private int count;
public int getIndex() {
return index;
}
public void setIndex(int index) {
this.index = index;
}
public int getCount() {
return count;
}
public void setCount(int count) {
this.count = count;
}
}
public Object getItems() {
return items;
}
public void setItems(Object items) {
this.items = items;
}
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
/**
* 中间
*/
@Override
public int doAfterBody() throws JspException {
//拿到遍历次数
int a =(int) pageContext.getAttribute("aa");
//拿到下标
int b =(int) pageContext.getAttribute("b");
//把遍历的数据放入name中
if(b!=values.length-1) {
pageContext.setAttribute(var,values[b+1]);
}
//等于0结束循环
if(a==1) {
return SKIP_BODY;
}else {
varStatusa var =(varStatusa) pageContext.getAttribute(this.varStatus);
var.setCount(b+2);
var.setIndex(b+1);
//确保循环次数不会多少
a--;
//判断下标是否大于length-1
//下标从0开始length等于的数比下标大1
if(b!=values.length-1) {
b++;//确保下标不会越界
}
//刷新下标
pageContext.setAttribute("b", b);
//刷新循环次数
pageContext.setAttribute("aa", a);
return EVAL_BODY_AGAIN;
}
}
/**
* 结束
*/
@Override
public int doEndTag() throws JspException {
return EVAL_PAGE;
}
/**
* 开始
*/
@Override
public int doStartTag() throws JspException {
//对value进行判断是否是数组
if(items.getClass().isArray()) {//是数组
//把Object强转成Object数组
this.values=(Object[])items;
//给下标设置一个初始值(java下标从零开始)
pageContext.setAttribute("b", 0);
//拿到length作为遍历次数
int a=values.length;
//给遍历次数设置一个初始值
pageContext.setAttribute("aa", a);
varStatusa vara=new varStatusa();
vara.setCount(0+1);
vara.setIndex(0);
pageContext.setAttribute(this.varStatus, vara);
pageContext.setAttribute(var,values[0]);
return EVAL_BODY_INCLUDE;
}else {//是集合
//把Object强转成list集合
this.list=(List<Object>)items;
//把集合转成Object数组
this.values= this.list.toArray(new Object[list.size()]);
//给下标设置一个初始值(java下标从零开始)
pageContext.setAttribute("b", 0);
//拿到length作为遍历次数
int a=values.length;
//给遍历次数设置一个初始值
pageContext.setAttribute("aa", a);
varStatusa vara=new varStatusa();
vara.setCount(0+1);
vara.setIndex(0);
pageContext.setAttribute(this.varStatus, vara);
pageContext.setAttribute(var,values[0]);
return EVAL_BODY_INCLUDE;
}
}
}
if实现
package com.zking.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class IfTag extends BodyTagSupport{
private boolean text;
public boolean isText() {
return text;
}
public void setText(boolean text) {
this.text = text;
}
@Override
public int doStartTag() throws JspException {
if(text) {
return EVAL_BODY_INCLUDE;
}else {
return SKIP_BODY;
}
}
}
out实现
package com.zking.tag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class OutTag extends BodyTagSupport{
private Object value;
public Object getValue() {
return value;
}
public void setValue(Object value) {
this.value = value;
}
/**
* 开始标签
*/
@Override
public int doStartTag() throws JspException {
if(value.equals("")||value==null) {
return SKIP_BODY;
}else {
JspWriter out = pageContext.getOut();
try {
out.print(value);
} catch (IOException e) {
e.printStackTrace();
}
return EVAL_PAGE;
}
}
}