Apache Ant EJB 任务用户手册

作者

• Paul Austin ([email protected])
• Holger Engels ([email protected])
• Tim Fennell ([email protected])
• Martin Gee ([email protected])
• Conor MacNeill
• Cyrille Morvan ([email protected])
• Greg Nelson ([email protected])
• Rob van Oostrum ([email protected])

目录

• 简介
• EJB 任务

简介

Ant 提供了一些可选的任务来开发 1.x 和 2.x 企业 Java Bean (EJB)。通常这些任务特定于特定供应商的 EJB 服务器。

这些任务支持

• Borland 应用服务器 4.5
• iPlanet 应用服务器 6.0
• JBoss 2.1 及更高版本的 EJB 服务器
• Orion 应用服务器 2.0 (自 Ant 1.10.2 起)
• WebLogic 4.5.1 到 7.0 EJB 服务器
• JOnAS 2.4.x 和 2.5 开源 EJB 服务器
• IBM WebSphere 4.0

像 BEA 和 IBM 这样的供应商现在提供定制的 Ant 任务来与他们的特定产品一起工作。更重要的是，EJB 3.0 使整个过程过时。因此，这些任务的开发实际上已经冻结。欢迎错误报告，尤其是补丁，但没有迫切需要添加对新应用服务器的支持。没有人应该编写新的 EJB 2.x 应用程序，当然也不应该编写新的 EJB 2.x 服务器。

EJB 任务

ddcreator

描述

ddcreator 将编译一组 WebLogic 基于文本的部署描述符到一个序列化 EJB 部署描述符。基于标准 Ant include 和 exclude 选择机制来选择要编译的基于文本的描述符。

参数

示例

<ddcreator descriptors="${dd.dir}"
           dest="${gen.classes}"
           classpath="${descriptorbuild.classpath}">
  <include name="*.txt"/>
</ddcreator>

ejbc

描述

ejbc 任务将运行 WebLogic 的 ejbc 工具。此工具将获取一个序列化部署描述符，检查各种 EJB 接口和 Bean 类，然后生成在 WebLogic EJB 容器中部署 Bean 所需的支持类。这将包括 RMI 存根和骨架，以及实现 Bean 的 Home 和远程接口的类。

运行此工具的 Ant 任务能够在单个操作中编译多个 Bean。要编译的 Bean 通过包含其序列化部署描述符来选择。标准 Ant include 和 exclude 结构可用于选择要包含的部署描述符。

检查每个描述符以确定生成的类是否已过期并需要重新生成。部署描述符被反序列化以发现 Home、远程和实现类。确定相应的源文件并检查其修改时间。这些时间和序列化描述符本身的修改时间与生成类的修改时间进行比较。如果生成的类不存在或已过期，则运行 ejbc 工具以生成新版本。

参数

示例

<ejbc descriptors="${gen.classes}"
           src="${src.dir}"
           dest="${gen.classes}"
           manifest="${build.manifest}"
           classpath="${descriptorbuild.classpath}">
  <include name="*.ser"/>
</ejbc>

iplanet-ejbc

描述

用于为 iPlanet 应用服务器 6.0 编译 EJB 存根和骨架的任务。给定一个标准 EJB 1.1 XML 描述符以及一个 iAS 特定的 EJB 描述符，此任务将生成将 EJB 部署到 iAS 所需的存根和骨架。由于 XML 描述符可以包含多个 EJB，因此这是一种在单个 Ant 任务中指定多个 EJB 的便捷方法。

对于每个指定的 EJB，该任务将在目标目录中找到构成 EJB 的三个类。如果在目标目录中找不到这些类文件，则该任务将失败。该任务还将尝试在该目录中找到 EJB 存根和骨架。如果找到，将检查存根和骨架上的时间戳以确保它们是最新的。只有在找不到这些文件或它们已过期时，才会调用 iAS ejbc 实用程序以生成新的存根和骨架。

参数

示例

<iplanet-ejbc ejbdescriptor="ejb-jar.xml"
              iasdescriptor="ias-ejb-jar.xml"
              dest="${build.classesdir}"
              classpath="${ias.ejbc.cpath}"/>


