« Azure (Gestionnaire de message) » : différence entre les versions

Version du 25 juillet 2013 à 11:37

Ce type de gestionnaire permet d'utiliser une file d'attente Microsoft Azure du système de stockage.

Paramétrage de TdbmQueue

QueueName	Nom de la file d'attente (Nom interne<>nom Azure)
QueueConnectionInfos	url de paramétrage de la file d'attente
QueueTopic	Sujet de la file d'attente : nom de la file d'attente Azure
Credentials	Référence vers les informtations d'authentication

Paramétrage des informations d'authentification

Les paramètres d'authentification sont extraits, par ordre de priorité :

De l'attribut Parameters de l'objet TdbmCredential contenant les informations d'authentification
De l'url paramétrant la file d'attente
De l'attribut UserName pour le nom du compte Azure

Paramètre	Usage	Défaut
AccountName	Nom du stockage Azure.	UserName des crédentials
AccountKey	Clé publique d'accès au stockage.
Protocol	Nom du protocole http utilisé	https
BlobEndPoint	End point des urls de blob	valeur standard d'Azure
QueueEndPoint	End point des urls de queue	valeur standard d'Azure
TableEndPoint	End point des urls de Table	valeur standard d'Azure
RequestProxyHost	Nom du serveur proxy	Paramétrage par défaut du proxy du Service 1000
RequestProxyPort	Port du serveur proxy	Paramétrage par défaut du proxy du Service 1000

Tip : La clé ne peut pas être stockée dans le mot de passe, utiliser l'attribut Parameters qui permet de stocker des attributs arbitraires.

En général il suffit de paramétrer l'objet TdbmCredential ainsi :

UserName : Nom du compte Azure
Parameters : AccountKey : Clé publique d'accès au stockage

Paramétrage de l'URL

Outre les paramètres d'authentification l'url peut contenir les paramètres suivant qui configurent la gestion des messages :

Paramètre	Type	Usage	Défault
xmlStorage	boolean	Le contenu du message est encapsulé dans un document xml	true
sndFileName	chaine	Nom du paramètre du message contenant le nom du blob Azure	FileName,AttachementName
sndContainerName	chaine	Nom du paramètre du message contenant le nom du containeur Azure	ContainerName
sndAttachementContentType	chaine	Nom du paramètre du message contenant le type de contenu du binaire	AttachementContentType,msgAttachementContentType
sndContent	chaine	Nom du paramètre du message contenant le contenu du message à transmettre (xmlStorage=false)	Content,Subject
rcvVisibilityTimeOut	Integer	Valeur d'invisiblité du message après un dépilement	0
rcvLogMessage	boolean	Log les messages reçus (xmlStorage) dans le répertoire log du service	false

sndFileName

Si le nom du fichier n'est pas défini par le paramétrage, un nom unique de type GUID est utilisé.

Renseignez un nom d'attribut inexistant pour forcer l'usage d'un nom unique.

sndContainerName

Si le nom du containeur Azure n'est pas défini par le paramétrage, le nom du containeur est défini par le nom de la file Azure post-fixé par "-blob".

VisibilityTimeOut

Si la valeur n'est pas défini ou vaut 0, la valeur par défaut d'Azure s'applique.

Exemple :

 azu://host/queue1?xmlStorage=true&rcvLogMessage=true

Messages

Un message Azure est constitué d'une chaine de caractère. Il ni a pas de notion d'attribut ou de contenu binaire attaché.

Un objet TdbmQueueMessage contient des propriétés et éventuellement un contenu binaire.

Le message TdbmQueueMessage est encodé en un message Azure ainsi :

Si xmlStorage vaut true (défaut)

Les propriétés du message TdbmQueueMessage sont encapsulées dans un document xml, le contenu du message Azure est ce document.
Le contenu binaire du message est copié dans un blob du système de stockage. Une référence vers ce blob est contenu dans le document xml.

Si xmlStorage vaut false

Le contenu du message est déterminé par le paramètre sndContent de l'url de configuration de la file d'attente.
Le contenu binaire n'est pas transmis.

Exemple:

Url de configuration de la file :

azu://host/queue1?xmlStorage=true&rcvLogMessage=true&sndFileName=x

Post d'un message :

<source lang="Delphi"> //Procedure TestQueueMessage; var msg:TdbmQueueMessage; begin

 msg := TdbmQueueMessage.Create;
 msg.QueueName := 'QUEUEAZURE';
 msg.AddParameter('uneChaine','some text');
 msg.AddParameter('unEntier',1999);
 msg.AddParameter('Subject','le sujet du message');
 msg.AddParameter('Content','le text du message');
 msg.AddParameter('AttachementName','image.jpg');
 msg.AddParameter('AttachementContentType','image/jpeg');
 msg.BinaryContent.LoadFromFile('c:\image.jpg');
 msg.Post;

end; </source>

Contenu du message dans la file Azure : <source lang='xml'> <?xml version="1.0" encoding="ISO-8859-1"?> <MessageContainer> <MessageSourceId>000000000000000000E20001AA9D0007</MessageSourceId> <Topic>queue1</Topic> <uneChaine>some text</uneChaine> <unEntier>1999</unEntier> <Subject>le sujet du message</Subject> <Content>le text du message</Content> <AttachementName>image.jpg</AttachementName> <AttachementContentType>image/jpeg</AttachementContentType> <ContentRef ContainerName="queue1-blobs" BlobName="{96462853-F99E-4840-A8E3-C19085F4F705}"/> <ContentSize>175083</ContentSize> <ContentType>image/jpeg</ContentType> </MessageContainer> </source>

Message reçu :

MessageID="c558c04b-c095-446b-b5f2-4199872d38c5"
MessageOID="c558c04b-c095-446b-b5f2-4199872d38c5"
Topic="queue1"
ReceiveDate="25/07/2013"
InsertionTime="Thu, 25 Jul 2013 11:31:50 GMT"
ExpirationTime="Thu, 01 Aug 2013 11:31:50 GMT"
DequeueCount="1"
PopReceipt="AgAAAAMAAAAAAAAAbLD8oCqJzgE="
TimeNextVisible="Thu, 25 Jul 2013 11:32:22 GMT"
MessageSourceId="000000000000000000E20001AA9D0007"
uneChaine="some text"
unEntier="1999"
Subject="le sujet du message"
Content="le text du message"
AttachementName="image.jpg"
AttachementContentType="image/jpeg"
ContainerName="queue1-blobs"
BlobName="{96462853-F99E-4840-A8E3-C19085F4F705}"
BlobReceipt="O"
ContentSize="175083"
ContentType="image/jpeg"

Voir aussi :

How to use the queue storage service.