添加消息目标引用

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

消息目标引用指向在 EJB 模块、应用程序客户机模块或动态 Web 模块中定义的消息目标。

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

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

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

消息目标链接(message-destination-link 元素)可以在消息驱动的 bean 和消息目标引用上定义。企业 bean 的 message-destination-link 元素的 message-destination-ref 元素产生消息以链接至目标。message-destination-link 元素的值是消息目标的名称。

<message-destination-ref>
	<description></description>
	<message-destination-ref-name>MyDest_Ref</message-destination-ref-name>
	<message-destination-type>java.net.URL</message-destination-type>
	<message-destination-usage>Produces</message-destination-usage>
	<message-destination-link>MyDest</message-destination-link>
</message-destination-ref>

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

  1. 从 J2EE 模块的部署描述符编辑器中打开添加引用向导
  2. 选择消息目标引用,并单击下一步
  3. 名称字段中,指定引用的名称。名称字段中输入的值用于部署描述符中的 message-destination-ref-name 条目。

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

  4. 在项目树中,选择想要引用的消息目标。可以单击新目标以将新消息目标添加至当前项目的部署描述符。
    注: 该向导允许您完成但不将引用添加至消息目标,但稍后您将需要在部署描述符中添加链接。
  5. 单击下一步
  6. 类型字段中,选择所引用目标的期望类型。 例如,对于 JMS 目标,类型可为 javax.jms.Queue。 在此字段中输入的值用于部署描述符的 message-destination-ref-type 条目。
  7. 使用字段中,指示消息目标是使用消息还是生成消息。 在此处的指定的值用于部署描述符中的 message-destination-ref-usage 条目。
  8. 描述文本区域中,输入引用的描述。
  9. 单击完成
相关概念
客户机部署描述符编辑器
相关任务
定义 J2EE 模块中的引用
添加 EJB 引用
添加资源管理器连接工厂引用
添加资源环境引用
添加安全角色引用
添加 Web service 引用
添加消息目标

反馈