<iplanet-ejbc ejbdescriptor="ejb-jar.xml"
              iasdescriptor="ias-ejb-jar.xml"
              dest="${build.classesdir}"
              keepgenerated="yes"
              debug="yes"
              iashome="${ias.home}">
              <classpath>
                  <pathelement path="."/>
                  <pathelement path="${build.classpath}"/>
              </classpath>
</iplanet-ejbc>

wlrun

描述

wlrun 任务用于启动 WebLogic 服务器。该任务在单独的 JVM 中运行 WebLogic 实例。许多参数用于控制 WebLogic 实例的操作。请注意，该任务以及 Ant 不会在 WebLogic 实例停止之前完成。

参数

作为嵌套元素指定的参数

wlrun 任务支持嵌套的 <classpath> 和 <wlclasspath> 元素来设置相应的类路径。

示例

此示例显示了使用 wlrun 在 WebLogic 5.1 下运行服务器。

    <wlrun taskname="myserver"
           classpath="${weblogic.boot.classpath}"
           wlclasspath="${weblogic.classes}:${code.jars}"
           name="myserver"
           home="${weblogic.home}"
           properties="myserver/myserver.properties"/>

此示例显示了 wlrun 用于在 WebLogic 6.0 下运行 petstore 服务器。

<wlrun taskname="petstore"
       classpath="${weblogic.classes}"
       name="petstoreServer"
       domain="petstore"
       home="${weblogic.home}"
       password="petstorePassword"
       beahome="${bea.home}"/>

wlstop

描述

wlstop 任务用于停止当前正在运行的 WebLogic 实例。要关闭实例，您必须提供用户名和密码。这些将在用于停止实例的构建脚本中以明文形式存储。出于安全原因，因此此任务仅适用于开发环境。

此任务适用于大多数版本的 WebLogic，包括 6.0。您需要指定 BEAHome 才能使此任务在 6.0 下正常工作

参数

作为嵌套元素指定的参数

wlstop 任务的类路径可以通过嵌套的 <classpath> 元素设置。

示例

此示例展示了 WebLogic 6.0 服务器的关闭过程。

<wlstop classpath="${weblogic.classes}"
        user="system"
        url="t3://localhost:7001"
        password="foobar"
        beahome="${bea.home}"/>

ejbjar

描述

此任务旨在支持构建 EJB jar 文件（EJB 1.1 & 2.0）。目前支持“普通”EJB jar 文件，即仅包含用户生成的类文件和标准部署描述符的文件。嵌套元素提供对供应商特定部署工具的支持。这些工具目前包括

• Borland Application Server 4.5
• iPlanet 应用服务器 6.0
• JBoss 2.1 及更高版本
• 使用 weblogic.ejbc 工具的 WebLogic 5.1/6.0 会话/实体 Bean
• IBM WebSphere 4.0
• 支持 WebLogic 2.5.1 的 TOPLink 实体 Bean
• JOnAS 2.4.x 和 2.5 开源 EJB 服务器
• IronFlare Orion Application Server 2.0

此任务作为目录扫描任务工作，并对找到的每个部署描述符执行操作。因此，应设置 includes 和 excludes 以确保找到所有所需的 EJB 描述符，但不会找到任何应用程序服务器描述符。对于找到的每个描述符，ejbjar 将解析部署描述符以确定实现 Bean 的必要类文件。这些文件与部署描述符一起组装成一个格式良好的 EJB jar 文件。可以使用嵌套的 <support> 元素添加需要包含在生成的 jar 中的任何支持文件。对于包含在 jar 中的每个类，ejbjar 将扫描任何超类或超接口。这些将被添加到生成的 jar 中。

如果不存在嵌套的供应商特定部署元素，则任务将只生成一个通用的 EJB jar。此类 jar 通常用作供应商特定部署工具的输入。对于每个嵌套的部署元素，都会运行一个供应商特定的部署工具来生成一个准备好在该供应商的 EJB 容器中部署的 jar 文件。

只有在 jar 文件过时时才会构建 jar 文件。每个部署工具元素将检查其目标 jar 文件，并确定它是否相对于构成 Bean 的类文件和部署描述符而言过时。如果这些文件中的任何一个比 jar 文件更新，则将重新构建 jar 文件，否则将记录一条消息，表明 jar 文件是最新的。

此任务使用 BCEL 库 来提取所有依赖类。这意味着，除了部署描述符中提到的类之外，任何这些类所依赖的类也会自动包含在 jar 文件中。

