配置 JMS 目的地
您可以配置由遵守 Java™ EE 連接器架構 (JCA) 規格之資源配接器所提供的 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 檔。 測試版不支援在「設計」視圖中編輯 Connection Factory、管理物件、啟動規格和資源配接器的部分配置。
程序
範例
使用下列範例來了解,如何以具有唯一實作類別名稱的兩種 JMS 目的地,來配置資源配接器。
在 ra.xml 檔案的下列 Snippet 中,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 檔案的下列 Snippet 中,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 配置元素的相關資訊,以了解如何置換配置元素名稱的字尾。