SIMessage

La SIMessage es la interfaz pública para un mensaje del bus de integración de servicios que utilizan las mediaciones y otros componentes del bus de integración de servicios. Esta interfaz amplía java.lang.Cloneable y java.lang.Serializable.

La versión de SDO (Service Data Objects) que soportan las mediaciones es Versión 1.

La interfaz SIMessage tiene muchos métodos que le permiten trabajar con las propiedades del mensaje, el contenido de la cabecera, la ruta de direccionamiento, metadatos y otros:
  • El método getDataGraph devuelve el gráfico de datos SDO. Contiene el contenido de carga de SIMessage en una representación en árbol. Mediante el gráfico de datos, puede trabajar directamente con campos individuales de la carga de mensaje. Para obtener más información sobre los gráficos de datos SDO, consulte Gráficos de datos SDO.
  • Puede transcodificar una carga de mensaje llamando al método getNewDataGraph(format). Devuelve una copia de la carga en el nuevo formato. Puede escribir el nuevo gráfico de nuevo en el mensaje utilizando setDataGraph(DataGraph, format). Para obtener más información, consulte Transcodificación entre formatos de mensaje.
  • Si desea anotar cronológicamente un mensaje como una corriente de bytes sencilla, puede recuperar la carga de mensaje como un conjunto de bytes mediante el método getDataGraphAsBytes. Para obtener más información sobre la conversión de un gráfico de datos en bytes y viceversa, consulte Transcodificación de una carga del mensaje en una matriz de bytes y Transcodificación de una matriz de bytes en una carga del mensaje.
  • Hay métodos de obtención, definición, supresión y limpieza de las propiedades de usuario y de las propiedades de mensajes. Asimismo, puede recuperar una lista de los nombres de propiedades de usuario. Para obtener más información sobre cómo trabajar con propiedades, consulte Cómo trabajar con propiedades de mensaje.
  • Las vías de acceso de direccionamiento de reenvío y de direccionamiento inverso definen una lista secuencial de destinos de bus intermedios por los que los mensajes pasan para alcanzar un destino de bus indicado. Utilice una ruta de direccionamiento para aplicar las mediaciones configuradas en varios destinos a los mensajes enviados por la vía. Los métodos siguientes le permiten obtener y establecer el contenido de ForwardRoutingPath y ReverseRoutingPath para un SIMessage:
    • getForwardRoutingPath()
    • setForwardRoutingPath()
    • getReverseRoutingPath()
    • setReverseRoutingPath()
    Para obtener más información sobre las rutas de direccionamiento, consulte Rutas de direccionamiento de destino. Para obtener información sobre cómo trabajar con direcciones de direccionamiento, consulte Definición de direcciones de direccionamiento en una cabecera de mensaje.
  • Si la mediación cambia el contenido del mensaje, existe un riesgo de que el mensaje ya no sea válido. Si el gráfico de datos no es válido, no podrá enviarse el mensaje a través del bus de integración de servicios ni almacenarse en el almacén de mensajes. En este caso, el mensaje no tiene el formato correcto. Un mensaje tiene el formato correcto cuando todos los valores de las propiedades del mensaje pueden serializarse y el gráfico de datos del mensaje se ajusta al formato del mensaje. Puede probar el mensaje utilizando el método isWellFormed. Devuelve el valor true cuando el mensaje contiene un gráfico de datos con formato correcto. Esta prueba tiene implicaciones en el rendimiento. Para obtener más información, consulte Establecimiento de las propiedades de ajuste para una mediación.
  • Puede trabajar con el tiempo de duración del mensaje, medido en milisegundos a partir del momento en que se envió originalmente:
    • Los métodos getTimeToLive y setTimeToLive permiten obtener y establecer el valor del campo TimeToLive en la cabecera del mensaje. Un valor de 0 indica que el mensaje no caduca nunca.
    • Los métodos getRemainingTimeToLive y setRemainingTimeToLive le permiten obtener el período de tiempo en milisegundos que falta para que caduque el mensaje y establecer el período de tiempo en milisegundos para que caduque el mensaje.

Si desea más información sobre SIMessage, consulte la documentación de la API.


Icon that indicates the type of topic Reference topic



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