JSTL自定义标签(三)

 

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

 

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

 

       自定义标签示例:

 

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

 

 

JSTL自定义标签(三)_第1张图片

 

 

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类型的文件,会有如下如所示:

JSTL自定义标签(三)_第2张图片

 

 

       其中包括我们.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>节点就可以了。

 

3、在JSP中调用这个标签

 

 

       首先把这个描述文件. 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>


 

       调用结果显示图:

 

 

 

4、JSP页面不使用标签和使用标签的执行过程

       如下图所示:

 

JSTL自定义标签(三)_第3张图片

 

 

 


        这样终于理解了JSTL,就是把JSP页面上嵌入的java代码穿上一层外衣,但这个“外衣”不用进行编译就可以直接在浏览器上运行,更加接近于界面制作显示的要求,原来J2EE的这个JSTL规范是在解耦,如此让系统的扩展性和可维护性更强了。

 

 

 

 

 

 

你可能感兴趣的:(JSTL自定义标签(三))