jsp自定义标签（一）

本教程目的

想要在 JavaServer Pages （JSP） 应用程序中添加自定义标签吗？本教程将为您展示如何用这些标签编写类似于 JSP 技术自带操作 —— 如 jsp:useBean、jsp:getProperty 和 jsp:forward —— 的自定义操作。介绍如何用特定于自已的域的表示逻辑的自定义操作来扩展 JSP 语法。

在 JSP 应用程序中添加 自定义标签 的能力可以使您将工作重点放到以文档为中心的开发方式上。可以使 Java 代码不出现在 JSP 页中，从而使这些页面更容易维护。（我从经验中学到，在 JSP 页中放入过多的 Java 代码时，代码维护就会成为可怕的任务）。本教程将使您可以立即开发出自定义标签。了解了 JSP 自定义标签开发的好处后，您可能会对程序员没有更多地使用它而感到意外。

在本教程中，我将讨论使用自定义标签的基本内容。将介绍如何用自定义标签创建可重用的表示组件并避免在 JSP 页加入 Java scriptlet。

在本教程中，我们将：

• 定义一个 JSP 自定义标签体系结构。
• 解释简单标签。
• 定义嵌套标签。
• 用 BodyContent 解释标签。
• 在标签中添加属性。
• 在标签中添加 scriptlet 变量。
• 用自定义标签实现控制流程。
• 用 Struts 简化标签部署。

我要学习本教程吗？

如果发现自己在 JSP 应用程序中加入了大量 Java scriptlet，那么本教程就是为您准备的。 阅读本教程后，就会掌握将 Java 代码从 JSP 页面中清除出去所需要的信息。

本教程假定读者熟悉 Java 平台、JavaServer Pages （JSP） 技术、MVC 模式、Reflection API、Model 2，最好还有 Struts 框架。此外，要从本教程中得到最大的收获，还需要很好的使用标签库的经验

关于作者

Rick Hightower 是一位 J2EE 开发人员和顾问，他热衷于使用 J2EE、Ant、Hibernate、Struts、IMB 的 ETTK 和 Xdoclet。 Rick 是 Trivera Technologies 的前任 CTO，这是一家全球培训、指导和咨询公司，其重点是企业开发。他经常在 IBM developerWorks 上发表文章，并编写了 10 多篇 developerWorks 教程，内容从 EJB 技术到 Web 服务到 XDoclet。 Rick 不久前与别人共同开办了另一家名为 ArcMind 的公司，它专门研究 agile 方法，还从事 Struts/JavaServer Faces 开发、咨询和指导。

在为 eBlox 工作时，Rick 和 eBlox 小组远在 1.0 版本之前就已使用 Struts 为电子商务站点构建了两个框架和一个 ASP （应用程序服务提供者）。这个框架目前正在为 2000 多个在线商店店面提供支持。

Rick 最近完成了一本名为 Professional Jakarta Struts 的书。在周游全国对 J2EE 和 Struts 项目提供咨询，或者在大会上发表关于 J2EE 和极端编程 （extreme programing）的讲演之余，Rick 喜欢在通宵咖啡店喝咖啡，写一些有关 Struts、J2EE 和其他内容的文章，并以第三人称描写他自己。

标签处理程序

在创建自定义标签之前，需要创建一个 标签处理程序。标签处理程序是一个执行自定义标签操作的 Java 对象。在使用自定义标签时，要导入一个 标签库 —— 即一组标签/标签处理程序对。通过在 Web 部署描述符中声明库导入它，然后用指令 taglib 将它导入 JSP 页。

如果 JSP 容器在转换时遇到了自定义标签，那么它就检查 标签库描述符（tag library descriptor） （TLD） 文件以查询相应的标签处理程序。TLD 文件对于自定义标签处理程序，就像 Web 部署描述符对于 servlet 一样。

在运行时，JSP 页生成的 servlet 得到对应于这一页面所使用的标签的标签处理程序的一个实例。生成的 servlet 用传递给它的属性初始化标签处理程序。

标签处理程序实现了 生存周期 方法。生成的 servlet 用这些方法通知标签处理程序应当启动、停止或者重复自定义标签操作。生成的 servlet 调用这些生存周期方法执行标签的功能。

标签的类型

可以定义两种类型的标签：

• javax.servlet.jsp.tagext.Tag
• javax.servlet.jsp.tagext.BodyTag

对 正文 进行操作 —— 即对在开始和结束标签之间的内容进行操作的 —— 标签必须实现 BodyTag 接口。在这个教程中，我们将称这些标签为 正文标签。我们将不对其正文操作的标签称为 简单标签。简单标签可以实现 Tag 接口，尽管不要求它们这样做。要记住不对其正文操作的标签仍然 有 正文，只不过，它的标签处理程序不能读取这个正文。

简单标签的例子

Struts 框架带有几个自定义标签库（有关 Struts 的更多信息的链接请参阅 参考资料 ）。这些库中的一个标签可以创建一个支持改写 URL 的链接并用 jsessionid 对改写的连接编码。

不过有一个问题：如果希望传递一组请求参数（如查询字符串），也许必须为此创建一个 Java scriptlet。真是乱！下面的清单 （search_results.jap） 展示了一个 JSP 页，它被迫加入了这样一个 scriptlet。

 <%@ taglib uri="struts-html" prefix="html" %> <jsp:usebean id="deleteParams" class="java.util.HashMap"> <% deleteParams.put("id", cd.getId()); deleteParams.put("method","delete"); %> <!----> <html:link name="deleteParams" action="/deleteCD">delete </html:link> </jsp:usebean>  

search_results.jsp 创建一个 hashmap 并向这个 map 传递两个属性。在下面几小节，我们将创建一个不用 Java 代码完成这项工作的自定义标签。我们的标签将定义如下的一个 hashmap：

 <map:mapdefine id="deleteParams"> <map:mapentry property="id" name="cd" id="id"> <map:mapentry value="delete" id="method"> </map:mapentry> <!----> <html:link name="deleteParams" action="/deleteCD">delete </html:link> </map:mapentry></map:mapdefine>  

这将使我们可以容易地创建小型 map。

这个例子将展示几个关键概念，包括使用嵌套标签和定义 scriplet 变量。首先我将解释这个标签是如何工作的。然后在以后的几节中建立这些概念，并介绍如何编写这个标签的不同形式，使它们处理其正文并控制执行流程。