EJB 部署描述符编辑器

EJB 部署描述符编辑器用于修改 EJB JAR 文件和相关联的 Java™ 文件。

EJB 部署描述符编辑器由表示 EJB 部署描述符中各种属性和设置的页面与部分组成。另外,该编辑器还包括专门与对 EJB 规范的 WebSphere® Application Server 绑定和扩展相关的部分和页面。

核心功能通常位于编辑器页面的顶部。要查看核心页面和部分,请将焦点设置在编辑器上,然后按 alt-shift-c 组合键。核心页面、部分、标题和选项卡将会突出显示为蓝色并保持此状态,直到您再次按 alt-shift-c 组合键。扩展和绑定通常是嵌套的部分并且可以在编辑器页面的底部找到。折叠某部分时会隐藏其内容,但是会保留标题信息。这对于过滤每个页面上的数据和属性很有用。编辑器会记住您在关闭和重新打开编辑器时折叠的部分。此外,您还可以通过拖动每一部分开头或末尾的隐藏边框来调整各部分的大小。

编辑器的另一个重要功能是增强的向导支持。您可以从编辑器打开向导,这些向导会引导您完成创建和修改各个元素的步骤。向导可帮助您解决单步执行创建过程时遇到的问题。如果发生错误或者输入无效数据,则向导会在向导页面的顶部显示警告或错误消息。向导提供了同时创建或编辑许多对象的能力,您可以同时对多个 bean 进行操作。

EJB 编辑器修改下列资源:

虽然 EJB 部署描述符编辑器页面会视您启用的功能(窗口 > 首选项 > 工作台 > 功能)而有所变化,但 EJB 部署描述符编辑器通常会显示以下主要选项卡式页面:

概述页

使用概述页来查看、创建和修改 EJB 模块的基本属性。这应该是您查找编辑器内容的第一个位置。此页面的主体是 ejb-jar.xml 文件的用户界面表示。ejb-jar.xml 的核心 XML 标记已分为下列几个部分:

一般信息
使用此部分来添加显示和描述名。这些名称用于 Web 服务器和 J2EE 视图上的标识。
使用情况
使用此部分来查看指向与 EJB JAR 相关联的编辑器的链接的列表。例如,如果 EJB JAR 是在 EAR 中定义的,则 EAR 名称作为链接出现。单击该链接将启动 EAR 部署描述符编辑器。
Enterprise JavaBeans™
使用此部分来查看与 EJB 中的 bean 相对应的链接的列表。单击链接将进入 Bean 页面并突出显示该企业 bean。
组装描述符
此部分具有详细信息按钮,它链接至组装页面。组装页面具有用于安全角色、方法许可权、容器事务和排除列表的部分与向导。
EJB 客户机 JAR
此部分显示为 EJB 模块创建的 EJB 客户机 JAR 文件的名称。如果尚未创建任何 EJB 客户机 JAR 文件,则可以单击创建按钮以打开“EJB 客户机 JAR 创建”向导并创建 JAR 文件。
引用
此部分还具有详细信息按钮,它链接至引用页面。
关系 2.0
此部分只可用于 EJB 2.0 模块。“关系”部分包含现有关系的列表。可在此处完成关系的所有创建和修改工作。
图标
使用此部分为 EJB JAR 指定图标。这主要是用于运行时的标识。
WebSphere 扩展
仅当项目的目标为 WebSphere Application Server 时才显示。此部分包含 1.x 关系继承组合体。每个区域都有一个编辑按钮,它启动向导来更新所选 bean 的部署描述符属性。
WebSphere 绑定
仅当项目的目标为 WebSphere Application Server 时才显示。

对于 EJB 1.1 模块:

  • JNDI 缺省数据源绑定:使用此部分来指定数据源 JNDI 名称、JNDI 用户标识和数据源密码。
