Configuración de la política de transporte JMS (Java Message Service)

Puede definir la configuración de la política de transporte Java™ Message Service (JMS) si está utilizando SOAP sobre JMS con la API de Java para aplicaciones JAX-WS (servicios web XML).

Antes de empezar

Puede configurar algunos valores de las políticas para los conjuntos de políticas personalizados. Los conjuntos de políticas predeterminados proporcionados no se pueden editar. Debe crear una copia del conjunto de políticas predeterminado o crear un conjunto de políticas nuevo para poder especificar las políticas para el mismo.

Acerca de esta tarea

Cuando utilice el transporte SOAP sobre JMS con las aplicaciones JAX-WS, puede personalizar el transporte configurando la política de transporte JMS. El transporte SOAP sobre JMS proporciona una alternativa a HTTPS para transportar solicitudes SOAP y mensajes de respuesta entre clientes y servidores. Consulte la documentación sobre cómo utilizar SOAP sobre JMS para transportar servicios web para obtener más información acerca de este protocolo de transporte.

Sólo puede configurar una política mediante un conjunto de políticas. Por lo tanto, para poder configurar la política de transporte JMS debe existir un conjunto de políticas que contenga la política de transporte JMS. Para personalizar un conjunto de políticas que contenga la política de transporte JMS, debe crear antes un conjunto de políticas y añadir la política de transporte JMS al nuevo conjunto de políticas.

Utilice el panel de configuración de la política de transportes JMS para personalizar los valores de las propiedades de la política de transportes JMS, como el valor de tiempo de espera excedido de la solicitud. Los valores personalizados de la política de transportes JMS se aplican ahora al conjunto de políticas que contiene dicha política de transportes JMS personalizada. Puede conectar el conjunto de políticas que contiene su política de transporte personalizada JMS a la aplicación JAX-WS, sus servicios, sus puntos finales o sus operaciones. Este cambio afecta a todas las aplicaciones JAX-WS a las que está conectado ese conjunto de políticas. Para aprender más sobre la conexión de conjuntos de políticas a aplicaciones, consulte la documentación para la gestión de conjuntos de políticas para proveedores y clientes de servicios en el nivel de aplicación.

