JSP自定义标签简明指导手册

一、步骤及目录结构

1、编写标签处理类

2、编写*.tld文件，放置于WEB-INF目录或子目录下

3、在JSP页面中使用

目录结构如下：

二、示例程序

1、日期时间处理标签

1）编写java类，命名为DataTimeTag.java

 

/**

 * copyright reserved,zhangym 2008

 */

package org.zym.tags;



import java.io.IOException;

import java.text.ParseException;

import java.text.SimpleDateFormat;

import java.util.Date;

import javax.servlet.jsp.JspTagException;

import javax.servlet.jsp.JspWriter;

import javax.servlet.jsp.tagext.TagSupport;



/**

 * 通过给定的日期字符串,根据指定的格式进行日期时间的格式化.


 * 


 * 
完全指定属性：<util:datetime date="1978-03-28 20:58:58 " pattern="yyyy年MM月dd日 hh:mm:ss"/>,输出结果为:yyyy年MM月dd日 hh:mm:ss

 * 
取系统时间：<util:datetime />,输出内容为:yyyy-MM-dd hh:mm:ss

 * 

 * @param pattern 格式化日期时间的字符串,如 "yyyy-MM-dd hh:mm:ss" .

 * @param dateString 时间字符串,为空则为系统当前时间

 * @return 按要求格式化的日期时间字符串

 * @author zhangym 


 */

public class DateTimeTag extends TagSupport {

    

    private static final long serialVersionUID = -2132806052574019882L;

    private String pattern = "yyyy-MM-dd hh:mm:ss";  //时间日期格式字符串

    private String dateStr;  //时间日期字符串属性

    private Date date;

    

    public void setPattern(String pattern) {

       this.pattern = pattern;

    }

    public void setDate(String dateStr) {

       this.dateStr = dateStr;

    }

    

    @Override

    public int doEndTag() throws JspTagException{

       SimpleDateFormat sdf = new SimpleDateFormat(pattern);

       SimpleDateFormat sdfi = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");

       

       if(dateStr == null){

           date = new Date();

       }else

       {

           try {

              date = sdfi.parse(dateStr);

           } catch (ParseException e) {

              e.printStackTrace();

           }

       }

       JspWriter out = pageContext.getOut();

       try {

           out.println(sdf.format(date));

       } catch (IOException e) {

           e.printStackTrace();

       }

       //继续计算页面

       return EVAL_PAGE;

    }

    

}

2)

编写.tld文件，命名为util.tld，放在目录WEB-INF下面的tlds文件夹下，其实名此文件的名称和在WEB-INF目录下的位置是任意的。

 

    A tag library SimpleTag handlers.

    1.0

    util

    /util/tags

     

           Outputs date time

         datetime

           org.zym.tags.DateTimeTag

           empty

           

           

              date

               false

              true

           

           

           

              pattern

              false

              false

           

           

    

    

 

3)

在页面中使用标签

需在页面中进行引用，此引用的信息是在tld文件中进行了规定的，如prefix=”util”和uri=”/util/tags”

 

指定时间：

---

当前日期：

---

当前时间：

---

三、标签类打包

在完成了标签类之后，交给网页开发人员进行使用时，我们应该尽量让其使用简单，并透明。打包需要两个步骤：

1）  整理文件并规划目录

a)         将项目目录下的WEB-INF目录下的classes下的包及编译好的标签类复制出来，放在一个临时目录下

 

b)         在临时目录下，创建一个META-INF目录，将util.tld文件复制到其下

2）  进入目录下，使用jar命令进行打包，命令如下：

F:/util/> jar -cvf util.jar *

解释：将此目录下的所有文件打包util.jar文件

四、自定义标签jar包使用

将其放于WEB-INF目录下的lib目录中，就可以了。跟使用JSP的其他标签一样，只要在JSP页面中正常引用就可以。