JSTL自定义标签（三）

浏览数：25 / 时间：2015年06月09日

上篇讲解的是JSTL常用的核心标签，本篇介绍JSTL自定义标签的使用。还记得在学js的时候，我们学习了JQuery框架，同时学习了构造自己的js库，再去调用自己的js库，这就如同根据自己的需要些一个内聚性强的函数一样，我们创建一个函数后，再去调用这个函数。在学习J2ee规范JSTL标签这一节的时候，同样我们可以根据自己的需要构造自己的标签库，再去使用自己定义的这个标签。

JSTL自带的标签功能时非常强大的，但是不能完全满足我们的需要，开发标签首先是需要开发标签对应的功能类，就和写函数一样，这个函数是什么功能的呢？其次，编写描述标签的tld，并把这个文件放到web-inf/目录下，才能在jsp页面上调用自定义的标签。

自定义标签示例：

我们编写自定义标签需要三个步骤：

技术分享

1、标签的功能处理程序

java源代码：

package taglibs;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.Tag;
public class DateTag implements Tag {
private PageContext pageContext;
private Tag tag;
/**
* 标签初始化功能。
*/
public int doEndTag() throws JspException {
try
{
//定义日期。
Date date = new Date();
//日期格式
SimpleDateFormat dateFormater = new SimpleDateFormat("yyyy年MM月dd日");
pageContext.getOut().print(dateFormater.format(date));
}catch(IOException e)
{
e.printStackTrace();
}
return Tag.EVAL_PAGE;
}
/**
* 标签开始
*/
public int doStartTag() throws JspException {
return Tag.SKIP_BODY;
}
public Tag getParent() {
return null;
}
public void release() {
}
public void setPageContext(PageContext arg0) {
this.pageContext = arg0;
}
public void setParent(Tag arg0) {
this.tag = arg0;
}
}

上述程序段说明：

我们自己定义的DateTag标签实现了Tag接口，如果需要处理正文的内容，即需要处理开始标签和结束标签之间的内容的时候，需要实现BodyTag接口，我们在这里不需要处理正文内容，所以选择实现Tag接口即可。

因为这里要实现的标签不对正文内容处理，所以只需要实现doEndTag方法即可，在这个方法中取出当前系统时间，并指定格式输出。

2 、标签描述文件tld文件

标签处理功能开发完成之后，需要对标签库进行配置，也就是配置对标签功能实现类的引用，JSP引擎会根据页面中的标签引用找到对应的标签配置文件，然后根据配置文件找到实现标签功能的java类，从而调用其中的功能。

在eclipse中选择新建文件，选择新建tld类型的文件，会有如下如所示：

技术分享

其中包括我们.tld文件名 Name：datetag，文件的版本号 version：1.2，标签库的版本 Tlibversion：1.0，标签库要求的JSP版本为1.2，理解标签库描述性名字ShortName，URI唯一标识该标签库的URI为/mytags。我们代码如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>dateTagExample</short-name>
<uri>/mytags</uri>
<tag>
<name>date</name>
<tag-class>taglibs.DateTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>