Création d'un service Web à partir d'un bean enterprise à l'aide de SOAP/JMS >
< Précédent | Suivant >

Leçon 1.1 : Création d'un serveur et d'une configuration de serveur pour JMS

Dans cette leçon, vous allez apprendre à créer une configuration de serveur JMS pour l'utiliser avec des services Web.

Vous pouvez importer le fichier EAR requis en utilisant l'assistant d'échange de projet :
Importer le fichier JMSEAR.ear

Dans la perspective J2EE notez JMSService. Ce projet contient toutes les ressources des applications EJB, notamment le bean enterprise, l'interface distante de l'EJB et l'interface locale. Le projet JMSServiceRouter est également créé. Ce projet EJB doit stocker le bean géré par message du routeur de messages pour le service Web.

Créer un serveur JMS

Vous pouvez créer un serveur JMS en procédant comme suit :
  1. Dans le menu Fichier, sélectionnez Nouveau > Autre > Serveur > Serveur > Suivant.
  2. Sélectionnez Serveur WebSphere v6.1 comme type de serveur. Cliquez sur Suivant.
  3. Si cette phase d'exécution n'a toujours pas été créée dans votre espace de travail, vous serez invité à sélectionner le répertoire d'installation pour le serveur. Cliquez sur Suivant.
  4. Acceptez le port et le nom de serveur définis par défaut. Cliquez sur Suivant.
  5. Sélectionnez JMSEAR dans la liste des projets disponibles et cliquez sur Ajouter pour l'affecter au serveur. Cliquez sur Terminer.
  6. Attendez le démarrage du serveur. Une fois le serveur démarré, la console affiche le message Serveur serveur1 prêt pour l'e-business;

Configuration du serveur pour JMS

