上篇讲解的是JSTL常用的核心标签,本篇介绍JSTL自定义标签的使用。还记得在学js的时候,我们学习了JQuery框架,同时学习了构造自己的js库,再去调用自己的js库,这就如同根据自己的需要些一个内聚性强的函数一样,我们创建一个函数后,再去调用这个函数。在学习J2ee规范JSTL标签这一节的时候,同样我们可以根据自己的需要构造自己的标签库,再去使用自己定义的这个标签。
JSTL自带的标签功能时非常强大的,但是不能完全满足我们的需要,开发标签首先是需要开发标签对应的功能类,就和写函数一样,这个函数是什么功能的呢?其次,编写描述标签的tld,并把这个文件放到web-inf/目录下,才能在jsp页面上调用自定义的标签。
自定义标签示例:
我们编写自定义标签需要三个步骤:
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方法即可,在这个方法中取出当前系统时间,并指定格式输出。
标签处理功能开发完成之后,需要对标签库进行配置,也就是配置对标签功能实现类的引用,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>
<tag></tag> 描述了标签库中的一个标签,其中标签的名字是date,也就是在JSP页面上访问的名字为date;这个标签的功能处理类为taglibs.DateTag,<body-content></body-content>表明这个标签没有正文内容,即在开始标签和结束标签不能包含其他内容。
在一个标签库中,可以包括一组标签,也可以只描述一个标签,一般情况下,都是把一组功能类似标签放置在一个标签库中,可以包括一组标签也可以只描述一个标签,一般情况下都是一组功能类似的标签放置在一个标签库中,用一个描述文件,只要增加<tag></tag>节点就可以了。
首先把这个描述文件. tld 放到web-inf文件夹下,然后在JSP页面中使用这个标签库:
<%@ taglib uri="/web-inf/datetag.tld" prefix="mytags" %>
代码如下所示:
<%@ page language="java" import="java.util.*" pageEncoding="GB18030"%> <%@ taglib uri="/WEB-INF/datetag.tld" prefix="mytags" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> 自定义标签示例<br> </head> <body> <font size="3"> 使用自定义标签输出日期: <mytags:date/> </font> </body> </html>
调用结果显示图:
如下图所示:
这样终于理解了JSTL,就是把JSP页面上嵌入的java代码穿上一层外衣,但这个“外衣”不用进行编译就可以直接在浏览器上运行,更加接近于界面制作显示的要求,原来J2EE的这个JSTL规范是在解耦,如此让系统的扩展性和可维护性更强了。