配置 JMS 目标

您可以配置由资源适配器提供的符合 Java™ EE 连接器体系结构 (JCA) 规范的 JMS 目标。

关于此任务

您可以配置安装的资源适配器提供的 JMS 目标、队列或主题类型的一个或多个实例。
为以下 JMS 目标类型提供了配置元素:
  • javax.jms.Destination: jmsDestination
  • javax.jms.Queue: jmsQueue
  • javax.jms.Topic: jmsTopic
注:

要为 Liberty 添加 JCA 支持,必须使用 WebSphere®® Application Server Developer Tools for Eclipse 的服务器配置编辑器的“源代码”视图或某个其他文本编辑器来编辑 server.xml 文件。Beta 中不支持在“设计”视图中编辑连接工厂、管理对象、激活规范和资源适配器的配置的部分。

过程

  1. 配置一个或多个 JMS 目标、队列或主题实例。 配置目标实例时,必须提供 properties 子元素(即使不需要覆盖任何配置属性也是如此),以将 jmsDestination、jmsQueue 或 jmsTopic 元素与特定资源适配器提供的 JMS 目标接口关联。在以下示例中,MyAdapter 资源适配器仅提供一种类型的 JMS 目标,一种类型的 JMS 队列以及一种类型的 JMS 主题:
    <jmsDestination jndiName="jms/destination1">
     <properties.MyAdapter name="DEST1"/>
    </jmsDestination>
    
    <jmsQueue jndiName="jms/queue1">
     <properties.MyAdapter queueName="QUEUE1"/>
    </jmsQueue> 
    
    <jmsTopic id="topic1" jndiName="jms/topic1">
     <properties.MyAdapter topicName="TOPIC1"/>
    </jmsTopic>
  2. (可选)如果需要,确定可用目标、队列和主题属性子元素名称。
    注: 本主题假定在服务器中已配置具有唯一标识 MyAdapter 的资源适配器,请参阅配置资源适配器主题以获取更多详细信息。

    限制:不支持在 WebSphere Development Tools (WDT) 的“设计”视图中编辑连接工厂、管理对象、激活规范和资源适配器的资源适配器配置的属性。

    • 如果资源适配器仅提供一种类型的具有 javax.jms.Destination 接口的受管对象,那么子元素名称为:properties.<rar_identifier>

    • 如果实现名称是唯一的,且不具有软件包名称,那么子元素名称为:properties.<rar_identifier>.<ImplementationName>

    • 在其他情况下,子元素名称为:properties.<rar_identifier>.<fully.qualified.InterfaceName>

    • 如果资源适配器仅提供一种类型的具有 javax.jms.Queue 接口的受管对象,那么子元素名称为:properties.<rar_identifier>

    • 如果实现名称是唯一的,且不具有软件包名称,那么子元素名称为:properties.<rar_identifier>.<ImplementationName>

    • 在其他情况下,子元素名称为:properties.<rar_identifier>.<fully.qualified.InterfaceName>

    • 如果资源适配器仅提供一种类型的具有 javax.jms.Topic 接口的受管对象,那么子元素名称为:properties.<rar_identifier>

    • 如果实现名称是唯一的,且不具有软件包名称,那么子元素名称为:properties.<rar_identifier>.<ImplementationName>

    • 在其他情况下,子元素名称为:properties.<rar_identifier>.<fully.qualified.InterfaceName>

示例

使用以下示例以了解如何配置具有两种 JMS 目标的资源适配器,这两种 JMS 目标具有唯一实现类名。

ra.xml 文件中的以下片段中,MyAdapter 资源适配器提供了具有唯一实现类名的两种 JMS 目标:

<adminobject>
<adminobject-interface>javax.jms.Destination</adminobject-interface>
<adminobject-class>com.vendor.adapter.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>queueName</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
</config-property>
 ... 
</adminobject>

<adminobject>
<adminobject-interface>javax.jms.Destination</adminobject-interface>
<adminobject-class>com.vendor.adapter.TopicImpl</adminobject-class>
<config-property>
 <config-property-name>topicName</config-property-name> 
 <config-property-type>java.lang.String</config-property-type> 
</config-property> 
...
</adminobject>
以下是此场景的服务器配置的示例:
<jmsDestination jndiName="jms/destination1">
 <properties.MyAdapter.QueueImpl queueName="D1"/>
</adminObject> 

<jmsDestination jndiName="jms/destination2">
 <properties.MyAdapter.TopicImpl topicName="D2"/> 
</jmsDestination>

使用以下示例以了解如何配置具有两种受管对象的资源适配器,这两种受管对象不具有唯一实现类名。

ra.xml 文件中的以下片段中,MyAdapter 资源适配器提供了具有不唯一实现类名的两种受管对象:

<adminobject>
<adminobject-interface>javax.jms.Queue</adminobject-interface>
<adminobject-class>com.vendor.adapter.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>queueName</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.jms.Queue</adminobject-interface>
<adminobject-class>com.vendor.adapter.advanced.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>name</config-property-name>
 <config-property-type>java.lang.String</config-property-type> 
</config-property>
 ...
</adminobject>
以下是此场景的服务器配置的示例:
<jmsQueue jndiName="jms/myQueue">
 <properties.MyAdapter.com.vendor.adapter.QueueImpl queueName="Q1"/>
</jmsQueue>

<jmsQueue jndiName="jms/myAdvancedQueue">
 <properties.MyAdapter.com.vendor.adapter.advanced.QueueImpl name="Q1"/>
</jmsQueue>
在某些情况下,可能不需要冗长配置元素名称。请参阅有关定制 JCA 配置元素的信息以了解如何覆盖配置元素名称的后缀。

用于指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_jms_config_dest
文件名:twlp_jms_config_dest.html