Cette fonction permet de publier une variable Adélia en tant que message vers un broker de messages supportant le protocole AMQP v0.9.1. Cette API a été validée avec le logiciel d'agent de messages open source RabbitMQ (https://www.rabbitmq.com/).
L'exécution de cette fonction s'appuie sur un fichier de paramétrage (au format YAML dans un environnement Windows ou Java, au format XML dans un environnement AS/400), définissant la configuration détaillée du broker logique Adélia manipulé.
Cette fonction permet d'effectuer un envoi synchrone de message. Pour un envoi asynchrone, voir la fonction VaToolBxAMQPPublish.
Remarque : Dans un contexte Windows, il est recommandé (pour des raisons de performance) d'avoir la dll VaToolBx déjà chargée (ordre CHARGER_DLL) avant le premier appel à une fonction VaToolBxAMQPxxxxxx, et cette dll doit rester chargée au moment de l'appel des fonctions VaToolBxAMQPxxxxxx suivantes.
Domaine d'application
Client Cloud
Serveur Java
Client Java
Client Web
Client Windows
Serveur Windows
- Serveur AS/400
Paramètres
| ALPHA(n) | AdeliaLogicalBroker | Nom du broker logique Adelia. Ses paramètres (broker, port, etc.) sont définis dans le fichier de configuration AdeliaLogicalBrokersConfig.yaml. |
| ALPHA(n) | ExchangeName | Nom de l'exchange (routeur de message) dans lequel envoyer le message. |
| ALPHA(n) | RoutingKey | Clé de routage permettant à l'exchange de déterminer la ou les queues dans lesquelles déposer le message. |
| IMAGE ou ALPHA(n) ou REF_CLASSE (REF_CLASSE avec runtime Java uniquement) | Message | Valeur du message à envoyer au broker. La valeur envoyée est un tableau d'octets. Dans le cas du type ALPHA, la chaîne est encodée en UTF-8 si aucun encodage n'est défini dans le paramètre MessageArguments. Dans le cas du type IMAGE, la valeur du message est le contenu sans conversion de la variable IMAGE. Dans le cas du type REF_CLASSE, la valeur du message est une chaîne alphanumérique au format JSON (encodée en UTF-8) issue de la sérialisation de la variable REF_CLASSE. |
| BOOL | Obligatoire | Si ce paramètre vaut *VRAI, alors le broker de message renvoie une erreur si le message n'a été déposé dans aucune queue (car aucune queue n'était associée à la routingKey). |
| IMAGE ou ALPHA | MessageArguments | Meta données permettant de particulariser le message à envoyer. Ce paramètre doit être au format JSON sous la forme d'un objet. Ses attributs sont parmi les suivants :
|
| NUM_BIN_2 | CodeRetour | Code retour : 0 : Succès de l'exécution. -1 : Le paramètre Message n'est pas du bon type Adélia. -2 : Le paramètre MessageArguments n'est pas du bon type Adélia. -3 : Le paramètre AdeliaLogicalBroker ne doit pas être vide. -4 : Erreur lors de l'analyse syntaxique du paramètre MessageArguments. -5 : Erreur lors de la transformation JSON du paramètre MessageArguments. -6 : Erreur lors de la lecture du paramètre MessageArguments. -7 : Erreur lors de l'encodage du paramètre Message. -8 : Erreur lors de la sérialisation JSON du paramètre Message. -9 : Configuration non chargée. Aucun broker logique défini (fichier .YAML non défini, trouvé, ou chargé). -10 : Aucune configuration définie dans le fichier .YAML pour l'Adelia broker logique spécifié. -11 : Erreur lors de la création du client d'agent de message. -12 : Erreur lors de la création des entités (exchanges, queues, liaisons) définies dans la configuration du broker logique AdeliaLogicalBroker. 1 : Erreur lors de la publication du message. 2 : Erreur lors de l'attente de la confirmation de réception du broker. 3 : Erreur lors du routage d'un message obligatoire (aucune queue liée destinatrice). 4 : Erreur lors de la réception d'un message (absence de confirmation de la part du broker). |
Exemple 1
REF_CLASSE(MACLASSE) myInstance
myExchange = 'directExchangePrinting'
myRoutingKey = 'order_form'
APPELER_DLL 'VaToolBx' 'VaToolBxAMQPSyncPublish' 'myLogicalBroker' myExchange myRoutingKey myInstance *VRAI *BLANK myReturnCode
Exemple 2
ALPHA(132) myMessage
myExchange = 'directExchangePrinting'
myRoutingKey = 'order_form'
myMessage = '<!DOCTYPE html><html><head><meta charset="ISO-8859-1"><title>Title of the document</title></head><body>Hello world!</body></html>'
myMessageARguments = '{"contentType":"text/html", "contentEncoding": "ISO-8859-1"}'
APPELER_DLL 'VaToolBx' 'VaToolBxAMQPSyncPublish' 'myLogicalBroker' myExchange myRoutingKey myMessage *FAUX myMessageARguments myReturnCode
Liste des fonctions de la DLL VaToolBx par thème