作用:
虽然JSTL标准标签库提供了很多通用标签,
但实际开发需求复杂多变,
这些通用标签是不能完全在JSP页面替代java代码,
因此需要我们自定义标签来替代java代码!
1.传统标签
1).原理
Tag接口
|---IterationTag接口
|---TagSupport类--
|---BodyTag接口 |
BodyTagSupprot类
Tag生命周期:
第一次使用时创建实例,从此驻留内存重复利用,每次都会依次执行:
setPageContext(PageContext pc) 传入jsp对象
setParent(Tag t) 传入父标签
doStartTag() 通过返回值来控制标签体是否执行
doEndTag() 通过返回值控制标签后jsp页面是否执行
release() 服务器停止前调用销毁对象
2).自定义步骤:
1).编写一个类实现Tag接口
2).编写一个tld文件描述Tag类
3).在jsp页面中引入tld文件
传统标签自定义相当繁琐,需分析开始标签和结束标签时,还需分析返回标签体控制程序,
一般不推荐使用,简单标签SimpleTag更方便开发!
2.简单标签
1).原理
SimpleTag接口
|---SimpleTagSupport实现类
SimpleTag生命周期:
每次访问标签时都创建简单标签对象,用完即销毁。
setJspContext(JspContext pc) 传入当前jsp的PageContext对象
setParent(JspTag parent) 若标签有父标签,则调用传入
setXXX() 若标签有属性,则调用传入
setJspBody(JspFragment jspBody) 若标签有标签体,则调用传入
doTag() 处理标签替代的java代码
2).自定义步骤
1).编写一个类继承SimpleTagSupport,覆盖doTag(),调用getJspContext/getJspBody获取JSP内容;
public class MyTag extends SimpleTagSupport {
@Override
public void doTag(){
// 标签体重复输出
for(int i=0;i<attr;i++)
getJspBody().invoke(null);
/* // 默认会执行标签后续JSP页面
// 抛出SkipPageException异常,不执行后续JSP页面
throw new SkipPageException();
// 获取标签体
StringWriter writer = new StringWriter();
getJspBody().invoke(writer);
String str = writer.toString();
// 修改后输出
getJspContext().getOut().write(str.toUpperCase()); */
}
// 自定义标签属性attr
private int attr;
public void setAttr(int attr) {
this.attr = attr;
}
}
2).在WEB-INF目录下编写一个tld文件,描述自定义SimpleTag类;
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" 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">
<tlib-version>1.0</tlib-version>
<short-name>MyTag</short-name>
<uri>http://www.xxx.com/MyTag</uri>
<tag>
<name>myTag</name> 标签名
<tag-class>com.xx.MyTag</tag-class> 标签处理类
<body-content>scriptless/empty</body-content>
scriptless不能含Java脚本代码
empty代表只能为空
tagdependent不会输出到浏览器
JSP代表任意内容,不能在简单标签使用,只能在传统标签使用
<attribute> 声明属性
<name>attr</name> 属性名
<required>true</required> 是否为必须存在
<rtexprvalue>true</rtexprvalue> 是否支持EL表达式
<type>int</type> 属性java类型
</attribute>
</tag>
</taglib>
3).在jsp页面中引入tld文件,使用自定义标签
<%@ taglib uri="http://www.xxx.com/MyTag" prefix="MyTag"%>
<MyTag:myTag attr="10">循环输出文本</MyTag:myTag>
简书: http://www.jianshu.com/p/55afd8a45a02
CSDN博客: http://blog.csdn.net/qq_32115439/article/details/54695126
GitHub博客:http://lioil.win/2017/01/23/JSP-MyTag.html
Coding博客:http://c.lioil.win/2017/01/23/JSP-MyTag.html