欢迎阅读本期的 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”指定该变量是在标记文件结束设置的。