添加消息目标引用

J2EE 1.4 规范为 J2EE 组件提供了通过使用“逻辑”名称(称为消息目标引用)来引用消息目标对象的方法。可以使用部署描述符编辑器来定义消息目标引用。

消息目标引用指向 EJB 模块中的消息驱动的 bean(MDB)。

在部署时,消息目标引用被绑定至目标操作环境中的受管消息目标。

限制: 只有以下最低项目级别可以包含消息目标引用:
  • J2EE 1.4 应用程序客户机
  • EJB 2.1 项目
  • 2.4 Web 应用程序

对于定义的每个消息目标引用,都会有一个 message-destination-ref 元素添加到该应用程序组件的部署描述符。消息目标引用的作用域为定义这些引用的应用程序组件,因此,在运行时,其它应用程序组件不能访问它们。其它组件可以定义同名的消息目标引用,而不会引起名称冲突。

要定义消息目标引用,请执行以下操作:

  1. 从 J2EE 模块的部署描述符编辑器中打开添加引用向导
  2. 选择消息目标引用,并单击下一步
  3. 在项目树中,请选择提供您要引用的消息目标对象的消息驱动企业 bean。
  4. 名称字段中,为引用指定名称,或者接受向导提供的缺省名称(建议)。名称字段中输入的值用于部署描述符中的 message-destination-ref-name 条目。

    消息目标引用的名称相对于 java:comp/env 上下文。例如,该名称应为 jms/BidQueue,而不是 java:comp/env/jms/BidQueue

  5. 单击下一步
  6. 类型字段中,选择所引用目标的期望类型。 例如,对于 JMS 目标,类型可为 javax.jms.Queue。 在此字段中输入的值用于部署描述符的 message-destination-ref-type 条目。
  7. 使用字段中,指示消息目标是使用消息还是生成消息。 在此处的指定的值用于部署描述符中的 message-destination-ref-usage 条目。
  8. 描述文本区域中,输入引用的描述。
  9. 单击完成
相关概念
客户机部署描述符编辑器
相关任务
定义 J2EE 模块中的引用
添加 EJB 引用
添加资源管理器连接工厂引用
添加资源环境引用
添加安全角色引用
添加 Web service 引用
使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.