为什么要自定义开发标签?
相信很多人很好奇为啥有现成的标签库,还要去自定义开发标签,举个例子:我们在jsp使用修改时,传值给界面单选按钮是否选中,是这样的:<c:if test="${ name=='男' }">
<input type="radio" checked="checked" value="男">
</c:if>
那如果是爱好类型的复选框呢?爱好有几百种,打个比方,那页面上就全是标签代码了,所以,了解掌握自定义标签开发出适合自己项目的标签,可以减少多余的代码,页面更加直观简洁
标签的语言特点
我们比较常用的标签就是jstl标准标签库---->c标签,我们自定义jsp标签是在此基础上,开发出符合自己的标签使用,它有哪些语言特点,下面带大家看看:<开始标签 属性="属性值">标签体</结束标签>
空标签 : <br/><hr/> <开始标签></结束标签> <开始标签/>
标签的类型大概有三种:
1.ui标签,例如:<c:out value=""></c:out>
2.控制标签,例如:<c:if test="">标签体</c:if>
3.数据标签,例如自定义的数据显示标签:<x:select/>,c标签的<c:set var="" value=""></c:set>
开发和使用步骤
2. 自定义标签的开发及使用步骤
2.1 创建一个标签助手类(继承BodyTagSupport)
标签属性必须与助手类的属性对应、且要提供对应get/set方法
rtexprvalue
1.例如自定义一个<x:if test=" ">标签体</c:if>标签:
package com.zking.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;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() throws JspException {
//如果为真则计算主体输出,否则跳过主体
return test ? EVAL_BODY_INCLUDE:SKIP_BODY;
}
}
2.
2.2 创建标签库描述文件(tld),添加自定义标签的配置
注:tld文件必须保存到WEB-INF目录或其子目录
jstl标签库
<tag>
<!-- 标签名 -->
<name>if</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.IfTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>test</name>
<!-- true表示必填 -->
<required>true</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
类放导包:
2.3 在JSP通过taglib指令导入标签库,并通过指定后缀访问自定义标签
从我们常用的·jstl核心标签库开始入手:
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
如上,我们在使用c标签库时,不仅要导入jar包,还要在页面引入一行代码。接下来点击uri
地址,我们可以看到:
<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
<!-- 代表标签库的版本号 -->
<tlib-version>1.0</tlib-version>
<!-- 代表jsp的版本 -->
<jsp-version>1.2</jsp-version>
<!-- 你的标签库的简称 -->
<short-name>z</short-name>
<!-- 你标签库的引用uri -->
<uri>/zking</uri>
在页面引入:
<%@ taglib uri="/zking" prefix="z" %>
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:再计算主体一次
<%
String[] students = {"彭玉","唐尼","黄蓉"};
request.setAttribute("students",students);
%>
<c:forEach items="${students}" var="s" varStatus="vs">
<z:out value="${s}">
${s},${vs.count}
</z:out>
</c:forEach>
package com.zking.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;public class TestTag extends BodyTagSupport{
private String name;
public String getName() {
return name;
}public void setName(String name) {
this.name = name;
}/**
* 在结束 标签时执行的动作
* 返回值有两种结果
* 1.计算页面的后续部分(默认): EVAL_PAGE
* 2.SKIP_PAGE:跳过页面的后续部分
*/
@Override
public int doEndTag() throws JspException {
System.out.println(" doEndTag().......");
return EVAL_PAGE;
}/**
* 在开始 标签时执行的动作
* 返回值有两种
* 1.跳过标签体内容 SKIP_BODY
* 2.计算标签体 并输出内容
*/
@Override
public int doStartTag() throws JspException {
System.out.println("doStartTag");
System.out.println("我的名字叫"+this.name);
return EVAL_BODY_INCLUDE;
}}
如图:
首先看x:if
:
在开发时,首先仿照c:if
分析:
x:If助手类:
<tag>
<!-- 标签名 -->
<name>if</name>
<!-- 标签工具类 -->
<tag-class>com.zking.tag.IfTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>jsp</body-content>
<!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
<attribute>
<!-- 自定义标签的属性名称 -->
<name>test</name>
<!-- true表示必填 -->
<required>true</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
iftld配置
package com.zking.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;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() throws JspException {
//如果为真则计算主体输出,否则跳过主体
return test ? EVAL_BODY_INCLUDE:SKIP_BODY;
}
}
<x:if test="true">男</x:if>
<x:if test="false">女</x:if>
x:out助手类:
<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表示必填 -->
<required>true</required>
<!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
tld配置
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 doAfterBody() throws JspException {
//out标签直接输出value内容
JspWriter out = pageContext.getOut();
try {
out.print(value);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return SKIP_BODY;
}
@Override
public int doEndTag() throws JspException {
return super.doEndTag();
}/**
* 默认为跳过标签体
*/
@Override
public int doStartTag() throws JspException {
return EVAL_BODY_INCLUDE;
}
}