自定义标签
1.步骤
- 标签处理类(标签也是一个对象,那么就需要先有类)
- tld文件,它是一个xml
- 页面中使用<%@taglib%>来指定tld文件的位置
2.标签处理类
SimpleTag接口: - void doTag():每次执行标签时都会调用这个方法
- JspTag getParent():返回父标签(非生命周期方法)
- void setParent(JspTag):设置父标签
- void setJspBody(JspFragment):设置标签体
- void seetJspContext(JspContext):设置jsp上下文对象,它儿子是PageContext
其中doTag()会在其他三个方法之后被tamcat调用。说明可以在它里面使用其他三个方法
/**
* 自定义标签 标签处理类
*
* @author 赵奇
*
*/
public class MyTag implements SimpleTag {
private PageContext pageContext;
private JspFragment body;
/**
* 所有的setXxx都在doTag()方法之前被tomcat调用,所有在它中可以使用tomcat传递过来的对象
*/
public void doTag() throws JspException, IOException {
pageContext.getOut().print("hello");
}
public void setParent(JspTag parent) {}
public JspTag getParent() {
return null;
}
public void setJspContext(JspContext context) {
this.pageContext = (PageContext) context;
}
public void setJspBody(JspFragment body) {
this.body = body;
}
3.配置tld文件
tld文件一般放到WEB-INF之下,这样保证客户端访问不到
<?xml version="1.0" encoding="UTF-8" ?>
<taglib xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
version="2.1">
<tlib-version>1.0</tlib-version>
<short-name>Tld</short-name>
<tag>
<name>MyTld1</name>
<tag-class>Demo.MyTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
4.页面中指定tld文件
<%@ taglib prefix="tld" uri="/WEB-INF/MyFirstTld.tld" %>
导标签库,就是为页面指定tld文件的位置
继承SimpleTagSupport的用法
public class MyTld02 extends SimpleTagSupport {
@Override
public void doTag() throws JspException, IOException {
this.getJspContext().getOut().print("hello02");
}
}
进阶
标签体内容
- empty:无标签体(使用)
- JSP:jsp2.0已经不支持这个类型了。表示标签体内容可以是:java脚本、标签和EL表达式
- scriptless:只能是EL表达式,也可以是其他的标签(使用)
- tagdependent:标签体内容不会被执行,而是直接赋值标签处理类
不在执行标签下面内容的标签
- 在标签处理类中的doTag()中使用SkipPageException来结束。TomCat会调用 标签处理类的doTag()方法,然后TomCat会得到SkipPageException,它会跳过本页面其他内容。
标签属性
步骤:
1.给你的标签处理类添加属性
为标签处理类添加属性,属性至少要且一个set方法,这个set方法会在doTag()方法之前被TomCat执行,所有在doTag()中就可以使用属性了。
2.在tld文件中对属性进行配置
<attribute>
<name>test</name> // 指定属性名
<required>true</required> // 指定属性是否为必需的
<rtexprvalue>true</rtexprvalue> // 指定属性是否可以使用EL表达式
</attribute>