命名约定

描述符

这是默认的命名方案。生成的 Bean 的名称是从部署描述符的名称派生的。例如，对于 Account Bean，部署描述符将命名为 Account-ejb-jar.xml。供应商特定描述符使用相同的命名约定进行定位。例如，WebLogic Bean 将命名为 Account-weblogic-ejb-jar.xml。在这种安排下，部署描述符可以与实现 Bean 的代码分离，这在同一 Bean 代码部署在具有不同部署特性的不同 Bean 中时非常有用。

此方案在您每个 EJB jar 使用一个 Bean 且您可能在不同的 Bean 中部署相同的 Bean 类（具有不同的部署特性）时非常有用。

ejb-name

此命名方案使用部署描述符中的 <ejb-name> 元素来确定 Bean 名称。在这种情况下，描述符通常使用通用的描述符名称，例如 ejb-jar.xml 以及任何相关的供应商特定描述符名称。例如，如果 <ejb-name> 的值在部署描述符中给出如下

<ejb-jar>
    <enterprise-beans>
        <entity>
            <ejb-name>Sample</ejb-name>
            <home>org.apache.ant.ejbsample.SampleHome</home>

则生成的 Bean 的名称将为 Sample.jar

此方案在您希望使用标准部署描述符名称时非常有用，这些名称可能与其他 EJB 工具更兼容。此方案必须每个 jar 使用一个 Bean。

目录

在此模式下，生成的 Bean jar 的名称是从包含部署描述符的目录派生的。同样，部署描述符通常使用标准文件名。例如，如果部署描述符的路径为 /home/user/dev/appserver/dd/sample，则生成的 Bean 将命名为 sample.jar

此方案在您希望使用标准样式的描述符名称时也非常有用。当描述符位于与 Bean 源代码相同的目录中时，它通常最有用，尽管这不是强制性的。此方案可以处理每个 jar 多个 Bean。

basejarname

<ejbjar> 任务支持的最终方案用于您希望直接指定生成的 Bean jar 名称时。在这种情况下，生成的 jar 的名称由 basejarname 属性指定。由于所有生成的 Bean 都会具有相同的名称，因此此任务应仅在每个描述符位于其自己的目录中时使用。

此方案最适合您每个 jar 使用多个 Bean 并且只处理单个部署描述符时。您通常希望指定 jar 的名称，而不是从 jar 中的 Bean 派生它。

依赖项

除了 Bean 类之外，ejbjar 还能够将其他类添加到生成的 EJB jar 中。这些类通常是 Bean 类使用的支持类，或者作为 Bean 方法的参数。

在 Ant 1.5 之前的版本中，ejbjar 使用反射并尝试添加 Bean 类的超类和超接口。为了使此技术起作用，Bean 类必须加载到 Ant 的 JVM 中。由于类依赖项，这并不总是可能的。

自 Ant 1.5 起，此任务使用 BCEL 库直接分析 Bean 的类文件，而不是将它们加载到 JVM 中。这也允许 ejbjar 添加 Bean 的所有必需支持类，而不仅仅是超类。

自 Ant 1.5 起，dependency 属性允许构建文件控制将哪些其他类添加到生成的 jar 中。它接受三个可能的值

• none - 仅将 Bean 描述符中描述的 Bean 类和接口添加到 jar 中。
• super - 这是默认值，它复制原始 ejbjar 行为，其中超类和超接口被添加到 jar 中
• full - 在此模式下，将 Bean 类和接口使用的所有类添加到 jar 中

super 和 full 值需要 BCEL 库可用。如果不可用，ejbjar 将回退到与值 none 相对应的行为。

参数

作为嵌套元素指定的参数

除了供应商特定的嵌套元素之外，ejbjar 任务还提供三个嵌套元素。

classpath

<classpath> 嵌套元素允许设置类路径。在设置类路径时，它在引用路径中很有用。在所有其他方面，行为与 classpath 属性相同。

dtd

