工具向导:使用 Rational XDE Developer - Java Platform Edition 组装 J2EE 模块和应用程序
此工具向导描述如何使用 Rational XDE 产生 J2EE 归档(如,JAR、WAR、EJB-JAR 和 EAR)。
工具:Rational XDE Developer
关系
主要描述

用途

此工具向导与以下特定于 J2EE 的信息相关:

概述

XDE 允许自动创建 J2EE 归档,用于对将在归档中部署的组件建模和对将部署 J2EE 归档的节点(容器和服务器)建模。这些活动在 XDE 部署模型中执行。

在本工具向导中执行以下步骤:

有关更多信息

至 Rational XDE™ 联机帮助中各主题的链接标有 “帮助手册”图标

设置组装工作空间

在 XDE 中,组装工作空间是 XDE 部署模型(EJB、Web 和 EAR)。因此在本步骤中,要创建必要的 XDE 部署模型。有关应定义的项目和部署模型的建议,请参阅 XDE 模型结构指南

当创建 XDE 项目时,可能已经创建了部分部署模型。但是,组装人员可能会选择创建其他单独的“组装工作空间”,来支持测试部署和生产部署。

在 XDE 中,要实施单独的组装工作空间,可使用单独的 XDE 部署模型,或通过在同一部署模型中定义个别归档(即单独的测试归档、单独的生产归档等)。 后一种方法的好处是减少了 XDE 模型个数并略微更易对同一个模型中的归档一致添加、除去和变更 J2EE 组件、归档文件等。 不过,管理对同一个模型的当前修改是此方法的不足之处。 单独的模型也使得当需要小心控制生产归档的内容时,更易限制对它们的访问。

