用五个容易的步骤实现 JSP 自定义标记（1）

look_w

您可能听说现在有上百种不同的方式，但是在开发 Web 应用程序时将表示逻辑与业务逻辑分离是很重要的。近年来，Java 平台已经发展为在体系结构层次上加入了这种分离。例如，在JSP 体系结构中加入 JavaBean 组件使开发人员使用 JSP 标记获得和设置经过特别编码的 Java 组件上的属性。这些组件或者 JavaBean再代表表示层执行后端业务处理。
JSP 自定义标记是 JSP/JavaBean 体系结构的产物。像 JavaBean 技术一样，自定义标记有助于将表示逻辑与业务逻辑分离。并且自定义标记成了Web 设计者的 HTML、XML 和 Javascript 世界与软件工程师的 Java 代码、SQL 调用和算法世界之间的桥梁。
在本月的                J2EE 探索者 中，您将学到在 JSP 页中使用 JSP 自定义标记的一些基本知识。我们首先介绍 JSP 标记，然后直接进入创建标记、将它结合到JSP 容器并在 JSP 页面中使用它的过程。在本文的最后，我们将简要讨论 Java 标准标记库（Java Standard Tag Library,JSTL），这是一组可以在您的 Java 开发项目中使用的、标准化的 JSP 自定义标记。            
JSP 自定义标记JSP 自定义标记是用户定义的标记，它遵循 JSP JavaBean 标记(即                 useBean 、                 getProperty 和                  setProperty )所使用的一种特殊的 XML 语法。当 servlet 容器处理自定义标记时，会调用一个或者多个Java 类文件处理它，与用 Java 类文件处理 JSP 页面的 JavaBean 调用的方式基本一样。处理标记以后，容器将取其名字和属性、以及标记正文中可能有的任何内容，并将它传递给一个或者多个类文件进行处理。            
Java 开发人员编写标记处理程序类以处理标记并处理所有需要的 Java 代码和数据操作。对于 Web 设计者来说，自定义标记与标准 HTML 标记除了都可以利用后端动态数据外，它们看上去与使用起来没什么区别。正确编写自定义标记可以让 Web 设计者创建、查询和操作数据而无需编写一行 Java 代码。正确使用自定义标记使Java 开发人员不必再在编码过程中考虑表示层。这样应用程序开发小组的每一位成员都可以关注于他或者她最擅长的事物。
实现 JSP 自定义标记JSP 体系结构需要以下组件以实现自定义标记：

• 在每一页中有一个 JSP 声明
• Web 应用程序描述符（web.xml）中的一个项
• 一个包含特殊 XML 文件和为处理自定义标记而调用的 Java 类的 JAR 文件

在下面几节，您将一步一步地学习如何满足这些要求并将自定义标记加入到 JSP 页面中。要想成功实现 JSP 自定义标记，您需要采取下面五个步骤：

• 编写标记处理程序类。
• 创建标记库描述符（TLD）。
• 使 TLD 文件和处理程序类可访问。
• 引用标记库。
• 在 JSP 页面中使用标记。

这些内容是相当基本的，也不用花很长时间。就让我们开始吧。
第 1 步. 编写标记处理程序类在下面的例子中，我们将使用一个非常简单的显示当前时间和日期的自定义标记例子。下面就是                 DateTag ：            

1	<abc:displayDate />

我们要做的第一件事是编写标记处理程序类。在执行引用自定义标记的 JSP 页面时，JSP 容器判断每一个自定义标记。当容器遇到一个标记时，它调用与这个自定义标记相关联的标记处理程序，我们将在后面更多地讨论这个过程。然后，每一个标记处理程序实现JSP API 中的一个特殊接口。标记有两种类型：可以处理标记内容（或者正文）的标记和不能处理标记内容的标记：

1 2 3 4

<abc:tagWithNoBody attribute="value"/>             <abc:tagWithBody attribute="value">     This is some body content that the tag handler can operate upon. </abc:tagWithBody>

在                 DateTag 例子中不需要加入正文内容，因为它只显示当前日期。因此，我们的处理程序类将实现                 Tag 接口（一般是通过扩展                 TagSupport 类）。如果我们要创建一个可以处理正文的标记，那么我们就需要实现                 BodyTag 接口（一般是通过扩展                 BodyTagSupport 类）。清单 1 显示了                 DateTag  的处理程序类：            
清单 1. 标记处理程序类

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

package myTags; import javax.servlet.jsp.tagext.*; import javax.servlet.jsp.*; import javax.servlet.http.*; import java.text.*; import java.util.*; public DateTag extends TagSupport {         public int doStartTag() throws javax.servlet.jsp.JspException {         HttpServletRequest  req;         Locale              locale;         HttpJspPage         g;         DateFormat          df;         String              date;         JSPWriter           out;                           req = ( HttpServletRequest )pageContext.getRequest();         locale = req.getLocale();         df = SimpleDateFormat.getDateInstance(                 SimpleDateFormat.FULL,locale );         date = df.format( new java.util.Date() );                           try {             out = pageContext.getOut();             out.print( date );         } catch( IOException ioe ) {             throw new JspException( "I/O Error : " + ioe.getMessage() );         }//end try/catch         return Tag.SKIP_BODY;     }//end doStartTag() }//end DateTag

关于这段代码的说明关于                 DateTag 处理程序类有几件事值得一说。首先看一下方法声明。如果我们直接实现                 Tag 接口，那么就需要完成几个方法声明。因为                 TagSupport 类是简单的、具体类，它完全实现了在                 Tag 接口中声明的方法，我们可以只实现那些在自定义标记中要使用的方法。在这个简单的例子中，我们只实现了                 doStartTag() 方法，它是在遇到开始标记时调用的。            
您还可能注意到                 doStartTag() 方法返回                 SKIP_BODY 。当然其原因是我们的简单日期标记没有正文。您要注意的最后一件重要的事情是使用了                 pageContext 对象访问输出缓存以直接向输出流发送内容。您可能还记得在本系列以前的文章说过，                 pageContext 对象是一个隐式对象，它提供对与当前页面有关的属性的访问。            
编写了源代码文件后，我们像编译所有其他 Java 类一样编译这个类（确保在类路径中加入 Servlet/JSP JAR 文件），然后将编译的类文件放到Web 应用程序的类目录（WEB-INF/classes）中。如果我们开发的是几个标记或者定义有标记变量的标记，那么我们就会有多个标记处理程序类。在这种情况下我们可能选择将处理程序类打包在一个JAR 文件中而不是使它们成为类目录中的分散的文件。