Mensajes

Los mensajes enviados y recibidos de las colas, se representan por el objeto SAMMessage. El objeto SAMMessage encapsula el cuerpo del mensaje (si existe alguno) y las propiedades de cabecera asociadas al mensaje. Un objeto SAMMessage es proporcionado como un parámetro a una operación de mensajería o devuelto como un resultado.

Ejemplo #1 Creación de un mensaje con un cuerpo de texto simple

<?php
$msg 
= new SAMMessage('Este es un mensaje de texto simple');
?>

Los mensajes deben tener las propiedades de cabecera asociadas, lo que permitirá tener control sobre el transporte del mensaje o información futura sobre la aplicación receptora. Por defecto las propiedades del mensaje se distribuirán al sistema de mensajería como strings y en ese caso pueden ser definidas con la siguiente sintaxis sencilla:

Ejemplo #2 Definición de una propiedad de formateado de texto utilizando la sintaxis por defecto

<?php
$msg
->header->myPropertyName 'textData';
?>

Si se desea pasar la información de tipo, se puede utilizar una sintaxis alternativa, donde el valor y la declaración de tipo son pasados en un array asociativo:

Ejemplo #3 Establecer una propiedad empleando una declaración de tipo

<?php
$msg
->header->myPropertyName = array(3.14159SAM_FLOAT);
?>

Las propiedades también pueden extraerse de la cabecera del mensaje.

Ejemplo #4 Recuperación de una propiedad desde la cabecera del mensaje

<?php
$myProperty 
$msg->header->myPropertyName;
?>