SAMConnection::peekAll()

(no version information, might be only in CVS)

SAMConnection::peekAll() -- Lit un ou plusieurs messages depuis la file d'attente sans les effacer

Description

class SAMConnection {

array peekAll ( string target [, array properties] )

}

Liste de paramètres

target

L'identité de la file d'attente depuis laquelle les messages doivent être lus.

properties

Un tableau associatif optionnel de propriétés décrivant les autres paramètres pour contrôler l'opération.

Nom de la propriétéValeurs possibles
SAM_CORRELIDC'est l'identifiant de corrélation des messages à lire. Ceci est typiquement retourné par la demande "send".
SAM_MESSAGEIDC'est l'identifiant du message à lire.

Valeurs de retour

Cette méthode retourne un tableau d'objets SAMMessage ou FALSE si une erreur survient.

Exemples

Exemple 1. Récupération de tous les messages d'une file d'attente sans les effacer

<?php
$msgArray
= $conn->peekAll('queue://receive/test');
if (
$msgArray) {

   foreach (
$msgArray as $key => $msg) {
         echo
"Message $key : body = $msg->body\n";
      }
   }
else
   echo
"Erreur de lecture : ($conn->errno) $conn->error";
}
?>

Exemple 2. Récupération de tous les messages d'une file d'attente correspondant à un identifiant de corrélation

<?php

$msgArray
= $conn->peekAll('queue://receive/test', array(SAM_CORRELID => $correlId ));
if (
$msgArray) {

   foreach (
$msgArray as $key => $msg) {
         echo
"Message $key: body = $msg->body\n";
      }
   }
else
   echo
"Erreur de lecture : ($conn->errno) $conn->error";
}

?>