<dtd> 元素用于指定解析 EJB 部署描述符时要使用的 DTD 的本地位置。使用本地 DTD 比通过网络加载 DTD 快得多。如果您在防火墙后面运行 ejbjar，您甚至可能无法访问远程 DTD。支持的供应商特定嵌套元素知道供应商类层次结构中所需 DTD 的位置，通常这意味着不需要 <dtd> 元素。但是，这意味着在启动 Ant 时，供应商的类层次结构必须在类路径中可用。如果您希望在不将供应商类放在类路径中运行 Ant，则需要使用 <dtd> 元素。

support

<support> 嵌套元素用于提供要包含在生成的 jar 中的其他类（文件）。<support> 元素是一个 FileSet，因此它可以引用其他地方声明的文件集，也可以使用适当的 <include> 和 <exclude> 嵌套元素在本地定义。支持文件集中的文件将添加到生成的 EJB jar 中，其相对位置与它们在支持文件集中的位置相同。请注意，当 ejbjar 生成多个 jar 文件时，支持文件将被添加到每个文件中。

供应商特定部署元素

每个供应商特定的嵌套元素控制特定于该供应商的 EJB 容器的可部署 jar 的生成。此处详细介绍了每个支持的部署元素的参数。

Jboss 元素

jboss 元素搜索 JBoss 特定的部署描述符，并将它们添加到最终的 EJB jar 文件中。JBoss 有两个部署描述符

• jboss.xml
• 用于容器管理器持久性

  CMP 版本	文件名
  CMP 1.0	jaws.xml
  CMP 2.0	jbosscmp-jdbc.xml

JBoss 服务器使用热部署，不需要编译额外的存根和骨架。

WebLogic 元素

weblogic 元素用于控制 weblogic.ejbc 编译器以生成 WebLogic EJB jar 文件。在 Ant 1.3 之前，定位 CMP 描述符的方法是使用 ejbjar 命名约定。因此，如果您的 EJB jar 被称为 Customer-ejb-jar.xml，您的 WebLogic 描述符被称为 Customer-weblogic-ejb-jar.xml，您的 CMP 描述符必须是 Customer-weblogic-cmp-rdbms-jar.xml。此外，WebLogic 描述符中的 <type-storage> 元素必须设置为标准名称 META-INF/weblogic-cmp-rdbms-jar.xml，因为这是 CMP 描述符在生成的 jar 中映射到的位置。

这种方案存在一些问题。它不允许在 jar 中定义多个 CMP 描述符，并且与某些工具生成的部署描述符不兼容。

在 Ant 1.3 中，ejbjar 解析 WebLogic 部署描述符以发现 CMP 描述符，然后自动包含它们。此行为由 newCMP 属性控制。请注意，如果您迁移到确定 CMP 描述符的新方法，则需要更新 WebLogic 部署描述符的 <type-storage> 元素。在上面的示例中，您将将其定义为 META-INF/Customer-weblogic-cmp-rdbms-jar.xml。

weblogic 嵌套元素支持三个嵌套元素。前两个，<classpath> 和 <wlclasspath>，用于设置各自的类路径。当使用引用 ID 设置类路径时，这些嵌套元素很有用。最后一个，<sysproperty>，允许在编译器运行期间设置 Java 系统属性。事实证明，这对于在所有环境中支持 CMP EJB 编译是必要的。

TOPLink for WebLogic 元素

已弃用

toplink 元素不再需要。只要 newCMP 属性设置为 true，就可以使用标准的 weblogic 元素构建 Toplink bean。

TopLink 元素用于处理使用 Toplink 进行 CMP 操作的 bean。它源自标准的 weblogic 元素，因此它支持相同的属性集，以及以下附加属性。

示例

此示例显示了 ejbjar 用于使用 WebLogic EJB 容器生成部署 jar 文件。此示例要求使用命名标准来命名部署描述符。使用此格式将为在部署描述符目录中找到的每个 *-ejb-jar.xml 变体创建一个 EJB jar 文件。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}">
  <weblogic destdir="${deploymentjars.dir}"
            classpath="${descriptorbuild.classpath}"/>
  <include name="**/*-ejb-jar.xml"/>
  <exclude name="**/*weblogic*.xml"/>
</ejbjar>

如果 WebLogic 不在 Ant 类路径中，以下示例显示了如何指定 WebLogic DTD 的位置。此示例还显示了嵌套 classpath 元素的使用。

