添加 EJB 引用

EJB 引用是客户机(或另一个 bean)用来定位企业 bean 的 home 接口的逻辑名称。可以在 EJB 模块、J2EE 应用程序客户机模块和 J2EE 动态 Web 模块中定义对企业 bean 的引用。

最佳方法是对需要引用的任何企业 bean 使用 EJB 引用。使用 EJB 引用将允许您安全地编写 Java™ 代码以查找目标企业 bean 的 home 接口,而不必担心目标企业 bean 的绑定更改。如果需要在具有不同绑定的相同服务器上安装相同 EJB 模块,则这是必需的。

在部署时,EJB 引用被绑定至目标运营环境中企业 bean 的 home。容器使应用程序的 EJB 引用在 JNDI 命名上下文中可用。

注:
  • EJB 1.1 企业 bean 和应用程序客户机模块不能引用企业 bean 的本地接口。它们必须引用远程接口。
  • 为了使模块或 bean 可以引用企业 bean 的本地接口,必须在与引用企业 bean 的模块或 bean 相同的企业应用程序(EAR)中包括所引用的 bean。
  • 如果本地或远程引用都可以实现,则应该使用本地引用以获得运行时性能优势。

对于定义的每个 EJB 引用,都会有一个 ejb-ref 元素添加到部署描述符。

要定义 EJB 引用,请执行以下操作:

  1. 从 J2EE 模块的部署描述符编辑器中打开添加引用向导
  2. 选择 EJB 引用,然后单击下一步
  3. 为指定要引用的企业 Bean(引用的 bean),选择以下其中一个选项:
    • 工作空间中的企业 bean:选择此选项以便从当前位于工作空间中的项目选择企业 bean。树形结构显示了工作空间中的 EJB 模块,且列示了 EJB 模块中可用的企业 bean。
    • 工作空间以外的企业 bean:选择此选项以便选择工作空间以外的企业 bean。
  4. 如果选择了工作空间中的企业 bean,请完成以下步骤:
    1. 展开项目树并选择要引用的企业 bean。
    2. 名称字段中,输入引用的名称,或者接受向导提供的缺省名称(推荐)。
    3. 如果要引用 EJB 2.1 bean,请在引用类型字段中指定是引用企业 bean 的本地接口还是引用它的远程接口。
      切记:
      • EJB 1.1 企业 bean 和应用程序客户机模块不能引用企业 bean 的本地接口。它们必须引用远程接口。
      • 为了使模块或 bean 可以引用企业 bean 的本地接口,必须在与引用企业 bean 的模块或 bean 相同的企业应用程序(EAR)中包括所引用的 bean。
      要点: 如果引用另一 EAR 中的企业 bean,且该 bean 的项目不包括 EJB 客户机 JAR,则工作台会为引用的 EJB 项目自动创建 EJB 客户机 JAR。这会提高运行时性能,且在不同的 EAR 文件之间可视。
  5. 如果选择了工作空间以外的企业 bean,请完成以下步骤:
    1. 名称字段中,输入引用的名称。
    2. 类型字段中,指定引用的 bean 为会话 bean 还是实体 bean。
    3. Home 字段中,为企业 bean 的远程 home 输入限定路径。单击浏览,使用选择类型对话框查找远程 home。
    4. 远程字段中,为企业 bean 的远程接口输入限定路径。单击浏览,使用选择类型对话框查找远程接口。
  6. 单击下一步以查看您所作的选择,并输入引用的描述。
  7. 单击完成
相关概念
客户机部署描述符编辑器
相关任务
定义 J2EE 模块中的引用
添加消息目标引用
添加资源管理器连接工厂引用
添加资源环境引用
添加安全角色引用
添加 Web service 引用

反馈