Configure los escuchas de punto final SOAP sobre JMS (Java™ Message Service) síncronas para utilizar un proveedor de JMS, ya sea el proveedor de mensajería predeterminado, u otro proveedor como, por ejemplo, el proveedor de mensajería WebSphere MQ, para pasar mensajes SOAP sobre JMS.
Acerca de esta tarea
Si está definiendo un escucha de punto final SOAP sobre JMS, en primer lugar, debe configurar los siguientes recursos JMS para el proveedor de JMS:
- Destino de cola de bus de integración de servicios (para el proveedor de mensajería predeterminado)
- fábrica de conexiones de cola JMS
- Destino de cola JMS
- Especificación de activación JMS o puerto de escucha
Nota:
Los puertos de escucha se han estabilizado. Para obtener más información, consulte el artículo sobre características estabilizadas. Siempre que sea posible, debe desplegar su aplicación de escucha de punto final de forma que utilice una especificación de activación.
Sólo puede utilizar las especificaciones de activación con el proveedor de mensajería predeterminado; puede utilizar las especificaciones de activación o bien los puertos de escucha con el proveedor de mensajería WebSphere MQ.
Procedimiento
- Utilice la consola administrativa para crear y configurar las fábricas de conexiones de cola y los destinos de cola.
Si desea más información sobre cómo hacerlo para el proveedor de mensajería, consulte los enlaces relacionados.
Cree una fábrica de conexiones de la cola y un destino de cola para cada escucha de punto final que tenga previsto configurar.
Por ejemplo, si tiene previsto configurar los escuchas de punto final SOAP sobre JMS proporcionados con WebSphere Application Server, cree dos fábricas de conexiones (una para escucha de punto final) y dos colas. Los recursos JMS y los nombres JNDI que los escuchas de punto final SOAP
sobre JMS esperan de forma predeterminada se proporcionan en la tabla siguiente. Si utiliza recursos y nombres diferentes en este paso, cambie los valores predeterminados al configurar posteriormente el escucha de punto final.
Tabla 1. Recursos JMS y nombres JNDI esperados. La primera columna de esta tabla muestra los recursos JMS, la segunda columna muestra los nombres JNDI predeterminados esperados
para el escucha de punto final 1, la tercera columna muestra el nombre JNDI predeterminado esperado para el escucha de punto final 2,
la cuarta columna muestra el nombre de cola esperado para la escucha de punto final 1, y la quinta columna muestra el nombre de cola
esperado para la escucha de punto final 2. recurso JMS |
nombre JNDI predeterminado (escucha de punto final 1) |
nombre JNDI predeterminado (escucha de punto final 2) |
nombre de cola (escucha de punto final 1) |
nombre de cola (escucha de punto final 2) |
fábrica de conexiones de cola JMS |
jms/SOAPJMSFactory1 |
jms/SOAPJMSFactory2 |
No es necesario |
No es necesario |
Destino de cola JMS |
jms/SOAPJMSQueue1 |
jms/SOAPJMSQueue2 |
Definida por usuario (por ejemplo: SOAPJMSDestQueue1) |
Definida por usuario (por ejemplo: SOAPJMSDestQueue2) |
- Configure el destino subyacente para cada cola JMS.
Configure estos destinos tal como se describe en la documentación del proveedor de JMS. Si utiliza el proveedor de mensajería predeterminado, utilice la consola
administrativa para añadir los dos nuevos nombres de cola especificados en la
tabla anterior como destinos del servidor de aplicaciones, tal como se describe
en Creación de una cola para la mensajería punto a punto. El identificador del destino debe coincidir con el definido por el usuario como el nombre de cola en la tabla anterior.
- Configure los detalles de despliegue de la aplicación.
Si utiliza especificaciones de activación, utilice la consola administrativa para
crear y configurar las especificaciones de activación tal como se describe en
Configuración de una especificación de activación para el proveedor de mensajería predeterminado o
Creación de una especificación de activación para el proveedor de mensajería WebSphere MQ. Cree dos especificaciones de activación, una para cada escucha de punto final. Los recursos JMS predeterminados y los nombres asociados que los
escuchas de punto final SOAP sobre JMS síncronos esperan se proporcionan en la tabla
siguiente. No obstante, puede utilizar cualquier nombre JNDI para la
especificación de activación, siempre y cuando el archivo EAR tenga la misma
referencia JNDI en el panel
"Enlace de enterprise beans con nombres de puerto
de escucha o nombres JNDI de especificación de activación" de la consola
administrativa. Si utiliza recursos y nombres diferentes en este paso, cambie los valores predeterminados al configurar posteriormente el escucha de punto final. También debe tener y, a continuación, reiniciar el servidor de aplicaciones.
Tabla 2. Recurso JMS predeterminado y nombre esperado asociado. La primera columna de esta tabla muestra los recursos JMS, la segunda columna muestra los nombres JNDI predeterminados esperados
para el escucha de punto final 1, la tercera columna muestra el nombre JNDI predeterminado esperado para el escucha de punto final 2,
la cuarta columna muestra el nombre de cola esperado para la escucha de punto final 1, y la quinta columna muestra el nombre de cola
esperado para la escucha de punto final 2. recurso JMS |
nombre JNDI predeterminado (escucha de punto final 1) |
nombre JNDI predeterminado (escucha de punto final 2) |
nombre JNDI de destino (escucha de punto final 1) |
nombre JNDI de destino (escucha de punto final 2) |
especificación de activación |
eis/SOAPJMSChannel1 |
eis/SOAPJMSChannel2 |
jms/SOAPJMSQueue1 |
jms/SOAPJMSQueue2 |
Si utiliza puertos de escucha con cualquier proveedor de JMS soportado, utilice la consola administrativa para crear y configurar los puertos de escucha en el servicio de escucha de mensajes tal como se describe en
Adición de un nuevo puerto de escucha.
Cree dos puertos de escucha (uno para cada
escucha de punto final). Los recursos JMS predeterminados y los nombres asociados que los
escuchas de punto final SOAP sobre JMS suministrados esperan se proporcionan en la tabla
siguiente. Si utiliza recursos y nombres diferentes en este paso, cambie los valores predeterminados al configurar posteriormente el escucha de punto final.
Tabla 3. Recursos JMS predeterminados y nombres esperados. La primera columna de esta tabla muestra los recursos JMS, la segunda columna muestra los nombres JNDI predeterminados esperados
para el escucha de punto final 1, la tercera columna muestra el nombre JNDI predeterminado esperado para el escucha de punto final 2,
la cuarta columna muestra el nombre de cola esperado para la escucha de punto final 1, y la quinta columna muestra el nombre de cola
esperado para la escucha de punto final 2. recurso JMS |
nombre predeterminado (para su utilización con escucha de punto final SOAP sobre JMS
1) |
nombre predeterminado (para su utilización con escucha de punto final SOAP sobre JMS
2) |
puerto de escucha |
SOAPJMSPort1 |
SOAPJMSPort2 |
fábrica de conexiones |
jms/SOAPJMSFactory1 |
jms/SOAPJMSFactory2 |
destino |
jms/SOAPJMSQueue1 |
jms/SOAPJMSQueue2 |
- Guarde los cambios en la configuración maestra.
- Enlace los recursos JMS deteniendo y luego reiniciando el servidor
de aplicaciones.