XDE 部署模型可“手动”创建(请参阅“帮助手册”图标创建 Java 部署模型,或在创建归档的同时使用 XDE 的 J2EE 部署向导创建(请参阅下一个步骤:定义归档)。XDE 部署向导创建或更新合适的 EJB 或 Web 部署模型,以及包含“封闭”EAR 的 EAR 模型(需要该模型来部署到大多数应用程序服务器)。

有关填充 XDE 部署模型的信息,请参阅此工具向导中的其余步骤。

定义归档

在此步骤中,您创建归档(如果尚不存在)并确定归档中应包含的元素。

J2EE 模块归档 EJB-JAR 和 WAR 分别在 EJB 和 Web 部署模型中建模。在这些部署模型中,您对将要部署在那些归档中的元素建模。

J2EE 应用程序归档 EAR 在 EAR 部署模型中建模。在 EAR 部署模型中,您对包含在 EAR 中的 J2EE 模块归档以及将要部署 EAR 的应用程序服务器节点建模。有关将归档映射到节点的更多信息,请参阅“帮助手册”图标部署关系 . 节点包含有关服务器类型的信息和部署所需的信息。如果应用程序服务器的类型是受 XDE 支持的,那么,XDE 允许您为服务器指定某些属性(如应用程序级的安全角色)来辅助部署。有关更多信息,请参阅“帮助手册”图标部署节点(Java) . 另请参阅“帮助手册”图标应用程序服务器(Java) .

在 XDE 中,可以使用 J2EE 应用程序部署向导来设置 XDE 部署模型,包括创建模型、创建归档、确定要在那些归档中部署的元素并指定应部署归档的节点。在 EJB 和 Web 部署模型中,您定义要包含在 J2EE 模块归档中的元素,同时部署向导设置归档文件和组件之间的关系。 在 EAR 部署模型中,您定义进入 EAR 的归档(部署向导设置与 EJB 和 Web 部署模型中的归档的缺省关系)并定义部署归档的应用程序服务器“节点”。有关 XDE 部署向导的更多信息,请参阅“帮助手册”图标J2EE 部署向导 .

有关使用 XDE 部署向导的一些注意事项:

  • 在调用向导之前,需要先打开包含要包含在归档中的元素的 XDE 模型,以便在下拉框中显示元素并可从中选择要包含在归档中的元素。
  • 向导只向归档添加元素。而不能除去之前指定的项,即使在后续调用中,向导中未选中那些项。
  • 如果在 XDE 部署模型中具有多个归档,则 XDE 将其中一个视作“缺省”归档。这就是在部署向导的最后一步中指定的归档。如果正在 WebSphere Studio Application Developer 中使用 XDE,那么这是 XDE 将知道的唯一归档,因为 Application Developer 要求每个归档都有一个独立项目。因此,您不能使用 Application Developer 工具来处理“非缺省”归档。
  • 您可以在应用程序的发展中并且需要向现有归档添加新元素、需要创建新归档或需要更改部署信息时重复运行向导(有关部署 J2EE 归档的更多信息,请参阅工具向导:使用 Rational XDE Developer - Java Platform Edition 部署 J2EE 模块和应用程序)。
  • 运行向导之后,推荐的做法是在每个部署模型中打开缺省图,然后将部署模型中所创建的元素(例如:组件、归档)拖到图中,并按自己意愿放置。

此步骤的结果应在部署图中捕获。有关更多信息,请参阅“帮助手册”图标使用部署图 . 另请参阅“帮助手册”图标为图中的形状设置布局并分组 .

定义部署描述符

在 XDE 中,并不真正地直接编辑部署描述符。而是对 XDE 部署模型中的部署描述符建模,然后在部署期间自动构造部署描述符文件。XDE 部署模型本质上是相应部署描述符的模型。有关 XDE 中的部署描述符的更多信息,请参阅“帮助手册”图标部署描述符文件 .

XDE 部署向导(在前一步骤:定义归档中讨论)自动填充很多部署描述符属性(在创建归档时和每次运行部署向导时)。按那种方式,部署描述符随同包含的组件一起发展。

某些应用程序服务器要求 EJB-JAR、WAR 和其他 JAR 归档外有 EAR“包装程序”以供部署,这意味着应用程序组件供应者可能需要组装 EAR 以供测试。在这样的情况下,XDE 部署向导自动生成的 EAR 通常就足够了。

但是,应用程序组装人员通常关心 EAR 内容的细节,特别是应用程序范围的安全角色等,这些也可在 XDE 中建模。在 XDE 部署模型中,可以使用弹出菜单或相应工具箱对安全角色、许可权、事务等建模。每个工具箱中的“连接者助手”知道在元素之间创建哪几种关系。在存在多个可能选项的情况下,会出现提示以供用户选择。有关“连接者助手”的更多信息,请参阅“帮助手册”图标为 EJB 定义关系 . 有关对 WAR 文件建模的详细信息,请参阅“帮助手册”图标对 WAR 文件建模 . 有关对 EJB-JAR 文件建模的详细信息,请参阅“帮助手册”图标建模部署 .

XDE 部署模型(EJB、Web 和 EAR)包含生成 EJB、Web 以及企业应用程序 ejb-jar.xml、web.xml 和 application.xml 部署描述符分别所需的所有信息(部分信息是从与部署模型相关的代码模型中派生出的)。这些是按 J2EE 标准定义的描述符。对于大多数应用程序服务器,完成部署通常需要附加描述符。 XDE 为受支持的应用程序服务器生成这些附加部署描述符。有关更多信息,请参阅“帮助手册”图标Java 应用程序部署 .

如果定义了数据模型中的数据库表和容器管理的持久(CMP)实体 EJB 之间的映射,那么那些映射将用于在特定于供应商的描述符中生成映射伪指令(映射伪指令不属于标准 EJB 描述符)。如果尚未定义数据模型映射,则将对 CMP 实体 EJB 生成缺省映射。有关更多信息,请参阅“帮助手册”图标将 EJB 与数据库配合使用 .

XDE 不对所有特定于供应商的描述符的完整内容建模,也不生成它们。相反,可以覆盖自动创建的这些描述符中的一个或多个并自己维护。每个归档都具有一个特征,该特征拥有一列将包含在归档中、但不建模的文件或目录。该特征称为 JARNonModelElements(对于 JAR)、EJBNonModelElements(对于 EJB-JAR)、WebNonModelElements(对于 WAR)和 EARNonModelElements(对于 EAR)。向相应归档的适当特征添加要自己维护的部署描述符和其他文件。有关更多信息,请参阅 “帮助手册”图标Java 应用程序部署 .

验证归档

在尝试部署之前,验证 XDE 部署模型是一个好的想法,因为含糊的错误(特别是应用程序服务器端的错误)可能会导致含糊或不存在的错误消息。实际上,“在使用时”验证模型是个好想法(即,作为完整性检查,在组装期间偶尔进行并在部署前进行一次)。

XDE 支持检查模型的完整性。在“模型资源管理器”中选择模型,然后调用环境命令“Validate”。如果发现问题,会将任务项写入任务列表。有关更多信息,请参阅“帮助手册”图标验证 Java 模型 . 有关 XDE 为部署模型验证的内容的更多信息,请参阅“帮助手册”图标部署验证规则 .

关于更多信息

除了在 XDE 中对 J2EE 归档和部署描述符建模,也可以将部署描述符或完整的归档导入 XDE。有关更多信息,请参阅“帮助手册”图标在部署中导入与导出 .

有关 XDE 部署建模的更多信息,请参阅“帮助手册”图标建模部署 . 有关部署的更多信息,请参阅工具向导:使用 Rational XDE Developer - Java Platform Edition 部署 J2EE 模块和应用程序