企业Java技术开发技巧2则

欢迎阅读本期的 Enterprise Java Technologies Tech Tips。下面你将获得使用企业 Java 技术和 API 的技巧，如 Java 2 Platform 和 Enterprise Edition (J2EE) 中的 Java 技术和技巧。

本文讨论：

自定义标记文件
和 JSP Pages 一同使用 Enterprise Beans
这些技巧是使用 Java 2, Enterprise Edition, v 1.4 SDK 开发的。您可以下载 SDK，网址为 http://java.sun.com/j2ee/1.4/download-dr.html。

Tech Tips 中的问题由 Mark Johnson 编写，他是 elucify technical communications 的总裁 ，也是 Designing Enterprise Applications with the J2EE Platform, 2nd Edition 的作者之一。Mark Johnson 主管一个开放论坛讨论这些技巧。

您可以下载这些技巧的示例存档。应用程序的上下文根是 ttfeb2004，index.html 欢迎文件指出如何使用该示例代码。使用下面的代码和/或信息的应遵守许可条款。

自定义标记文件
JSP 页中的自定义标记看上去像 HTML 标记。而自定义标记在运行时会替换为文本，这些文本是由一个与该标记相关联的处理程序类输出的。上一个 Enterprise Tech Tip Using Custom Tag 说明了如何创建一个这样的类。本月的第一技巧将介绍一个新的更容易的方法来实现自定义标记。

在 JSP 2.0 之前，创建自定义标记的惟一方法是将其作为 Java 标记处理程序类来实现。处理程序类开发人员还需要创建一个 TLD 文件，该文件负责为 web 容器描述标记。尽管自定义标记很强大，它也需要编程技巧和深入了解 JSP 页是如何翻译成 HTML 的。

JSP 2.0 标记文件的新特点能够让非编程人员编写可重用的标记。同时也使编程人员的编程生活变得轻松自如。JSP 2.0 语法与 JavaServer Pages Standard Tag Library （JSTL）及其表达式语言（EL）一起使用，不用书写任何 Java 代码就能创建自定义标记。

标记文件是 JSP 页的可重复使用组件。它有诸多优点：

可用来隐藏或删除 scriptlet。
通过引用而不是通过剪切和粘贴来提高代码的重用性。
可使 JSP 页更易书写、视觉更加一致且更易于维护。
可由非编程人员书写。
其语法比 Java 更接近于 HTML，所以 JSP 页看上去更像是用一种语言书写而成的。
可组成高级组件以提高工作效率和开发速度。
自定义标记所使用的 TLD 文件通常可自动生成。
可用来重构现有页。代码的公共部分可以合并到一个标记文件，该文件可在应用程序视图之间共享。
标记文件并不完全替代自定义标记句柄类。当对有相关布局和表示的可复用内容进行封装时，标记文件更为可取。而在 JSP 页中重复使用应用程序逻辑（application logic）时，自定义标记要更胜一筹。例如，页眉和页脚是标记文件的拿手好戏。相比之下，JSTL 中的自定义标记是作为 Java 语言处理程序类实现的。

标记文件细节

实际上，标记文件会被翻译和编译成标记句柄类。标记处理程序和标记处理程序类之间的惟一区别是：标记处理程序是用 JSP 语法写的，而标记处理程序类是用 Java 语言写的。

JSP 2.0 兼容的容器在 Web 存档路径 WEB-INF/tags 中查找标记文件。标记文件也可在 WEB-INF/lib 下打包成 JAR 文件。当 Web 容器为 JSP 页提供服务时，每当该容器遇到与标记文件相关的标记时，该标记文件中 JSP 内容的输出都将被分析并包含在响应流中。 标记文件可定义属性，并可完全访问 JSP 2.0 的表达式语言（EL）。标记文件也可创建在其执行完毕后仍能继续存在的 EL 变量。

标记文件用属性指令声明其属性。下面是选自本技巧所附带的示例代码中的一个例子。标记文件以一个属性指令开始：

<%@ attribute name="format" required="false" %>


本标记（用于格式化日期）用这行代码告诉容器预计出现一个可能的“format”属性。指令中的“required”属性为强制属性设置为“true”。这些指令允许 web 容器在部署时生成自己的 TLD 文件。

