JMS-Ziele konfigurieren

Sie können JMS-Ziele konfigurieren, die von Ressourcenadaptern bereitgestellt werden, die der Spezifikation Java™ EE Connector Architecture (JCA) entsprechen.

Informationen zu diesem Vorgang

Sie können eine oder mehrere Instanzen von JMS-Zieltypen, JMS-Warteschlangentypen oder JMS-Topic-Typen konfigurieren, die von einem installierten Ressourcenadapter bereitgestellt werden.
Konfigurationselemente werden für die folgenden Typen von JMS-Zielen zur Verfügung gestellt:
  • javax.jms.Destination: jmsDestination
  • javax.jms.Queue: jmsQueue
  • javax.jms.Topic: jmsTopic
Anmerkung:

Zum Hinzufügen der JCA-Unterstützung für Liberty müssen Sie die Datei server.xml über die Quellenansicht des Serverkonfigurationseditors von WebSphere Application Server Developer Tools for Eclipse oder in einem anderen Texteditor bearbeiten. Die Bearbeitung von Teilen der Konfiguration für Verbindungsfactorys, Verwaltungsobjekte, Aktivierungsspezifikationen und Ressourcenadapter in der Designansicht wird in der Betaversion nicht unterstützt.

Vorgehensweise

  1. Konfigurieren Sie eine oder mehrere JMS-Ziel-, -Warteschlangen- oder -Topicinstanzen. Wenn Sie Zielinstanzen konfigurieren, müssen Sie ein Unterelement properties angeben, selbst wenn Sie keine Konfigurationseigenschaften überschreiben möchten, um das Element "jmsDestination", "jmsQueue" oder "jmsTopic" einer JMS-Zielschnittstelle zuzuordnen, die von einem bestimmten Ressourcenadapter bereitgestellt wird. Im folgenden Beispiel stellt der Ressourcenadapter MyAdapter nur einen einzigen Typ von JMS-Ziel, einen einzigen Typ von JMS-Warteschlange und einen einzigen Typ von JMS-Topic bereit:
    <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. (Optional) Identifizieren Sie, sofern erforderlich, die Namen der properties-Unterelemente für die verfügbaren Ziele, Warteschlangen und Topics.
    Anmerkung: In diesem Abschnitt wird angenommen, dass ein Ressourcenadapter mit der eindeutigen ID MyAdapter bereits im Server konfiguriert wurde. Weitere Informationen finden Sie im Abschnitt Ressourcenadapter konfigurieren.

    Einschränkung: Die Bearbeitung der Eigenschaften der Ressourcenadapterkonfiguration für Verbindungsfactorys, verwaltete Objekte, Aktivierungsspezifikationen und Ressourcenadaptern in der Designansicht von WebSphere Development Tools (WDT) wird nicht unterstützt.

    • Wenn ein Ressourcenadapter nur einen einzigen Typ verwalteter Objekte mit der Schnittstelle "javax.jms.Destination" bereitstellt, hat das Unterelement den Namen properties.<rar_identifier>.

    • Wenn der Implementierungsname ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Implementierungsname>.

    • In anderen Fällen hat das Unterelement den Namen properties.<RAR-ID>.<vollständig.qualifizierter.Schnittstellenname>.

    • Wenn ein Ressourcenadapter nur einen einzigen Typ verwalteter Objekte mit der Schnittstelle "javax.jms.Queue" bereitstellt, hat das Unterelement den Namen properties.<rar_identifier>.

    • Wenn der Implementierungsname ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Implementierungsname>.

    • In anderen Fällen hat das Unterelement den Namen properties.<RAR-ID>.<vollständig.qualifizierter.Schnittstellenname>.

    • Wenn ein Ressourcenadapter nur einen einzigen Typ verwalteter Objekte mit der Schnittstelle "javax.jms.Topic" bereitstellt, hat das Unterelement den Namen properties.<rar_identifier>.

    • Wenn der Implementierungsname ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Implementierungsname>.

    • In anderen Fällen hat das Unterelement den Namen properties.<RAR-ID>.<vollständig.qualifizierter.Schnittstellenname>.

Beispiel

Verwenden Sie das folgende Beispiel, um zu lernen, wie Ressourcenadapter mit zwei JMS-Zielen mit eindeutigen Implementierungsklassennamen konfiguriert werden.

Im folgenden Snippet aus einer Datei ra.xml stellt der Ressourcenadapter MyAdapter zwei JMS-Ziele mit eindeutigen Implementierungsklassennamen bereit:

<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>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<jmsDestination jndiName="jms/destination1">
 <properties.MyAdapter.QueueImpl queueName="D1"/>
</adminObject> 

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

Verwenden Sie das folgende Beispiel, um zu lernen, wie Ressourcenadapter mit zwei verwalteten Objekten ohne eindeutige Implementierungsklassennamen konfiguriert werden.

Im folgenden Snippet aus einer Datei ra.xml stellt der Ressourcenadapter MyAdapter zwei verwaltete Objekte mit nicht eindeutigen Implementierungsklassennamen bereit:

<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>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<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>
In manchen Szenarien können lange Konfigurationselementnamen unerwünscht sein. Wie Sie die Suffixe von Konfigurationselementnamen überschreiben, können Sie den Informationen zum Anpassen von JCA-Konfigurationselementen entnehmen.

Symbol das den Typ des Artikels anzeigt. Taskartikel

Dateiname: twlp_jms_config_dest.html