Procedimiento

  1. Cree un conjunto de políticas que contenga la política de transporte JMS.
    1. Cree un conjunto de políticas personalizado. En la consola de administración, pulse Servicios > Conjuntos de políticas > conjuntos de políticas de servicios. En este panel puede crear un conjunto de políticas nuevo, importar una copia de un conjunto de políticas del repositorio predeterminado o puede importar un conjunto de políticas existentes desde la ubicación especificada.
    2. Añada la política de transporte JMS al conjunto de políticas. En la consola administrativa, pulse Servicios > Conjuntos de políticas > Conjuntos de políticas de aplicación > nombre_conjunto_políticas. En la colección de políticas, pulse Transporte JMS. La ventana del transporte JMS muestra las opciones para configurar los valores de JMS para la política del transporte.
    3. Especifique las propiedades de la conexión JMS para las solicitudes de transporte JMS. Los campos siguientes configuran las características de JMS para este transporte:
      Tiempo de espera de petición
      Especifica si se ha de habilitar un valor de tiempo de espera de solicitud. El valor de tiempo de espera de solicitud es el período de tiempo que espera el cliente una respuesta después de enviar la solicitud al servidor. El rango es de 0 a 2147483647.
      Permitir la mensajería transaccional para las operaciones unidireccionales y asíncronas
      Especifica que se debe habilitar un cliente para utilizar las transacciones en las solicitudes unidireccionales o bidireccionales asíncronas. Seleccione este recuadro de selección para habilitar la mensajería transaccional.
      Cuando se selecciona esta opción, el entorno de ejecución del cliente intercambia los mensajes SOAP de solicitud y respuesta con el servidor a través del transporte JMS de modo transaccional si el cliente opera bajo una transacción. Este proceso indica que se utiliza la transacción del cliente para enviar el mensaje de solicitud SOAP a la cola o tema de destino y el servidor recibe el mensaje de solicitud sólo después de que el cliente confirma la transacción. De la misma forma, el servidor recibe el mensaje de solicitud bajo el control de una transacción gestionada por contenedor y envía el mensaje de respuesta, si procede, de vuelta al cliente utilizando la misma transacción. El cliente sólo recibe el mensaje de respuesta después de haberse confirmado la transacción del servidor.
      Si no se selecciona esta opción, los entornos de ejecución del cliente y del servidor realizarán operaciones de mensajería de modo no transaccional, ya que las transacciones se suspenden de forma temporal para la solicitud JMS. Las transacciones se vuelven a habilitar después de que se haya completado la solicitud.
      Supported configurations Supported configurations: Las operaciones de mensajería transaccional no están soportadas para operaciones síncronas bidireccionales, ya que esto provoca una condición de punto muerto.sptcfg
  2. Personalice los enlaces del proveedor del transporte JMS.
    1. Vaya a los enlaces del proveedor de transporte JMS. En la consola administrativa, pulse Servicios > Conjuntos de políticas > Enlaces generales de conjunto de políticas de proveedor > nombre_enlace_conjunto_políticas_proveedor > Transporte JMS.

      La ventana de enlaces de proveedor de transporte JMS muestra las opciones para definir la autenticación básica para las respuestas de servicio asíncronas y las propiedades personalizadas para la configuración del enlace del proveedor de servicio JMS.

    2. Especifique las propiedades de la autenticación básica para las respuestas de servicio asíncronas.

      Puede utilizar los enlaces de política de proveedor de transporte JMS para configurar un servicio que utilice el transporte JMS para devolver al cliente los mensajes de respuesta asíncronos. El entorno de ejecución del servidor de aplicaciones utiliza el nombre de usuario y la contraseña que configura cuando se conecta al proveedor de mensajería JMS y esta configuración habilita el servicio para enviar un mensaje de respuesta asíncrono al cliente de forma segura.

      Los campos siguientes determinan los requisitos de autenticación para las respuestas del servidor:

      Nombre de usuario
      Especifica el nombre del usuario para las respuestas de servicio asíncronas para el proveedor de servicios.
      Password
      Especifica un contenedor para la contraseña de las respuestas de servicio asíncronas del proveedor de servicios. En este campo puede especificar o editar la contraseña. La contraseña real se oculta.
      Confirmar contraseña
      Especifica un marcador para la contraseña de las respuestas del servicio asíncronas del proveedor de servicios que debe coincidir con la del campo Contraseña. La contraseña real se oculta.
  3. Personalice los enlaces del cliente de transporte JMS.
    1. Vaya a los enlaces del cliente de transporte JMS. En la consola de administración, pulse Servicios > Conjuntos de políticas > Enlaces generales de conjuntos de políticas de cliente > nombre_enlace_conjunto_políticas_cliente > transporte JMS.

      La ventana de enlaces de proveedor de transporte JMS muestra las opciones para definir la autenticación básica para las solicitudes del servicio de salida y las propiedades personalizadas para la configuración de enlaces de cliente JMS.

    2. Especifique la autenticación básica para las propiedades Solicitudes de servicio de salida.

      Puede utilizar los enlaces de políticas de cliente de transporte JMS para configurar un cliente que utilice el transporte JMS para enviar un mensaje de solicitud al servidor. El entorno de ejecución del cliente utiliza el nombre de usuario y la contraseña que se han configurado al conectarse al proveedor de mensajería JMS. Esta configuración permite que el cliente envíe mensajes de solicitud al servidor de una forma segura.

      Los campos siguientes determinan los requisitos de autenticación para las solicitudes enviadas al servidor:

      Nombre de usuario
      Especifica el nombre de usuario que utiliza el tiempo de ejecución del cliente al conectarse al proveedor de mensajería JMS para enviar una solicitud de salida al tema o la cola de destino. Escriba un nombre de usuario en este campo.
      Password
      Especifica un marcador para la contraseña que utiliza el tiempo de ejecución del cliente al conectarse al proveedor de mensajería JMS para enviar una solicitud de salida al tema o la cola de destino. En este campo puede especificar o editar una contraseña. La contraseña real se oculta.
      Confirmar contraseña
      Especifica un marcador para la contraseña que utiliza el tiempo de ejecución del cliente al conectarse al proveedor de mensajería JMS para enviar una solicitud de salida al tema o la cola de destino. Vuelva a entrar la contraseña en este campo. Esta contraseña debe coincidir con la del campo Contraseña. La contraseña real se oculta.
  4. Establezca la propiedad personalizada JVM com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse en true.

    Consulte el tema Propiedades personalizadas de la máquina virtual Java para ver una descripción sobre cómo especificar esta propiedad.

  5. Guarde los cambios.

Resultados

Cuando haya personalizado la política de transporte JMS, el conjunto de políticas asociado utilizará esta política para configurar el comportamiento de tiempo de ejecución del transporte SOAP sobre JMS.

Ejemplo