<ejbjar descriptordir="${src.dir}" srcdir="${build.classes}">
   <weblogic destdir="${deployment.webshop.dir}"
             keepgeneric="true"
             args="-g -keepgenerated ${ejbc.compiler}"
             suffix=".jar"
             oldCMP="false">
     <classpath>
       <pathelement path="${descriptorbuild.classpath}"/>
     </classpath>
   </weblogic>
   <include name="**/*-ejb-jar.xml"/>
   <exclude name="**/*-weblogic-ejb-jar.xml"/>
   <dtd publicId="-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
        location="${weblogic.home}/classes/weblogic/ejb/deployment/xml/ejb-jar.dtd"/>
   <dtd publicId="-//BEA Systems, Inc.//DTD WebLogic 5.1.0 EJB//EN"
        location="${weblogic.home}/classes/weblogic/ejb/deployment/xml/weblogic-ejb-jar.dtd"/>
</ejbjar>

此示例显示了 ejbjar 用于使用 WebLogic EJB 容器生成单个部署 jar 文件。此示例不要求部署描述符使用命名标准。这将只创建一个 EJB jar 文件 - TheEJBJar.jar。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}"
        basejarname="TheEJBJar">
  <weblogic destdir="${deploymentjars.dir}"
            classpath="${descriptorbuild.classpath}"/>
  <include name="**/ejb-jar.xml"/>
  <exclude name="**/weblogic*.xml"/>
</ejbjar>

此示例显示了 ejbjar 用于使用 WebLogic EJB 容器为启用 TOPLink 的实体 bean 生成部署 jar 文件。此示例不要求部署描述符使用命名标准。这将只创建一个启用 TOPLink 的 EJB jar 文件 - Address.jar。

<ejbjar srcdir="${build.dir}"
        destdir="${solant.ejb.dir}"
        descriptordir="${descriptor.dir}"
        basejarname="Address">
        <weblogictoplink destdir="${solant.ejb.dir}"
                classpath="${java.class.path}"
                keepgeneric="false"
                toplinkdescriptor="Address.xml"
                toplinkdtd="file:///dtdfiles/toplink-cmp_2_5_1.dtd"
                suffix=".jar"/>
        <include name="**/ejb-jar.xml"/>
        <exclude name="**/weblogic-ejb-jar.xml"/>
</ejbjar>

此最终示例显示了如何在 WebLogic 6.0 下设置 ejbjar。它还显示了使用 <support> 元素添加支持文件。

<ejbjar descriptordir="${dd.dir}" srcdir="${build.classes.server}">
   <include name="**/*-ejb-jar.xml"/>
   <exclude name="**/*-weblogic-ejb-jar.xml"/>
   <support dir="${build.classes.server}">
        <include name="**/*.class"/>
   </support>
   <weblogic destdir="${deployment.dir}"
             keepgeneric="true"
             suffix=".jar"
             rebuild="false">
     <classpath>
        <pathelement path="${build.classes.server}"/>
     </classpath>
     <wlclasspath>
        <pathelement path="${weblogic.classes}"/>
     </wlclasspath>
   </weblogic>
</ejbjar>

WebSphere 元素

websphere 元素搜索 WebSphere 特定的部署描述符，并将它们添加到最终的 EJB jar 文件中。WebSphere 为会话 bean 有两个特定的描述符

• ibm-ejb-jar-bnd.xmi
• ibm-ejb-jar-ext.xmi

以及另外两个用于容器管理的实体 bean

• Map.mapxmi
• Schema.dbxmi

在 WebSphere 方面，容器代码和存根的生成称为部署。此步骤可以由 websphere 元素作为 jar 生成过程的一部分执行。如果开关 ejbdeploy 处于打开状态，则会为每个 EJB jar 调用来自 WebSphere 工具集的 ejbdeploy 工具。不幸的是，此步骤仅在使用 IBM JDK 时才有效。否则，rmic（由 ejbdeploy 调用）会抛出 ClassFormatError。如果 Ant 使用 Oracle JDK 或 OpenJDK 运行，请确保关闭 ejbdeploy。

要使 websphere 元素正常工作，您必须提供一个完整的类路径，其中包含反映 bean 类所需的所有类。要使 ejbdeploy 正常工作，您还必须提供 ejbdeploy 工具的类路径，并设置 websphere.home 属性（请查看下面的示例）。

<WAS_HOME>/bin/EJBDeploy.[sh/bat] -help

