Utilice el nodo SOAPAsyncResponse conjuntamente con el nodo SOAPAsyncRequest para construir un par de flujos de mensajes que llamen a un servicio web de forma asíncrona.
El nodo SOAPAsyncRequest envía una solicitud de servicio web, pero el nodo no espera a que se reciba la respuesta de servicio web asociada. Sin embargo, el nodo SOAPAsyncRequest espera el acuse de recibo de HTTP 202 antes de continuar con el flujo de mensajes y el nodo SOAPAsyncRequest se bloquea si no se recibe el acuse de recibo. El nodo SOAPAsyncResponse, que puede estar en un flujo de mensajes separado, recibe la respuesta del servicio web. Los nodos se utilizan como par, y correlacionan las respuestas con las solicitudes originales.
El analizador SOAP invoca el analizador XMLNSC para que analice el contenido XML del servicio web SOAP, y valide el cuerpo XML del servicio web SOAP. Las opciones del analizador SOAP se pasan al analizador XMLNSC. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.
El nodo SOAPAsyncResponse se encuentra en el cajón Servicios web de la paleta y se representa en el WebSphere Message Broker Toolkit mediante el siguiente icono:
La configuración del nodo SOAPAsyncResponse no está basada en WSDL, aunque la lista de 'Cabeceras debe reconocer' configurada en el nodo SOAPAsyncRequest correspondiente es aplicable al nodo SOAPAsyncResponse.
La mayoría de las opciones de configuración para este nodo se establecen en el nodo SOAPAsyncRequest emparejado, incluidas las propiedades Destino de restitución y Umbral de restituciones. No se envía ningún error SOAP cuando se alcanza el umbral de restituciones.
LocalEnvironment.SOAP.Response.UserContext
Si alguna de las propiedades de entorno local LocalEnvironment.Destination.SOAP.Response.ReplyIdentifier o LocalEnvironment.Destination.HTTP.RequestIdentifier se han proporcionado al nodo SOAPAsyncRequest emparejado, éstas se pasan al entorno local para el nodo SOAPAsyncResponse.
Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.
El nodo SOAPAsyncResponse puede recibir una respuesta que tenga una cabecera Content-Encoding de gzip o deflate. Cuando se recibe una respuesta de este tipo, el contenido se descodifica y la cabecera Content-Encoding se elimina.
Cuando haya colocado una instancia del nodo SOAPAsyncResponse en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se muestran en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
Los terminales del nodo SOAPAsyncResponse se describen en la siguiente tabla.
Terminal | Descripción |
---|---|
Failure (de anomalías) | El terminal de salida al que se direcciona un mensaje de respuesta SOAP asíncrono si se detecta una anomalía cuando el mensaje recibido se propaga al flujo de salida como, por ejemplo, en el caso de una anomalía de validación de mensaje. |
Out (de salida) | El terminal de salida al que se direcciona el mensaje de respuesta SOAP asíncrono si se ha recibido satisfactoriamente y se requiere proceso adicional dentro del flujo de mensajes. Si no se producen errores dentro del nodo, un mensaje de respuesta SOAP de ninguna anomalía recibido de un recurso externo siempre se envía primero al terminal de salida. |
Fault (de defectos) | El terminal de salida al que se direcciona una respuesta de error SOAP asíncrono si se ha recibido satisfactoriamente y se requiere proceso adicional dentro de este flujo de mensajes. |
Catch (de captación) | El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta. |
Las tablas siguientes describen las propiedades del nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).
Las propiedades de descripción del nodo SOAPAsyncResponse están descritas en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo: SOAPAsyncResponse | El nombre del nodo. |
Descripción corta | No | No | Ninguno | Descripción breve del nodo. |
Descripción larga | No | No | Ninguno | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Las propiedades básicas del nodo SOAPAsyncResponse se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Identificador exclusivo | Sí | No | Especifique el fragmento de URL exclusivo que es común al par de nodos SOAPAsyncRequest y SOAPAsyncResponse. | asyncRequestCorrelator |
La propiedad de Transacciones del nodo SOAPAsyncResponse se describe en la siguiente tabla. Este valor no se aplica cuando el nodo utiliza transporte HTTP.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Modalidad de transacción | Sí | No | No | Esta propiedad controla si el mensaje se recibe bajo una transacción JMS. Los valores válidos son Sí y No. Seleccione No para recibir el mensaje utilizando una sesión JMS no transaccional. Seleccione Sí para recibir el mensaje utilizando una sesión JMS transaccional. La transacción JMS puede ser local o coordinada XA. Para utilizar una transacción coordinada XA, mediante una sesión JMS XA, también debe seleccionar la propiedad de flujo de mensajes Transacción coordinada en las propiedades del archivo BAR. |
La propiedad Avanzadas del nodo SOAPAsyncResponse se describe en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Establecer lista de destinos | No | No | Seleccionado | Esta propiedad indica si se debe añadir la operación SOAP entrante a la lista de destinos de direccionamiento a etiqueta. |
Prefijo de etiqueta | No | No | Utilice esta propiedad para añadir un prefijo al nombre de la operación SOAP en la lista de destinos. Debe añadir un Prefijo de etiqueta si desea utilizar varios nodos SOAPAsyncResponse en el mismo flujo de mensajes sin causar un conflicto en sus correspondientes nodos Label. De forma predeterminada, el prefijo es una serie vacía de forma que el nombre de operación y el nombre de etiqueta son idénticos. Esta propiedad no está disponible si la propiedad Establecer lista de destinos no está seleccionada. | |
Colocar las cabeceras WS-Addressing en el Entorno local | No | No | Deseleccionado | Esta propiedad especifica si el nodo pone las cabeceras WS-Addressing del mensaje de respuesta en el árbol del entorno local. Las cabeceras WS-Addressing no son accesibles para el flujo si este recuadro está deseleccionado porque, de forma predeterminada, se procesan y se eliminan todas las cabeceras. |
Las propiedades de instancias del nodo SOAPAsyncResponse se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Agrupación de instancias adicionales | No | Sí | Utilizar agrupación asociada al flujo de mensajes | La agrupación de la que se obtienen instancias adicionales.
|
componentLevel |
Instancias adicionales | No | Sí | 0 | El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales se establece en Utilizar agrupación asociada al nodo. De forma predeterminada, no se proporcionan instancias adicionales al nodo. | additionalInstances |
En la tabla siguiente se describen las propiedades de Análisis de mensajes de respuesta del nodo SOAPAsyncResponse. El nodo SOAPAsyncResponse establece estas propiedades automáticamente; no las puede establecer el usuario.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Dominio de mensajes | No | No | SOAP | Dominio que se utiliza para analizar el mensaje de
respuesta. De forma predeterminada, el mensaje que se propaga desde el nodo SOAPAsyncResponse está en el dominio de SOAP. No puede especificar un dominio distinto. Para obtener más información, consulte
Analizador y dominio SOAP. Las propiedades de Análisis de mensaje de respuesta se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en la modalidad de pasarela. |
Conjunto de mensajes | Sí | No | Se establece automáticamente en la propiedad Nombre de archivo WSDL que proporciona el nodo SOAPAsyncRequest. | Nombre del conjunto de mensajes en el que se define el mensaje
de respuesta. Conjunto de mensajes se
establece automáticamente en el conjunto de mensajes que contiene el archivo WSDL
que está configurado en el nodo
SOAPAsyncRequest correspondiente. Si establece esta propiedad y, a continuación, actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes. Las propiedades de Análisis de mensaje de respuesta se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en la modalidad de pasarela. |
Tipo de mensaje | No | No | Nombre del mensaje de respuesta. El nodo detecta automáticamente el tipo de mensaje. Esta propiedad no se puede establecer. | |
Formato del mensaje | No | No | Nombre del formato físico del mensaje de respuesta. Esta propiedad no se puede establecer. |
Las propiedades Opciones de análisis del nodo SOAPAsyncResponse se describen en la siguiente tabla. Las propiedades se pasan al analizador XMLNSC.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | No | No | A petición | Esta propiedad controla cuándo se analiza un mensaje de respuesta. Los valores válidos son A petición, Inmediato
y Completo. De forma predeterminada, la temporización de análisis se establece en A petición, lo que hace que se retrase el análisis del mensaje de entrada. Para obtener una descripción completa de esta propiedad, consulte Análisis a petición. |
Crear árbol utilizando tipos de datos de esquema XML | No | No | Seleccionado | Esta propiedad controla si el analizador XMLNSC crea
elementos de sintaxis en el árbol de mensajes con tipos de datos obtenidos
del esquema XML. Esta propiedad se ignora cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en la modalidad de pasarela. |
Retener el contenido mixto | No | No | Deseleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra texto mixto en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento. |
Retener los comentarios | No | No | Deseleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra comentarios en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento. |
Retener las instrucciones de proceso | No | No | Deseleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra instrucciones de proceso en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento. |
Elementos opacos | No | No | Espacio en blanco | Esta propiedad se utiliza para especificar una lista de elementos en el mensaje de respuesta que se analizan opacamente por el analizador XMLNSC. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada. |
Las propiedades de validación del nodo SOAPAsyncResponse están descritas en la siguiente tabla. De forma predeterminada, la validación está habilitada.
Si un mensaje se propaga al terminal de anomalías del nodo, no se valida. Para obtener más detalles, consulte Validar mensajes y Propiedades de validación.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | No | Sí | Contenido y valor | Esta propiedad controla si tiene lugar la
validación. Los valores válidos son Ninguno,
Contenido y valor y
Contenido. Las propiedades de validación se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en modalidad de pasarela. |
validateMaster |
Acción para anomalía | No | No | Excepción | Esta propiedad controla qué sucede si falla la
validación. Sólo puede establecer esta propiedad si establece
Validar en
Contenido o
Contenido y valor. Los
valores válidos son Rastreo de
usuario, Lista de
excepciones, Anotaciones de
errores locales y Excepción. Las propiedades de validación se ignoran cuando el nodo SOAPAsyncRequest emparejado está configurado para actuar en modalidad de pasarela. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sucesos | No | No | Ninguno | Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |
Valor | Descripción |
---|---|
UserContext | Puede recuperar los datos de contexto que ha
almacenado el nodo SOAPAsyncRequest desde la
ubicación siguiente en el entorno local:
|