Puede conectar conjuntos de políticas a una aplicación, sus servicios, sus puntos finales o sus operaciones. En este caso de ejemplo, imagine que tiene dos clientes de servicio JAX-WS para su aplicación, pero desea utilizar distintos valores de tiempo de espera excedido de las solicitudes de transporte JMS para cada cliente del servicio. Para modificar los valores de tiempo de espera excedido de las solicitudes JMS, puede editar los valores de la política de transporte JMS contenida en el conjunto de políticas que está conectado a la aplicación o, en este caso, al cliente de servicio. Este cambio afecta a todas las aplicaciones a las que está conectado el conjunto de políticas que contiene la política de transporte JMS personalizada.

En este ejemplo se describen los pasos para configurar distintos valores de tiempo de espera excedido de solicitudes para los clientes de servicio desplegados en el mismo servidor de aplicaciones. Este ejemplo incluye las presunciones siguientes:
  • Existen dos clientes de servicio JAX-WS, ServiceClient1 y ServiceClient2, que se despliegan en el servidor de aplicaciones.
  • La política de transportes JMS no se ha conectado previamente a estas aplicaciones.
  1. Cree dos nuevos conjuntos de políticas y añádales la política de transporte JMS. Por ejemplo: JMSServiceClient1Policy y JMSServiceClient2Policy
    1. Pulse Servicios > Conjuntos de políticas > Conjuntos de políticas de aplicación > Nuevo .
    2. Especifique el nombre del nuevo conjunto de políticas de aplicaciones, JMSServiceClient1Policy.
    3. En la colección de políticas, pulse Añadir > Transporte JMS.
    4. Pulse Aplicar y Guardar para guardar los cambios realizados en la configuración maestra.
    5. Repita estos pasos para crear JMSServiceClient2Policy.
  2. Personalice los valores de la política de transporte JMS para los conjuntos de políticas JMSServiceClient1Policy y JMSServiceClient2Policy que acaba de crear. Por ejemplo, establezca el valor de tiempo de espera de la solicitud en 180 segundos para la política de transporte JMS contenida en JMSServiceClient1Policy. La política de transporte JMS contenida en JMSServiceClient2Policy especifica 300 segundos como valor de tiempo de espera de la solicitud.
    1. Pulse Servicios > Conjuntos de políticas > Conjuntos de políticas de aplicación > JMSServiceClient1Policy .
    2. En la colección de Políticas, pulse Transporte JMS.
    3. Desde el panel de configuración de la configuración de políticas de transporte JMS, especifique 180 segundos como valor de tiempo de espera excedido de la solicitud.
    4. Pulse Aplicar y Guardar para guardar los cambios realizados en la configuración maestra.
    5. Pulse Servicios > Conjuntos de políticas > Conjuntos de políticas de aplicación > JMSServiceClient2Policy .
    6. En la colección de Políticas, pulse Transporte JMS.
    7. Desde el panel de configuración de la política de transporte JMS, especifique 300 segundos para el valor de tiempo de espera excedido de la solicitud.
    8. Pulse Aplicar y Guardar para guardar los cambios realizados en la configuración maestra.
  3. Conecte la política de transporte JMS personalizada, JMSServiceClient1Policy, a su aplicación, ServiceClient1. Del mismo modo, conecte la política de transporte JMS personalizada, JMSServiceClient2Policy, a ServiceClient2.
    1. Pulse Servicios > Clientes de servicio > ServiceClient1.
    2. En la colección de conexiones del conjunto de políticas, seleccione el servicio, ServiceClient1.
    3. Pulse Conectar conjunto de políticas de cliente y, a continuación, JMSServiceClient1Policy.
    4. Pulse Guardar para guardar los cambios en la configuración maestra.
    5. Pulse Servicios > Clientes de servicio > ServiceClient2.
    6. En la colección de conexiones del conjunto de políticas, seleccione el servicio, ServiceClient1.
    7. Pulse Conectar conjunto de políticas de cliente y, a continuación, JMSServiceClient2Policy.
    8. Pulse Guardar para guardar los cambios en la configuración maestra.

Como resultado, la aplicación ServiceClient1 tiene ahora JMSServiceClient1Policy conectado y las sesiones de JMS utilizan un tiempo de espera de solicitudes de 180 segundos. La aplicación ServiceClient2 tiene la política, JMSServiceClient2Policy, conectada y las sesiones JMS utilizan un tiempo de espera de 300 segundos.

Qué hacer a continuación

Puede personalizar otras políticas que necesite para su aplicación.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsspsptjms
File name: twbs_wsspsptjms.html