利用 Geronimo 深入 EJB Web 应用程序

　　该应用程序中有两个 EJB 类。第一个类使用容器管理持久性(Container-Managed Persistence，CMP)来提供对简单数据库表 PhoneBookEntryBean 的基于对象的访问。第二个类是一个 Stateless Session bean，它提供业务逻辑。通常需要通过无状态会话 bean 来操作 CMP bean，因为会话 bean 可被设置来提供对数据库的事务处理，从而在发生错误时可以回滚更新。此外，在 Session bean 中执行所有 CMP 操作使得 Web 应用程序无需知道数据库访问层的任何实现细节。所以如果用另一种技术替换该层(比如使用 Hibernate 持久层)，将无需更改 Web 应用程序中的代码。

　　XDoclet 主要用在 EJB 层中以提供部署描述符生成。这对于减少构建此类应用程序所需的维护工作是十分重要的。下载源代码并查看 PhoneBookEntryBean.java 和 PhoneBookSessionBean.java 的类 Javadoc 注释，以了解用于定义 EJB 类的大量 XDoclet 标记。

　　要生成无状态会话 bean 的方法，添加名为 @ejb.interface-method 的 XDoclet 标记，其视图类型属性可以为 local、remote 或 both。该属性告诉 XDoclet 在会话 bean 的本地接口、远程接口或两种接口中生成相应方法。您还可以控制事务处理类型。参见 清单 5，它是其中一个接口方法的示例，列出电话簿条目并返回它们的值对象表示。

　　清单 5. PhoneBookSessionBean.java 类的 listEntries() 方法

/**
 * List all of the phone book entries.
 * @return a collection of PhoneBookEntryValue objects.
 *
 * @ejb.interface-method view-type="both"
 * @ejb.transaction      type="Required"
 */
public java.util.Collection listEntries() {
  ArrayList values = new ArrayList();
  try {
      Collection entries = PhoneBookEntryUtil.getLocalHome().findAll();
      Iterator i = entries.iterator();
      while(i.hasNext()) {
            PhoneBookEntryLocal entry = (PhoneBookEntryLocal)i.next();
            values.add(entry.getPhoneBookEntryValue());
      }
  } catch (Throwable ex) {
      ex.printStackTrace();
  }
  return values;
}

　　结缔组织

　　在我的文章“将数据库连接到 Geronimo 应用服务器的三种方法”(developerWorks，2005 年 6 月)中详细介绍了 Geronimo 的各种部署计划的重要性。让这么小的应用程序到达功能状态是非常有挑战性的，需要在部署计划中提供许多小选项，还有 XDoclet 标记之间的交互、标记生成的代码，以及部署计划。但是详细介绍这些内容超出了本文的范围。示例程序有许多配置文件和部署计划，几乎所有的这些东西都能在项目的 src/resources 子树中找到。下文简要介绍了这些文件的相关细节，以说明需要进行哪些修改才能让将来的应用程序工作。

　　ear 子目录包含企业应用程序部署描述符、application.xml 文件和 geronimo-application.xml 文件。在该应用程序中，这些文件被配置以提供应用程序范围的 Java 数据库连接 (Java Database Connectivity, JDBC) 连接器。

　geronimo-application.xml 文件包含 元素，它具有名为 configId 的属性。该元素对于 Maven 构建脚本的自动部署特性的正确运行是十分关键的。所设置的值可用于 maven.xml 文件中任何 的 id 属性中，如 清单 6 所示。

　　清单 6. maven.xml 启动目标

<goal name="start">
 <deploy:distribute
   uri="deployer:geronimo:jmx:rmi://localhost/jndi/rmi:/JMXConnector"
   username="system"
   password="manager"
   home="${basedir}"
   module="target/${pom.artifactId}.ear"
 />
 <deploy:start
   uri="deployer:geronimo:jmx:rmi://localhost/jndi/rmi:/JMXConnector"
   username="system"
   password="manager"
   id="org/acme/PhoneBook"/>
 </goal>

　　在 清单 6 中，因为 geronimo-application.xml 文件中的 configId 属性被设置为 org/acme/PhoneBook，所以它还必须是自动部署语句中 id 属性的值。Geronimo 团队为此设置了一个非常好的自动部署工具。但是，如果您经常自动部署，请确保检查您的临时目录，因为它们可能装满了旧的部署文件。

　　资源目录中子目录列表中的下一个目录是 ejb 目录。openejb-jar.xml 部署描述符在 META-INF 子目录中。该文件对于数据库和实体 (CMP) bean 之间的所有连接是必不可少的。还必须对该文件进行小修改，以确保对于您的企业 bean 存在相应的 Java 命名和目录接口 (Java Naming and Directory Interface, JNDI) 名称。该文件如 清单 7 所示。

　　清单 7. openejb-jar.xml

<?xml version="1.0"?>
<openejb-jar
    xmlns="http://www.openejb.org/xml/ns/openejb-jar"
    configId="org/acme/PhonebookEJB"
    parentId="MysqlDatabase">
    <cmp-connection-factory>
      <resource-link>MysqlDataSource</resource-link>
    </cmp-connection-factory>
    <enterprise-beans>
        <entity>
            <ejb-name>PhoneBookEntry</ejb-name>
            <local-jndi-name>
java:comp/env/ejb/PhoneBookEntryLocal
</local-jndi-name>
            <table-name>phone</table-name>
            <cmp-field-mapping>
                <cmp-field-name>name</cmp-field-name>
                <table-column>name</table-column>
            </cmp-field-mapping>
            <cmp-field-mapping>
                <cmp-field-name>phoneNumber</cmp-field-name>
                <table-column>phone</table-column>
            </cmp-field-mapping>
        </entity>

        <session>
            <ejb-name>PhoneBookSession</ejb-name>
            <local-jndi-name>
                  java:comp/env/ejb/PhoneBookSessionLocal
            </local-jndi-name>
        </session>
    </enterprise-beans>
</openejb-jar>

 清单 7 最重要的元素是 <cmp-connection-factory> 及其 <resource-link> 子元素。<resource-link> 元素内的名称必须与 JDBC 连接器配置的名称相匹配，如下列代码段所示：