自定义标签taglib

JSP 最佳实践: taglib简介

实现一个标记：<site-utils:lastModified />

1.实现行为
创建一个时间戳标记

package com.newInstance.site.tags;
import java.io.File;
import java.io.IOException;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Date;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.jsp.tagext.TagSupport;
public class LastModifiedTag extends TagSupport {
    public int doEndTag() {
      try {
        HttpServletRequest request =
(HttpServletRequest)pageContext.getRequest();
        String path = pageContext.getServletContext().getRealPath(
          request.getServletPath());
        File file = new File(path);
        DateFormat formatter = DateFormat.getDateInstance(
          DateFormat.LONG);
        pageContext.getOut().println(
          formatter.format(new Date(file.lastModified())));
      } catch (IOException ignored) { }
      return EVAL_PAGE;
    }
}

该标记返回的 EVAL_PAGE . EVAL_PAGE 是一个预定义的整型常量，它指示容器处理页面的剩下部分。另一种选项就是使用 SKIP_PAGE ，它将中止对页面剩下部分的处理。如果您要将控制转移到另一个页面，例如您要前进（forward）或者重定向（redirect）用户，那么只需要使用 SKIP_PAGE 。剩下来的细节都是与时间戳自身有关的事情。
接下来，编译这个类，并将 LastModifiedTag.class 文件放到一个WEB-INF/classes 目录下，注意要放到正确的路径层次结构中。这个路径应该匹配该标记的包名，包名中的圆点（.）用斜杠（/）代替。在本例中，目录的路径是基路径（WEB-INF/classes）再加上层次结构com/newInstance/site/tags。如果有一个名为 foo.bar.tag.MyTag 的标记，那么它将被放在 WEB-INF/classes/foo/bar/tag中。这种路径层次结构确保了Web容器在任何需要装载该标记的时候都能够找到这个类。


2.创建TLD
创建一个 标记库描述符（tag library descriptor ，TLD）文件.

<?xml version="1.0" encoding="ISO-8859-1"?>
<!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>site-utils</short-name>
    <uri>http://www.newInstance.com/taglibs/site-utils</uri>
    <tag>
      <name>lastModified</name>
      <tag-class>com.newInstance.site.tags.LastModifiedTag</tag-class>
      <body-content>empty</body-content>
    </tag>
</taglib>

保存这个文件，并将其放到WEB-INF/tlds目录下（您可能需要在您的容器中创建这个目录）。我将这个文件保存为site-utils.tld，并在该标记库的URI（推荐的前缀）和TLD文件本身之间再次创建一个干净的链接。对于这个特定的标记库，要使其可以使用，最后一步要做的是让您的Web应用知道如何连接一个JSP页面中的URI，如何请求使用一个标记库。这可以通过应用的web.xml文件来做。

3.web.xml加入<jsp-config>

<web-app id="WebApp_ID" version="2.4" 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 http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
                ...
	<jsp-config>
	   <taglib>
	       <taglib-uri>/myjstl</taglib-uri>
	       <taglib-location>/WEB-INF/tld/c.tld</taglib-location>
	   </taglib>
	</jsp-config>
                ...
</web-app>

4.使用新的标记库

<%@ taglib prefix="site-utils" uri="http://www.newInstance.com/taglibs/site-utils" %>
其实是：

<%@ taglib prefix="site-utils" uri="/myjstl" %>
          </td>
          <td width="16" align="left" valign="top"> </td>
    </tr>
    <!-- End main content -->
<!-- Begin footer section -->
    <tr>
      <td width="91" align="left" valign="top" bgcolor="#330066"> </td>
      <td align="left" valign="top"> </td>
      <td class="footer" align="left" valign="top"><div align="center"><br>
        &copy; 2003 
        <a href="mailto:[e-mail]">Brett McLaughlin</a><br>
        Last Updated: <site-utils:lastModified />
        </div></td>
      <td align="left" valign="top"> </td>
      <td width="141" align="right" valign="top" bgcolor="#330066"> </td>
    </tr>
</table>
<!-- End footer section -->

参考：

1.http://www.ibm.com/developerworks/cn/java/j-jsp07233/

2.http://ericliu1986.iteye.com/blog/686378