Le service de messagerie Web est constitué d'un fichier d'exécution JAR (Java archive) situé dans le répertoire d'installation de WebSphere® Application Server. Il est constitué également d'une bibliothèque conçue pour être insérée dans un nouveau module Web ou existant comme un fichier JAR utilitaire. Cette section fournit de brèves instructions sur l'activation du service de messagerie Web et d'une application activée pour la messagerie Web. Elle contient également des liens permettant de consulter des informations complémentaires sur d'autres sections. .
Linux et UNIX : /opt/WebSphere/AppServer |
---|
Windows :
c:\WebSphere\AppServer |
Linux et UNIX:
/opt/WebSphere/AppServer/optionalLibraries/webmsg_applib.jar.
|
---|
Windows:
c:\WebSphere\AppServer\optionalLibraries\webmsg_applib.jar.
|
Vous devez activer le service de messagerie Web pour exécuter une application activée pour la messagerie Web. Pour plus d'informations, reportez-vous à la rubrique relative aux instructions sur l'Activation du service de messagerie Web.
Une application de messagerie Web doit disposer d'un bus d'intégration de services avec un espace de rubrique défini à exécuter. Pour qu'une application de messagerie Web puisse fonctionner, le nom du bus doit être au moins fourni dans un fichier de configuration de messagerie.
Le toolkit Dojo fournit une prise en charge du client pour le service de messagerie Web. Le moyen le plus simple est d'insérer le toolkit Dojo dans un module Web. Si le toolkit Dojo n'est pas inséré dans un module Web (par exemple, fourni de manière statique via un serveur Web), l'emplacement de l'URI (Uniform Resource Identifier) du fichier dojo.js doit être connu pour pouvoir charger le toolkit Dojo dans n'importe quel fichier de présentation de module Web.
Le meilleur emplacement pour insérer la bibliothèque utilitaire de messagerie Web est dans un répertoire WEB-INF/lib d'un module Web comme étant une bibliothèque utilitaire. Copiez le fichier webmsg_applib.jar situé de l'étape 1 dans le répertoire WEB-INF/lib du module Web. Vous pouvez utiliser la bibliothèque utilitaire de messagerie Web dans le même module Web que celui du toolkit Dojo ou dans un module Web différent. Le point d'interaction clé est l'URI de communication de protocole Bayeux. Pour plus d'informations, reportez-vous à la rubrique relative aux étapes d'installation.
<servlet> <description/> <display-name> WebMsgServlet </display-name> <servlet-name>WebMsgServlet</servlet-name> <servlet-class> com.ibm.websphere.webmsg.servlet.WebMsgServlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>WebMsgServlet</servlet-name> <url-pattern>/webmsgServlet</url-pattern> </servlet-mapping> |
Le service de messagerie Web lit des paramètres de configuration à partir d'un fichier de configuration afin de gérer des demandes de messagerie Web entrantes. Créez un fichier de configuration de messagerie Web, webmsg.json, dans le répertoire WEB-INF (le même répertoire du fichier web.xml) identique à l'exemple suivant. Le fichier webmsg.json est indiqué comme un objet JSON (map) dont chaque clé correspond à un nom de servlet existant mappé avec le servlet de messagerie Web. La section Présentation de configuration fournit des informations sur toutes les options de configurations possibles.
{ "WebMsgServlet": { "busName": "thebus", "destination": "Default.Topic.Space", "clientCanPublish": true, "longPollTimeout": 30 } } |
Toutes les configurations côté serveur sont maintenant terminées sauf celle de l'installation de l'application.
La tâche restante est la création de la logique côté client à l'aide des fonctions du toolkit Dojo. Ici, un exemple de test simple est fourni. Notez la façon dont le paramètre URI d'initialisation fait correspondre le mappage du servlet de la messagerie Web.
<html> <head> <title>cometd client/server test page</title> <script type="text/javascript" src="dojo/dojo.js" djConfig="isDebug: true, parseOnLoad: true, debugAtAllCosts: false"></script> <script type="text/javascript"> dojo.require("dojox.cometd"); dojo.addOnLoad(function(){ dojox.cometd.init("webmsgServlet") dojox.cometd.subscribe("/testtopic", window, "display"); } ); function display(msg) { alert("Message " + msg.data.test); } </script> <div align="left"> <button Id="publishButton" onclick="dojox.cometd.publish('/testtopic', {test: 'Data'});"> <span style="font-size:small">PUBLISH</span> </button> </div> </head> <body></body> </html> |
Assemblez, installez et testez l'application à l'aide des procédures standard de test, d'installation et d'assemblage d'application Web.