Création d'un service Hello World avec EGL >
< Précédent | Suivant >

Leçon 2 : Configurer le service

Maintenant que le code de ce service est écrit, vous pouvez le rendre accessible à d'autres applications sous la forme d'un service Web. La mise à disposition du service sous cette forme implique de créer des informations de liaison qui indiquent aux autres applications où trouver le service et quelles fonctions il propose. Le service publie ces informations dans un fichier WSDL (Web Services Description Language).

Les applications client EGL peuvent aussi accéder aux applications de service EGL comme service EGL. Cette technique offre de meilleures performances que des services Web, mais elle ne peut être mise en oeuvre qu'entre deux applications EGL. Pour une plus grande compatibilité, ce tutoriel utilise des services Web qui peuvent être utilisés entre deux applications EGL, deux applications non-EGL ou une application EGL et une application non-EGL. Pour plus d'informations, consultez la documentation EGL en cliquant sur Aide > Table des matières de l'aide.

Les informations de liaison de service sont contenues dans un descripteur de déploiement EGL. Dans les étapes qui suivent, vous travaillez sur le descripteur de déploiement du projet et vous configurez le descripteur de génération du projet pour qu'il utilise ce descripteur de déploiement.

Démonstration

Vérifier le descripteur de déploiement et le descripteur de génération

Lorsque vous avez créé le projet EGL, cela a entraîné la création automatique d'un fichier descripteur de déploiement nommé EGLService.egldd. Ensuite, lorsque vous avez créé le service, vous avez coché la case Créer comme service Web, ce qui a eu pour effet d'ajouter le service au descripteur de déploiement. Dans cette section, vous allez vérifier ces réglages.
  1. Dans la vue Explorateur de projets, développez la branche du projet EGLService, puis celle du dossier EGLSource. Ouvrez le descripteur de déploiement EGL en faisant un double clic sur le fichier EGLService.egldd.
  2. Dans le bas de l'éditeur de descripteur de déploiement EGL, cliquez sur l'onglet Déploiement de service Web.
  3. Vérifiez que votre service figure bien dans la liste des services à déployer comme services Web comme dans l'illustration ci-dessous)
    Fichier du descripteur de déploiement EGL montrant les informations de liaison de service Web
  4. Fermez le fichier du descripteur de déploiement.
  5. Faites un double clic sur le fichier du descripteur de génération du projet pour l'ouvrir dans l'éditeur de composant de génération. Ce fichier a pour nom EGLService.eglbld et est situé dans le dossier EGLSource du projet. Il contient les options du descripteur de génération, lesquelles décrivent comment EGL doit générer votre projet dans le langage de sortie.
  6. Dans la liste des options du descripteur de génération, localisez l'option nommée deploymentDescriptor. Notez que sa valeur est le nom du descripteur de déploiement ; par défaut, ce descripteur porte le même nom que le projet. C'est de cette manière que le descripteur de déploiement doit être référencé pour pouvoir être utilisé. L'éditeur de composant de génération ressemble à ceci :
    Editeur de composant de génération montrant que la valeur de l'option deploymentDescriptor est le nom du descripteur de déploiement
  7. Fermez le descripteur de génération.
  8. Générez l'ensemble du projet en faisant un clic droit sur son nom dans la vue Explorateur de projets et en sélectionnant Générer.

Générer le fichier WSDL

Le fichier WSDL communique des informations sur le service aux clients ; il décrit les fonctions fournies par le service et spécifie son emplacement. Dans cette section, vous allez générer un fichier WSDL à partir du service. Plus tard, votre application cliente l'importera et utilisera son contenu.

EGL utilise les informations du fichier descripteur de déploiement et le composant Service lui-même pour générer un fichier WSDL, mais il a aussi besoin d'un autre élément d'information : le port sur lequel le serveur hébergera le service. Par défaut, il s'agit du port 9080. Suivez ces étapes pour identifier le numéro de port de votre serveur :

  1. Ouvrez la vue Serveurs. Si vous ne la trouvez pas, cliquez sur Fenêtre > Afficher la vue > Serveurs.
  2. Faites un clic droit sur le serveur nommé WebSphere Application Server v6.1 et démarrez-le en sélectionnant Démarrer dans le menu contextuel. Le démarrage du serveur peut prendre un certain temps, selon votre système.
  3. Attendez que la mention Démarré apparaisse dans la colonne Statut, comme illustré ci-après :
    Vue Serveurs avec le serveur démarré
  4. Une fois le serveur démarré, faites un clic droit dessus dans la vue Serveurs et sélectionnez Exécuter la console d'administration (à ne pas confondre avec Exécuter un script d'administration). La console d'administration s'ouvre dans l'éditeur.
  5. Dans la partie gauche de la console d"administration, développez la branche Serveurs et cliquez sur Serveurs d'applications. Votre serveur figure dans la liste sous Serveurs d'applications, comme dans la figure suivante :
    Liste des serveurs dans la console d'administration
  6. Cliquez sur le nom du serveur dans la colonne Nom.
  7. Sur la page décrivant votre serveur, cliquez sur l'onglet Configuration.
  8. Sous l'onglet Configuration, dans la section Communications, cliquez sur le lien Ports.
  9. Dans la colonne Nom du port, cliquez sur le port dont le nom est WC_defaulthost.
  10. Notez par écrit le numéro de port figurant dans la zone Port de la page décrivant la configuration du port. Dans la figure suivante, le numéro de port est le 9082.
    Console d'administration montrant le numéro de port
  11. Fermez la console d'administration sans rien changer à la configuration du serveur.
  12. Sur la barre de menus principale, sélectionnez Fenêtre > Préférences.... Dans la liste de gauche, développez la branche EGL et cliquez sur Services.
  13. Le cas échéant, remplacez le numéro de port figurant dans la zone Port par celui que vous avez relevé dans la console d'administration. La fenêtre ressemble à ceci :
    Fenêtre de préférences Service avec le numéro de port qui sera utilisé pour la génération du fichier WSDL.
  14. Cliquez sur Terminer.
  15. Dans la vue Explorateur de projets, faites un clic droit sur le fichier HelloService.egl (dans le package services du dossier EGLSource) et sélectionnez Services EGL > Générer un fichier WSDL.
  16. Dans la fenêtre Création d'un fichier WSDL, cliquez sur Terminer. EGL crée un fichier WSDL dans le package wsdl du dossier EGLSource et en affiche une représentation graphique dans l'éditeur WSDL.
  17. Examinez la représentation graphique du fichier WSDL et fermez-la lorsque vous avez terminé.
Vous venez de configurer le service à utiliser par d'autres applications à l'exécution. Le fichier WSDL décrit le service afin que les clients puissent s'y connecter, tandis que le descripteur de déploiement permet à EGL de rendre le service disponible à l'exécution.

Dans le monde réel, les services s'exécutent indépendamment des clients qui les utilisent. Pour simuler cette situation, vous pourriez créer une nouvelle instance du serveur d'applications et y exécuter le service. Mais consommer ces ressources supplémentaires n'apporterait rien de plus à ce tutoriel ; c'est pourquoi, au moment de tester le client, vous exécuterez le service sur votre serveur d'applications existant.

< Précédent | Suivant >