Configuración de destinos de JMS

Puede configurar los destinos de JMS que proporcionan los adaptadores de recursos que cumplan con la especificación JCA (Java EE Connector Architecture.

Acerca de esta tarea

Puede configurar una o más instancias de los tipos destino de JMS, cola o tema que se proporcionan mediante un adaptador de recursos instalado.
Se proporcionan elementos de configuración para los siguientes tipos de destinos de JMS:
  • javax.jms.Destination: jmsDestination
  • javax.jms.Queue: jmsQueue
  • javax.jms.Topic: jmsTopic
Nota:

Para añadir soporte JCA para Liberty, debe editar el archivo server.xml utilizando la vista de origen del editor de configuración de servidor de WebSphere® Application Server Developer Tools for Eclipse o algún otro editor de texto. La edición de partes de la configuración de fábricas de conexiones, objetos administrativos, especificaciones de activación y adaptadores de recursos en la vista Diseño no recibe soporte en la versión Beta.

Procedimiento

  1. Configure una o más instancias de destino de JMS, cola o tema. Cuando configure las instancias de destino, debe suministrar un subelemento properties, incluso si no desea alterar temporalmente ninguna propiedad de configuración, para asociar el elemento jmsDestination, jmsQueue o jmsTopic a una interfaz de destino de JMS que proporciona un adaptador de recursos en particular. En el ejemplo siguiente, el adaptador de recursos MyAdapter proporciona sólo un tipo de destino de JMS, un tipo de cola JMS y un tipo de tema 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. (Opcional) Si es necesario, identifique el destino disponible, la cola disponible y los nombres del subelemento de propiedad de tema.
    Nota: En este tema se supone que ya se ha configurado un adaptador de recursos con un identificador exclusivo de MyAdapter en el servidor, consulte el tema Configuración de adaptadores de recursos para ver más detalles.

    Limitación: No se da soporte a la edición de propiedades de la configuración del adaptador de recursos para las fábricas de conexiones, los objetos administrativos, las especificaciones de activación y los adaptadores de recursos en la vista Diseño de WebSphere Development Tools (WDT).

    • Si un adaptador de recursos proporciona exactamente un tipo de objeto administrado con la interfaz javax.jms.Destination, el nombre del subelemento será: properties.<identificador_rar>

    • Si el nombre de implementación es único sin el nombre de paquete, el nombre del subelemento será: properties.<identificador_rar>.<nombre_implementación>

    • En otros casos, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz_completo>

    • Si un adaptador de recursos proporciona exactamente un tipo de objeto administrado con la interfaz javax.jms.Queue, el nombre del subelemento será: properties.<identificador_rar>

    • Si el nombre de implementación es único sin el nombre de paquete, el nombre del subelemento será: properties.<identificador_rar>.<nombre_implementación>

    • En otros casos, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz_completo>

    • Si un adaptador de recursos proporciona exactamente un tipo de objeto administrado con la interfaz javax.jms.Topic, el nombre del subelemento será: properties.<identificador_rar>

    • Si el nombre de implementación es único sin el nombre de paquete, el nombre del subelemento será: properties.<identificador_rar>.<nombre_implementación>

    • En otros casos, el nombre del subelemento es: properties.<identificador_rar>.<nombre_interfaz_completo>

Ejemplo

Utilice el ejemplo siguiente para aprender a configurar adaptadores de recursos con dos destinos de JMS con nombres de clase de implementación exclusivos

En el siguiente fragmento de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos destinos de JMS con nombres de clase de implementación únicos:

<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>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<jmsDestination jndiName="jms/destination1">
 <properties.MyAdapter.QueueImpl queueName="D1"/>
</adminObject> 

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

Utilice el ejemplo siguiente para aprender a configurar adaptadores de recursos con dos objetos administrados sin nombres de clase de implementación que sean exclusivos.

En el siguiente fragmento de un archivo ra.xml, el adaptador de recursos MyAdapter proporciona dos objetos administrados con nombres de clase de implementación no únicos:

<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>
A continuación se proporciona un ejemplo de una configuración de servidor para este escenario.
<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>
En algunos escenarios, puede que se den nombres de elementos de configuración demasiado lentos, no deseables. Consulte la información sobre la personalización de los elementos de configuración JCA para aprender a alterar temporalmente los sufijos de los nombres de elementos de configuración.

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_jms_config_dest
Nombre de archivo:twlp_jms_config_dest.html