[8.5.5.2 或更新版本]Liberty 儲存庫

配置 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 檔。測試版不支援在「設計」視圖中編輯 Connection Factory、管理物件、啟動規格和資源配接器的部分配置。

程序

  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. (選用)若有需要,請識別可用的目的地、佇列和主題內容子元素名稱。
    註: 此主題假設已在伺服器中配置唯一 ID 為 MyAdapter 的資源配接器,請參閱配置資源配接器主題,以取得進一步的詳細資料

    限制:不支援在 WebSphere® Development Tools (WDT) 的「設計」視圖中,針對 Connection Factory、管理物件、啟動規格和資源配接器,編輯資源配接器配置的內容。

    • 如果資源配接器提供正好一種受管理物件類型,且其具有 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 目的地,來配置資源配接器。

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 配置元素的相關資訊,以了解如何置換配置元素名稱的字尾。

指示主題類型的圖示 作業主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_jms_config_dest
檔名:twlp_jms_config_dest.html