对于 EJB 2.0 模块:
  • 后端标识:使用此部分确定在部署时装入的持久程序类。
  • JNDI CMP 工厂连接绑定:使用此部分来指定 JNDI 名称容器权限类型。可以选择容器管理的认证或选择组件管理的认证。

Bean 页

使用此 Bean 页可以创建、修改和除去企业 bean 的功能与资源。Bean 页的左边显示 EJB 项目中的 bean 列表。右边的可滚动部分包含了所选 bean 的详细信息。例如,如果选择 EJB 1.x CMP 实体 bean,则仅显示与该类型 bean 相关的部分。

Bean 页包括下列部分:

常规部分
所有企业 bean 都具有常规部分,此部分使您能快速访问常用信息。对于 EJB 1.1 CMP 实体 bean,该部分包含显示名、可重入类型、描述和 CMP 字段。EJB 2.x CMP 实体 bean 还具有用于抽象模式名的字段。显示名和描述字段用于 J2EE 视图内和 Web 服务器上的标识。如果不想要某个 bean 在完成其当前执行前就被访问,可以使用可重入字段。创建 EJBQL 语句时会设置和使用抽象模式名。“属性”部分允许您创建和除去属性。属性是已映射字段,这些字段访问数据库来使数据成为持久数据以及检索数据。

双击 bean 以便在 Java 编辑器中打开 Java 源代码。

类和接口文件
用于 EJB 1.1 bean 和 EJB 2.x bean。使用此部分来修改与该 bean 相关联的 Java 资源。例如,如果想要打开 bean Java 类并添加业务逻辑,则可以双击该 bean 类或在表中选择该 bean 类并单击打开打开按钮启动支持编辑企业 bean 的 Java 编辑器。类接口部分还向您提供将 Java 资源更改为其他现有资源的能力。单击浏览按钮可以访问此复用功能。将有一个资源浏览对话框向您进行提示。还可以使用除去功能,它会启动帮助您删除资源的向导。
环境变量
用于 EJB 1.1 bean 和 EJB 2.x bean。使用此部分来添加、除去和修改环境变量。在编辑器中双击变量可以突出显示“源代码”视图中的适当元素。

环境变量是在 Web 和 EJB 组件中定义的常量变量。例如,如果定义圆周 bean,则您可创建称为 PI 的环境变量并将值设置为 3.1415926。如果具有另一个称为圆锥的企业 bean 和 servlet,则它可通过执行 JNDI 查找来访问 PI 变量。

图标
用于 EJB 1.1 bean 和 EJB 2.x bean。此图标部分与 EJB JAR 部分类似。使用此部分在 bean 级别指定图标。这主要是用于运行时的标识。
消息驱动的目标
用于 EJB 2.x 消息驱动的 bean。使用此部分来对消息驱动的 bean 指定目标类型和预订耐久性。
关系
用于 EJB 2.x CMP 实体 bean。使用此部分来创建和使用 EJB 2.0 CMP 实体 bean 的关系。
访问 Bean
用于 EJB 1.1 和 EJB 2.x 会话与实体 bean。不可用于消息驱动的 bean。使用此部分来创建和编辑访问 bean。访问 bean 是获取对企业 bean 的访问的方便方法。
查询
用于 EJB 2.x CMP 实体 bean。使用此部分来创建 finder 方法并将 finder 语句指定给这些方法。也可以除去 finder 描述符。finder 方法驻留在 home 接口上。将 finder 描述符指定给这些方法。finder 描述符用来查询数据库以返回特定 bean 实例。单击添加以打开 finder 向导,它使用户可以选择是创建 finder 方法还是使用现有 finder 方法。在创建该方法之后,向导帮助您添加描述符信息。
WebSphere 绑定
仅当项目的目标为 WebSphere Application Server 时才显示。用于 EJB 1.1 bean 和 EJB 2.x bean。使用此部分来对 WebSphere Application Server 指定绑定属性。数据源用来在运行时查找指定数据库。必须在服务器配置中创建数据源。如果正在使用 WebSphere Application Server,则可以使用服务器工具来完成此任务。用户名和密码用于在访问数据库时进行验证。
WebSphere 扩展
仅当项目的目标为 WebSphere Application Server 时才显示。用于 EJB 1.1 bean 和 EJB 2.x bean。使用此部分指定其他扩展以便与 WebSphere Application Server 配合使用。下列部分或字段可用,这取决于所选 bean 的类型和级别:
会话超时
对于会话 bean,使用此部分来指定超时值和活动会话类型。
关系
用于 EJB 1.1 CMP 实体 bean。使用此部分来定义关系。
finder
用于 EJB 1.1 CMP 实体 bean。使用此部分来创建 finder 方法并将 finder 语句指定给这些方法。也可以除去 finder 描述符。finder 方法驻留在 home 接口上。将 finder 描述符指定给这些方法。finder 描述符用来查询数据库以返回特定 bean 实例。单击添加以打开 finder 向导,它使用户可以选择是创建 finder 方法还是使用现有 finder 方法。在创建该方法之后,向导帮助您添加描述符信息。
Bean 高速缓存
使用此部分来定义 bean 高速缓存设置。
补偿
使用此部分来使 bean 能够使用对 Web Services Business Activity 标准的 WebSphere Application Server 支持。