此示例显示了 ejbjar 用于为 descriptordir 中的所有部署描述符生成部署 jar 文件。

<property name="websphere.home" value="${was4.home}"/>
<ejbjar srcdir="${build.class}" descriptordir="etc/ejb">
  <include name="*-ejb-jar.xml"/>
  <websphere dbvendor="DB2UDBOS390_V6"
             ejbdeploy="true"
             oldCMP="false"
             tempdir="/tmp"
             destdir="${dist.server}">
    <wasclasspath>
      <pathelement location="${was4.home}/deploytool/itp/plugins/org.eclipse.core.boot/boot.jar"/>
      <pathelement location="${was4.home}/deploytool/itp/plugins/com.ibm.etools.ejbdeploy/runtime/batch.jar"/>
      <pathelement location="${was4.home}/lib/xerces.jar"/>
      <pathelement location="${was4.home}/lib/ivjejb35.jar"/>
      <pathelement location="${was4.home}/lib/j2ee.jar"/>
      <pathelement location="${was4.home}/lib/vaprt.jar"/>
    </wasclasspath>
    <classpath>
      <path refid="build.classpath"/>
    </classpath>
  </websphere>
  <dtd publicId="-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
       location="${lib}/dtd/ejb-jar_1_1.dtd"/>
</ejbjar>

iPlanet Application Server (iAS) 元素

<iplanet> 嵌套元素用于构建特定于 iAS 的存根和骨架，并构建一个可以部署到 iPlanet Application Server 6.0 的 JAR 文件。构建过程将始终确定 EJB 存根/骨架和 EJB jar 文件是否是最新的，并且将执行最少的工作量。

与 weblogic 元素类似，EJB 描述符的命名约定通常用于指定完成的 JAR 文件的名称。例如，如果在描述符目录中找到 EJB 描述符 ejb/Account-ejb-jar.xml，则 iplanet 元素将搜索名为 ejb/Account-ias-ejb-jar.xml 的特定于 iAS 的 EJB 描述符文件（如果未找到，则任务将失败），并且名为 ejb/Account.jar 的 JAR 文件将写入目标目录。请注意，当 EJB 描述符添加到 JAR 文件时，它们会自动重命名为 META-INF/ejb-jar.xml 和 META-INF/ias-ejb-jar.xml。

当然，可以通过在 ejbjar 任务（例如，basejarname、basenameterminator 和 flatdestdir）以及 iplanet 元素（例如，suffix）中指定属性来修改此命名行为。有关更多详细信息，请参阅相应的文档。

参数

如上所述，iplanet 元素支持额外的 <classpath> 嵌套元素。

示例

此示例演示了 <iplanet> 嵌套元素的典型用法。它将使用附加到每个标准 EJB 描述符的“basename”来命名每个 EJB jar。例如，如果处理名为 Account-ejb-jar.xml 的描述符，则 EJB-JAR 将被命名为 Account.jar

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}">

    <iplanet destdir="${assemble.ejbjar}"
             classpath="${ias.ejbc.cpath}"/>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>
</ejbjar>

此示例演示了嵌套 classpath 元素以及其他一些可选属性的用法。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}">

    <iplanet destdir="${assemble.ejbjar}"
             iashome="${ias.home}"
             debug="yes"
             keepgenerated="yes">
        <classpath>
            <pathelement path="."/>
            <pathelement path="${build.classpath}"/>
        </classpath>
    </iplanet>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>
</ejbjar>

此示例演示了 basejarname 属性的用法。在这种情况下，完成的 EJB jar 将被命名为 HelloWorld.jar。如果可能找到多个 EJB 描述符，则必须注意确保完成的 JAR 文件不会相互覆盖。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}"
        basejarname="HelloWorld">

    <iplanet destdir="${assemble.ejbjar}"
             classpath="${ias.ejbc.cpath}"/>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>
</ejbjar>

此示例演示了 dtd 嵌套元素的用法。如果类路径中包含 DTD 的本地副本，则它们将自动引用，而无需嵌套元素。在 iAS 6.0 SP2 中，这些本地 DTD 位于 [iAS-install-directory]/APPS 目录中。在 iAS 6.0 SP3 中，这些本地 DTD 位于 [iAS-install-directory]/dtd 目录中。