标记通过其属性接受输入。除标记文件生成的输出文本外，标记也可以通过创建 EL 变量“输出”数据。标记文件可以将一个值返回到调用它的页面，如下所示：

<%@ variable name-given="filesincluded" scope="AT_END" %>


“name-given”可为标记完成后将要在页面中设置的变量提供名称。“AT_END”指定该变量是在标记文件结束设置的。

标记文件示例

本技巧中的示例代码包括一个标记文件，该文件重新实现了为 2002 年 9 月的 Tech Tip“Using Custom Tags”而开发的自定义标记。原始标记可用三种方法对服务器的日期进行格式化：

如果格式未设置或为空，则标记用默认格式显示日期。
如果格式参数以美元符号开头，则标记使用该字符串的其余部分作为一个环境项的名称。然后标记查找这个已命名的环境项并将它的值作为格式。
如果“format”参数包含一个格式字符串（与 java.text.SimpleDateFormat 兼容），那么该字符串就用来格式化日期。
标记文件指定的标记功能略有不同。如果格式参数以一个美元符号开头，则标记查找一个 servlet 上下文初始化参数，而不是查找一个环境项。（表达式语言 JSTL 1.0 并不为访问环境项提供内在的支持。）

本示例标记文件 date.tag 以用于定义该文件中预期属性的指令开始。它也为该标记使用到的其他标记库指定了命名空间。

<%@ attribute name="format" required="false" %>

<%@ taglib uri=

"http://java.sun.com/jsp/jstl/core" prefix="c" %>

<%@ taglib uri=

"http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>

<%@ taglib uri=

"http://java.sun.com/jsp/jstl/functions"

prefix="fn" %>


日期标记文件的下一代码块使用 <c:choose> 标记确定该格式字符串。<c:choose> 是 JSP 页中实现 if/then/else 功能所选用的标记。如果格式未设置或为空，则第一个“when”语句会将 EL 变量“format”设置为默认值。代码如下：

<c:choose>

<%-- If format is blank, set default --%>

<c:when test="${format == null or format == ''}">

<c:set var="format"

value="EEEE, d MMMM yyyy 'at' kk:mm:ss z"/>

</c:when>

...


如果“format”非空，那么它将以一个“$”或不以一个“$”开头。在前一种情况下，<choose> 标记的 <otherwise> 语句将去掉打头的“$”，并用有给定名称的上下文参数的内容替代“format”变量。

<c:otherwise>

<%-- Else if format starts with "$",

look up in context param,

and set "format" to its value. --%>

<c:if test="${fn:substring(format,0,1) == '$'}">

<c:set var="format_name"

value="${fn:substringAfter(format,'$')}"/>

<c:set var="format"

value="${initParam[format_name]}"/>

</c:if>



<%-- Otherwise leave it as it is --%>

</c:otherwise>

</c:choose>


注释中指出，如果“format”不以一个“$”开头，它的值保持不变。

至此，EL 变量“format”的值被赋给一个字符串，该字符串将用来格式化日期。 useBean 代码行创建了一个指示当前时间的 Date 对象。fmt:formatDate 方法用给定的“format”格式化该日期：

<%-- Now actually create and format the date --%>

<jsp:useBean id="now" class="java.util.Date"/>

<fmt:formatDate value="${now}" pattern="${format}"/>


至此就完成了标记文件。

使用标记文件更容易。示例页 DatePage.jsp（可链接到本月示例存档中 index.jsp 之外）顶部的一个指令说明存档目录（/WEB-INF/tags）下的所有标记都可以使用“mytags”前缀来访问。该指令如下：

<%@ taglib tagdir="/WEB-INF/tags" prefix="mytags" %>


现在，就可以很简单的使用 JSP 标记文件了，就好像是在使用任何的自定义标记一样。下面代码节选自示例页 DatePage.jsp：

默认格式下的服务器时间和日期

are <b><mytags:date/></b>.<br>

服务器的时区是

<b><mytags:date format="zzzz"/></b>.<br>

服务器日期是

<b><mytags:date format="M/d/yyyy"/></b>.<br>

服务器时间是

<b><mytags:date format=&qu