Démarrage rapide du service de messagerie Web

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. .


Etape 1. Installation du service de messagerie Web.

Le service de messagerie Web doit être installé pour exécuter une application activée pour la messagerie Web. Pour plus d'informations, reportez-vous à la rubrique relative aux instructions d'installation d' IBM® WebSphere Application Server Feature Pack for Web 2.0 and Mobile.

Etape 2 : Recherche de la bibliothèque d'utilitaires.

Localisez la bibliothèque utilitaire du service de messagerie Web qui a été fourni avec cette documentation. 

Etape 3. Activation du service de messagerie Web

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.

  1. Connectez-vous à la console d'administration de WebSphere Application Server.
  2. Naviguez vers Serveurs->Serveurs d'application
  3. Sélectionnez le serveur d'application actuel.
  4. Développez les paramètres de conteneur Web et sélectionnez les chaînes de transport de conteneur Web.
  5. Sélectionnez la chaîne de transport WCInboundDefault ou une chaîne de transport correspondant à l'hôte virtuel que vous allez sélectionner durant l'installation de l'application.
  6. Sélectionnez Canal de communications entrantes du conteneur Web (WCC 2).
  7. Sélectionnez Propriétés personnalisées.
  8. Cliquez sur Nouveau.
  9. Entrez webmsgenabled comme nom de propriété et true comme valeur.
  10. Cliquez sur Appliquer.
  11. Cliquez sur Sauvegarder pour enregistrer les informations sur le référentiel.
  12. Vous pouvez tout de suite redémarrer le serveur ou attendre la finalisation de l'étape Configurer le bus d'intégration de services.

Etape 4. Configuration d'un bus d'intégration de services.

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.

Etape 5. Insertion du toolkit Dojo dans le module Web.

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.

Etape 6. Intégration de la bibliothèque d'utilitaires de messagerie Web dans le 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.

Etape 7. Détermination de l'URI de communication du service de messagerie Web et mappage du servlet de la messagerie Web avec cette URI.

Le paramètre de mappage de servlet "/webmsgServlet" définit la communication URI entre le client bayeux de Dojo et le service de messagerie Web. D'un autre côté, un mappage de servlet correspondant au paramètre d'initialisation dojox.cometd.init doit être créé. Le mappage servlet permet de mapper la classe servlet com.ibm.websphere.webmsg.servlet.WebMsgServlet. Ce servlet est fourni dans la bibliothèque utilitaire de la messagerie Web. Le fichier web.xml ci-dessous est fourni à titre d'exemple. Pour plus d'informations, reportez-vous à la rubrique Développement d'une application activée pour la messagerie Web.
	
  <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>
 

      
Dans l'étape 9, l'URI définie ci-dessus est utilisée par le client cometd du toolkit Dojo à des fins d'initialisation. Une simple instruction d'initialisation dans un fichier de présentation est utilisée dans l'étape 9. Pour pouvoir comparer, l'exemple ci-après est fourni :   dojox.cometd.init( "webmsgServlet");

Etape 8. Création d'un fichier de configuration de messagerie Web.

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
      }
}
      

Etape 9. Création de l'application client.

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>
      

Etape 10. Installation et exécution de l'application.

Assemblez, installez et testez l'application à l'aide des procédures standard de test, d'installation et d'assemblage d'application Web.



Conditions d'utilisation | Commentaires