利用 Geronimo 深入 EJB Web 应用程序

　　然后，按照 Wiki上的指令从源代码编译 Geronimo。成功构建之后，Geronimo 工件将位于本地资源库。它们是构建示例应用程序所必需的。编译完 Geronimo 之后，查找 geronimo-deployment-plugin-1.0-SNAPSHOT.jar 文件，并将其安装到 $MAVEN_HOME/plugins 目录中，否则可能会看到如下消息:

Tag library requested that is not present: 'geronimo:deploy' in plugin: 'null'

　　安装 XDoclet 1.2.3

　　最后，需要将 XDoclet 1.2.3 安装到 Maven 资源库中。如果试图构建示例应用程序，会显示一条 Maven 消息，指明它无法找到一些其他的 XDoclet 1.2.3 工件，这时您可能需要下载 XDoclet 1.2.3(lib 包)，并将 .jar 文件解压到位于 .maven/repository/xdoclet/jars 的本地 Maven 资源库中。如果您是 Windows 用户，应该在 C:\Documents and Settings\username 目录下查找该 Maven 目录。如果您是 UNIX 用户，应该在主目录下查找该目录。还应该通过将 maven-xdoclet-plugin-1.2.3.jar 添加到 $MAVEN_HOME/plugins 目录来安装 XDoclet Maven 插件。

　　成功构建

　　具备这些先决条件之后，构建过程应该能够顺利进行。当然，可以在进行上述工作之前尝试构建，查看 Maven 找不到哪些文件，然后只安装这些文件。可以尝试在示例应用程序的顶层目录中运行 Maven。首先，许多工件将被下载，最后，您将看到 BUILD SUCCESSFUL 消息。

　　要更多了解 Maven 做什么，研究一下 maven.xml 和 project.properties 文件。Maven 是面向目标的。它读取 maven.xml 并尝试满足顶层项目元素的默认属性中指定的所有目标。在本例中，它尝试满足部署目标指明为先决条件的所有事项;也就是说，它将尝试构建 .ear 文件，然后尝试停止和启动应用程序。应用程序的部署是通过上述的 Geronimo Deployment Maven 插件执行的。当然，Geronimo 服务器应该运行 —— 否则构建将失败，并显示如下消息:

Failed to retrieve RMIServer stub: javax.naming.ServiceUnavailableException
[Root exception is java.rmi.ConnectException: Connection refused to
host: 10.0.0.7; nested exception is:
        java.net.ConnectException: Connection refused: connect]

　　如果收到该消息，使用如下命令启动 Geronimo 服务器:

E:\geronimo-snapshot>java -jar bin\server.jar org/apache/geronimo/
DebugConsole org/apache/geronimo/RuntimeDeployer

　　该命令告诉 Geronimo 启动其服务器、DebugConsole 应用程序配置和 RuntimeDeployer 配置。

　　调试控制台

　　DebugConsole(参见 图 1)是可选组件，允许通过一个小 Web 应用程序(参阅 http://localhost:8080/debug-tool)查看 Geronimo 服务器中在运行什么。

　　图 1. Geronimo DebugConsole

　示例顶层页面

　　构建完示例应用程序之后，可以访问它的顶层页面，您将看到如 图 2 所示的内容。

　　图 2. 使用 Struts 1.2.7 构建的 Geronimo Phonebook 示例应用程序

　　完成应用程序构建之后:底层内容

　　既然已经成功构建了应用程序，而且看到了使用 Maven 的强大功能和简单性，现在该学习使它完全运行所必需的文件布局和部分代码。首先介绍 Web 应用程序层，然后介绍 EJB 层。最后将查看结缔组织 —— 连接所有组件并让它完全工作的部署计划和配置文件。参考 图 3 所示的文件目录树，以便找到这些文件。

　　图 3. 示例应用程序文件的目录布局

Web 应用程序层

　　Web 应用程序是用 JSP 和 Struts 1.2.7 框架编写的。在 src/webapp 目录中将会找到组成示例应用程序 Web 接口的文件。

　　该应用程序由两个主要视图组成:电话号码列表和电话号码编辑屏幕。从数据库中编辑简单记录必需的所有特性(添加、删除、编辑、更新和列表)都存在。src/java/org/acme/phonebook/struts 目录包含大量 Struts 动作来执行这些必需功能，比如创建新条目，删除条目，列出所有条目，编辑现有条目。

　　Struts Tiles 模板系统用于确保花费在让 Web 应用程序外观正常上的工作最少。webapp/pages 目录中的 site-template.jsp 文件定义应用程序的外观。

　　接下来介绍的两个主要 JSP 是 EditPhoneNumberPage.jsp 和 ListPhoneNumbersPage.jsp。其中每个页面及其在应用程序中的功能在 清单 1 中说明。

　　清单 1. EditPhoneNumberPage.jsp

<%@ page language="java"%>
<%@ taglib uri="/tags/struts-bean" prefix="bean"%>
<%@ taglib uri="/tags/struts-html" prefix="html"%>
<%@ taglib uri="/tags/struts-tiles" prefix="tiles"%>
<tiles:insert page="/pages/site-template.jsp" flush="true">
       <tiles:put name="content" type="string">

<hr>
<h1><bean:message key="h1.EditPhoneNumberPage" /></h1>
<hr>

<h2><bean:write name="phoneBookEntryForm" property="action"/>
</h2>

<html:form action="/pages/SaveEntry.do">
<table>
  <tr>
  <td>
<bean:message key="prompt.EditPhoneNumberPage.name" />
  </td>
  <td>
<html:text property="name" size="40" />
  </td>
  </tr>
  <tr>
  <td>
<bean:message key="prompt.EditPhoneNumberPage.phoneNumber" />
  </td>
  <td>
<html:text property="phoneNumber" size="40" /></td>
  </tr>
  <html:hidden property="action" />
  <html:hidden property="pk" />
  <tr>
  <td></td>
  <td>
<html:submit>
<bean:message key="button.submit" />
</html:submit> <html:reset>
<bean:message key="button.reset" />
</html:reset>
  </td>
  </tr>
  </table>
  </html:form>
  </tiles:put>
</tiles:insert>

在 清单 1 中，前几行设置将在页面中处于活动状态的标记库。它们还将站点模板的内容区域设置为内容将显示的位置。本例展示了一个简单的基于 Struts 的输入屏幕，它用一些 标记来显示资源库文件(位于 webapp/WEB-INF/classes/resources/application.properties)中的字符串。屏幕将名称和电话号码提交给名为 SaveEntry.do 的 Struts 动作。