前两天在写自定义标签开发的时候,在网上查了查自定义标签开发的文章,但是并没有发现什么写的比较完全的文章。经过自己一番研究以后,写出了一个自定义标签,虽然简单,但是希望能够通过这个简单的例子让大家了解到自定义标签的开发。
1、定义一个实现Tag接口的子类。
package com.xzl.privilege.utils;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.Tag;
public class MyTag implements Tag{
private boolean isMenu;
private PageContext pageContext;
public boolean getIsMenu() {
return isMenu;
}
public void setIsMenu(boolean isMenu) {
this.isMenu = isMenu;
}
@Override
public int doEndTag() throws JspException {
// TODO Auto-generated method stub
return EVAL_PAGE;
}
@Override
public int doStartTag() throws JspException {
System.out.println("this is my tag");
try {
JspWriter out = this.pageContext.getOut();
if(this.isMenu == false) {
// out.println("noMenu");
return SKIP_BODY; //跳过开始和结束之间的代码
}else{
// out.println("hasMenu");
return EVAL_BODY_INCLUDE; //输出标签体到当前的输出流
}
} catch(Exception e) {
throw new JspException(e.getMessage());
}
}
@Override
public Tag getParent() {
// TODO Auto-generated method stub
return null;
}
@Override
public void release() {
// TODO Auto-generated method stub
}
@Override
public void setPageContext(PageContext pageContext) {
this.pageContext = pageContext;
}
@Override
public void setParent(Tag arg0) {
}
}
2、创建该接口的tld文件,文件保存在WEB-INF目录下,即web.xml文件同级目录。比如我创建的tld文件为MyTag.tld,文件内容为
<?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 web-jsptaglibrary_2_0.xsd">
<tlib-version>1.0</tlib-version>
<jsp-version>2.0</jsp-version>
<short-name>privilege</short-name>
<uri>/MyTag</uri><!-- 和web.xml中的文件相对应 -->
<tag>
<name>showMenu</name><!-- <privilege:showMenu isMenu="false">显示还是不显示呢?</privilege:showMenu> -->
<tag-class>com.xzl.privilege.utils.MyTag</tag-class>
<!-- 设置标签是否内容为空 jsp :标签体由其他jsp元素组成 empty :标签体必须为空 tagdependent : 由标签解释,不带jsp转换 -->
<body-content>jsp</body-content>
<attribute>
<name>isMenu</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
3、在web.xml文件中配置自己的标签
<!-- 注册自定义标签库,指定tld文件的位置 -->
<jsp-config>
<taglib>
<taglib-uri>/MyTag</taglib-uri>
<taglib-location>/WEB-INF/MyTag.tld</taglib-location>
</taglib>
</jsp-config>
4、在jsp页面中使用自己的标签 (1、)在页面头引入自己的标签
<%@ taglib prefix = "privilege" uri = "/MyTag" %>
(2、)使用标签
<privilege:showMenu isMenu="false">显示还是不显示呢?</privilege:showMenu>
<privilege:showMenu isMenu="true">显示还是不显示呢?</privilege:showMenu>
最后的页面显示出来的结果为当isMenu为true时,继续执行标签body中的内容,否则跳过里面的内容