选中在业务活动作用域下运行 EJB 方法复选框以指定应用程序组件必须在与其工作单元相关联的业务活动作用域下执行。企业活动作用域是由组件或在同一个作用域下运行的任何其他组件注册的任何组件处理程序的分界线。业务活动作用域是使用 Web Services Business Activity(WS-BusinessActivity)规范中描述的机制分布在多个远程服务器上。

如果选择在企业活动作用域下运行 EJB 方法,则可以选择指定补偿处理程序来在业务活动失败时执行更正操作。补偿处理程序类名就是实现 com.ibm.websphere.wsba.CompensationHandler 接口的应用程序客户机的名称,并且它作为应用程序的一部分部署。当业务活动作用域结束时可以调用补偿处理程序,同时传递在作用域向前执行过程中应用程序提供的补偿数据。

全局事务
全局事务设置是 WebSphere Application Server 对 Enterprise JavaBeans 规范的扩展。如果应用程序使用两个或多个资源,则外部事务管理器需要协调全局事务中对两个资源管理器的更新。
本地事务 2.0
使用此部分来定义本地事务设置。
语言环境调用
使用这些设置可以使在 WebSphere Application Server 上运行的 EJB 的性能达到最佳。
数据高速缓存
用于 EJB 2.x CMP 实体 bean。使用此部分指定高速缓存的生存期和高速缓存使用的生存期。
并发性控制
用于 1.1 CMP 实体 bean。缺省情况下不启用乐观锁定,这意味着如果实体 bean 正在访问数据库中的某一行,则在原始 bean 释放该行之前,另一个 bean 将无法编辑该行。如果在锁定行期间尝试编辑该行,则会抛出异常。

引用页

使用“引用”页来为项目中的企业 bean 定义引用。这些引用的 WebSphere 绑定(例如引用的 JNDI 名称)也在此页面中设置。选择一个 bean,然后单击添加以打开“添加引用”向导。有关更多信息,请参阅为 J2EE 模块定义引用

“引用”页的设置方式与 Bean 页相似,随着左边的主要部分选择内容的不同,右边的详细信息部分将会动态地更改。

WS 处理程序页

对于定义用于 EJB 模块中的企业 bean 的每个 Web service 引用,可使用此处理程序页来为这类 Web service 引用定义 Web service 处理程序。有关更多信息,请参阅定义 Web service 处理程序

组装页

使用此页面来定义安全角色、方法许可权和方法事务。它还允许您从安全约束中排除方法。“组装”页具有以下部分:

安全角色
使用此部分来定义安全角色。需要安全角色来构建方法许可权。此部分列示了已定义的安全角色,并显示所选安全角色的详细信息。
方法许可权
使用此部分来将许可权添加至方法级别上的 bean。此部分包含具有现有方法许可权列表的树。当创建新的方法许可权时,它将出现在树中。如果展开树,将会显示在方法许可权中定义的 bean 和方法。
容器事务
要添加容器事务,单击添加以启动“容器事务”向导。在选择了任何树对象的情况下单击除去按钮将除去“事务”。
排除列表
对于 EJB 2.x 模块,使用此部分来通过部署描述符将方法元素标记为不可调用。

访问页面

使用“访问”页来为 CMP 实体 bean 定义访问意向、隔离级别和安全标识属性变量。视 EJB 项目的 EJB 版本级别而定,“访问”页会显示不同的部分,包括 WebSphere 扩展。可用的部分包括以下部分:

安全标识(Bean 级别)
使用此部分来添加安全标识。
实体 2.x(Bean 级别)的缺省访问意向
使用此部分来定义 bean 级别安全标识的缺省访问意向。
实体 2.x(方法级别)的访问意向
使用此部分来定义方法级别安全标识的访问意向。
实体 1.x 的访问意向
WebSphere Application Server 扩展。使用此部分来定义 bean 级别安全标识的缺省访问意向。
隔离级别
WebSphere Application Server 扩展。使用此部分来定义 bean 级别安全标识的缺省访问意向。
安全标识(方法级别)
WebSphere Application Server 扩展。使用此部分来添加安全标识。

WS 扩展页

使用此页面来为 WebSphere Application Server 定义 Web service 客户机安全扩展。

WS 绑定页

使用此页面来为 WebSphere Application Server 定义 Web service 客户机绑定。

“调解处理程序”页面

使用此页面来编辑调解处理程序企业 bean 的部署描述符文件,并将它另存为可以导出到 WebSphere Application Server 中的 EAR 文件。

调解处理程序是充当调解中的部署和管理单元的 Java 程序。它有控制其行为的调解参数。调解处理程序是调解处理程序列表的组件。每个调解处理程序都在运行时执行一些特定消息处理,例如:
  • 将消息从一种格式变换为另一种格式。
  • 将消息传递至发送应用程序未指定的一个或多个目标。
  • 通过从数据源添加数据来增大消息。

源代码页

使用“源代码”页来查看和修改与 EJB 模块的部署描述符(ejb-jar.xml)相关联的 XML 源代码。“源代码”页是 XML 编辑器。当编辑 EJB 部署描述符编辑器时,XML 将动态更改。当您更改 XML 源代码时,EJB 部署描述符编辑器的其他页面会反映出这些更改。

在保存 EJB 部署描述符编辑器之前,不会落实在编辑器中所作的更改。如果不进行保存就关闭了编辑器,则不会落实更改。这还包括对 Java 文件、绑定文件和扩展文件的更改,可用 EJB 部署描述符编辑器来进行编辑。如果现有的 Java 编辑器当前是打开的,并且在 EJB 部署描述符编辑器中进行了更改,导致在当前打开的 Java 文件中生成代码,则这些更改将生成到打开的编辑器中。如果保存了 EJB 部署描述符编辑器,则也将保存 Java 更改。如果不进行保存就关闭了 EJB 部署描述符编辑器,则将放弃所有更改,除了当前在打开的 Java 编辑器中所作的更改之外。这些更改将保留下来,原因是对当前打开的文件存在另一个引用。仅当对 EJB 部署描述符编辑器或者它的资源没有其他引用时,才会提示您保存 EJB 部署描述符编辑器。如果在两个不同的透视图中打开了两个 EJB 部署描述符编辑器,或者在一个或多个透视图中打开了 EJB 部署描述符编辑器,则更改将出现在这两个编辑器中,但是,仅在关闭最后一个编辑器时才会提示您进行保存。

相关任务
定义 Web service 处理程序

反馈