<ejbjar srcdir="${build.classesdir}"
        descriptordir="${src}">
    <iplanet destdir="${assemble.ejbjar}">
             classpath="${ias.ejbc.cpath}"/>
    <include name="**/*-ejb-jar.xml"/>
    <exclude name="**/*ias-*.xml"/>

    <dtd publicId="-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 1.1//EN"
         location="${ias.home}/APPS/ejb-jar_1_1.dtd"/>
    <dtd publicId="-//Sun Microsystems, Inc.//DTD iAS Enterprise JavaBeans 1.0//EN"
         location="${ias.home}/APPS/IASEjb_jar_1_0.dtd"/>
</ejbjar>

JOnAS（Java Open Application Server）元素

<jonas> 嵌套元素使用 GenIC 特定工具构建特定于 JOnAS 的存根和骨架，并构建一个可以部署到 JOnAS Application Server 的 JAR 文件。构建过程将始终确定 EJB 存根/骨架和 EJB jar 文件是否是最新的，并且将执行最少的工作量。

与 WebLogic 元素类似，EJB 描述符的命名约定通常用于指定完成的 JAR 文件的名称。例如，如果在描述符目录中找到 EJB 描述符 ejb/Account-ejb-jar.xml，则 <jonas> 元素将搜索名为 ejb/Account-jonas-ejb-jar.xml 的特定于 JOnAS 的 EJB 描述符文件，并且名为 ejb/Account.jar 的 JAR 文件将写入目标目录。但是，<jonas> 元素也可以使用 JOnAS 命名约定。使用与以下相同的示例，EJB 描述符也可以在描述符目录中命名为 ejb/Account.xml（此处没有基本名称终止符）。然后，<jonas> 元素将搜索名为 ejb/jonas-Account.xml 的特定于 JOnAS 的 EJB 描述符文件。此约定并不严格遵循 EJB jar 命名约定建议，但为了与 JOnAS 的先前版本向后兼容而得到支持。

请注意，当 EJB 描述符添加到 JAR 文件时，它们会自动重命名为 META-INF/ejb-jar.xml 和 META-INF/jonas-ejb-jar.xml。

当然，可以通过在 ejbjar 任务（例如，basejarname、basenameterminator 和 flatdestdir）以及 iplanet 元素（例如，suffix）中指定属性来修改此命名行为。有关更多详细信息，请参阅相应的文档。

此任务在 临时目录 中为暂存数据创建一个目录。

参数

如上所述，jonas 元素支持额外的 <classpath> 嵌套元素。

示例

此示例显示了 ejbjar 用于使用 JOnAS EJB 容器生成部署 jar。此示例要求使用命名标准进行部署描述符。使用此格式将为部署描述符目录中找到的每个 *-jar.xml 变体创建一个 EJB jar 文件。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}">
  <jonas destdir="${deploymentjars.dir}"
       jonasroot="${jonas.root}"
       orb="RMI"/>
  <include name="**/*.xml"/>
  <exclude name="**/jonas-*.xml"/>
  <support dir="${build.classes}">
       <include name="**/*.class"/>
  </support>
</ejbjar>

此示例显示了 ejbjar 用于使用 JOnAS EJB 容器生成单个部署 jar。此示例确实要求部署描述符使用命名标准。这将只创建一个 EJB jar 文件——TheEJBJar.jar。

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}"
        basejarname="TheEJBJar">
  <jonas destdir="${deploymentjars.dir}"
            jonasroot="${jonas.root}"
            suffix=".jar"
            classpath="${descriptorbuild.classpath}"/>
  <include name="**/ejb-jar.xml"/>
  <exclude name="**/jonas-ejb-jar.xml"/>
</ejbjar>

Orion 元素

orion 元素搜索 Orion Application Server 特定的部署描述符，并将它们添加到最终的 EJB jar 文件中。Orion 有一个部署描述符

• orion-ejb-jar.xml

示例

<ejbjar srcdir="${build.classes}"
        descriptordir="${descriptor.dir}"
        basejarname="TheEJBJar"
        flatdestdir="true"
        dependency="super"
        genericjarsuffix=".jar">
  <include name="**/*-ejb-jar.xml"/>
  <orion destdir="${deploymentjars.dir}"\>
</ejbjar>