Les paramètres JMS de ce serveur doivent être définis dans la console d'administration de WebSphere Application Server. Vous pouvez lancer la console à l'aide du menu Démarrer de Windows, ou via un navigateur Web en entrant : http://localhost:9060/ibm/console
  1. Une fois la console lancée, sélectionnez Serveurs > Serveurs d'applications pour vérifier que le serveur créé apparaît dans la liste.
  2. Dans la sous-fenêtre de gauche, développez Intégration de services > Bus et cliquez sur Nouveau. Entrez un nom unique dans la zone Nom (par exemple WS_tutorial_bus) et cliquez sur Suivant, puis sur Terminer.
  3. Pour associer le serveur en cours au nouveau bus d'intégration, sélectionnez le nom de ce bus et cliquez sur Membres du bus dans la section Topologie. Cliquez sur Ajouter, sélectionnez le serveur à associer au bus d'intégration et cliquez sur Suivant. Sélectionnez l'état de persistance de message Stockage des fichiers et cliquez sur Suivant. Pour ce tutoriel, vous pouvez accepter les propriétés par défaut de stockage des messages et cliquer sur Suivant. Si vous créez un bus JMS pour votre propre service Web, sélectionnez Aide, puis cliquez sur "Paramètres de stockage des fichiers" pour obtenir des détails sur les paramètres les plus appropriés dans votre cas. Cliquez sur Terminer pour confirmer.
  4. Créez une file d'attente physique pour le message de demande :
    1. Dans la sous-fenêtre de gauche, développez Intégration de services > Bus. Sélectionnez le bus créé précédemment.
    2. Dans la section Ressources de destination, cliquez sur Destinations.
    3. Dans la page des destinations, cliquez sur Nouveau .
    4. Choisissez le type de destination File d'attente, puis cliquez sur Suivant.
    5. Entrez un identifiant, tel que ws_tutorial_queueJms. Cliquez sur Suivant
    6. Acceptez le membre de bus par défaut. Cliquez sur Suivant.
    7. Cliquez sur Terminer pour confirmer et sauvegarder les modifications.
  5. Affectez les paramètres JMS à la file d'attente créée :
    1. Dans le panneau de navigation de gauche, accédez à la section Ressources > JMS > Fournisseurs JMS.
    2. Dans la liste déroulante Portée, sélectionnez le serveur, puis dans la liste Fournisseurs, sélectionnez Fournisseur de messagerie par défaut.
    3. Dans Propriétés supplémentaires, cliquez sur File d'attente.
    4. Entrez un nom (par exemple ws_tutorial_queueJms) et un nom JNDI (par exemple jms/ws_tutorial_queue). Dans la sous-fenêtre des connexions, sélectionnez le bus (WS_tutorial_bus) et la file d'attente (ws_tutorial_queueJms) créés précédemment.
    5. Cliquez sur OK pour sauvegarder les changements.
  6. Créez une fabrique de connexions de file d'attente pour la file d'attente en entrée :
    1. Accédez à Ressources > JMS > Fabriques de connexions de file d'attente.
    2. Dans la liste déroulante Portée, sélectionnez le serveur, puis cliquez sur Nouveau.
    3. Sélectionnez le fournisseur de messagerie par défaut, puis cliquez sur OK.
    4. Dans la section Propriétés générales, entrez un nom (par exemple WebServicesInput_QCF) et un nom JNDI (par exemple jms/ws_tutorial_qcf).
    5. Dans la sous-fenêtre Connexion, sélectionnez le bus créé précédemment (WS_tutorial_Bus) comme nom de bus.
    6. Cliquez sur OK pour sauvegarder les changements.
  7. Créez une fabrique de connexions de file d'attente pour la file d'attente des réponses :
    1. Accédez à Ressources > JMS > Fabriques de connexions de file d'attente.
    2. Dans la liste déroulante Portée, sélectionnez le serveur, puis cliquez sur Nouveau.
    3. Sélectionnez le fournisseur de messagerie par défaut, puis cliquez sur OK.
    4. Dans la section Propriétés générales, entrez le nom WebServicesReply_QCF (vous devez obligatoirement entrer WebServicesReply_QCF dans cette zone) et un nom JNDI (par exemple jms/WebServicesReplyQCF). Si vous souhaitez utiliser un nom personnalisé pour la fabrique de connexions de file d'attente, vous devez changer l'alias de référence dans le descripteur de déploiement du projet JMSServiceRouter. Cette référence est configurée lorsque vous exécutez les assistants des services Web. Par conséquent, si vous décidez d'utiliser un autre nom JNDI, vous devez accéder à ce projet et remplacer les paramètres par défaut.
    5. Dans la sous-fenêtre Connexion, sélectionnez le bus créé précédemment (WS_tutorial_Bus) comme nom de bus et cliquez sur OK pour sauvegarder les changements.
  8. Une spécification d'activation JMS est nécessaire pour lier la file d'attente en entrée et l'EJB géré par message d'écoute :
    1. Accédez à Ressources > JMS > Spécifications d'activation.
    2. Dans la liste déroulante Portée, sélectionnez le serveur, puis cliquez sur Nouveau.
    3. Sélectionnez le fournisseur de messagerie par défaut, puis cliquez sur OK.
    4. Entrez un nom (par exemple ws_tutorial_JMSRouter) et un nom JNDI (par exemple eis/ws_tutorial_JMSRouter). Dans la sous-fenêtre Destination, sélectionnez File d'attente comme type de destination, entrez le nom JNDI de destination (jms/ws_tutorial_queue), et sélectionnez le nom du bus (WS_tutorial_Bus).
    5. Cliquez sur OK pour sauvegarder les changements.
  9. Une fois que vous avez ajouté les fabriques de connexions et les files d'attente ou les rubriques requises, vous pouvez arrêter et redémarrer le système WebSphere Application Server version 6.1 et revenir à l'espace de travail de développement.

Point de contrôle pour la leçon

Vous pouvez à présent commencer la leçon 1.2 : Création du service Web .

Retour d'informations

< Précédent | Suivant >