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

Leçon 3 : Créer un client de service EGL

L'étape suivante consiste à créer un projet de client qui utilisera le service. Le client que vous créez dans ce tutoriel est dans le même espace de travail que celui du service, mais il pourrait très bien se trouver à un tout autre endroit ou sur une plateforme différente. Comme les services et les clients n'ont pas besoin d'être écrits dans le même langage, vous pouvez aussi imaginer que ce client est écrit dans un langage différent du service ou qu'il est créé à l'aide d'un jeu d'outils totalement différent.

Démonstration

  1. Cliquez sur Fichier > Nouveau > Projet.
  2. Développez l'entrée EGL et cliquez sur Projet EGL.
  3. Cliquez sur Suivant.
  4. Nommez le nouveau projet EGL EGLClient.
  5. Cliquez sur Projet Web.
  6. Cliquez sur Suivant.
  7. Assurez-vous que l'option Créer un descripteur de génération est sélectionnée. Vous n'avez pas besoin d'utiliser les paramètres avancés, sauf si vous utilisez WAS et que vous avez précédemment changé le réglage par défaut consistant à ajouter le projet à un projet EAR (Enterprise Application Resource).
  8. Il est possible qu'un message apparaisse, vous demandant si vous voulez passer à la perspective J2EE. Si vous voyez ce message, cliquez sur Non.

Créer la page Web du client

Pour utiliser le service, vous allez créer une page Web dans le client afin de récupérer l'entrée, d'envoyer l'entrée au service et d'afficher la sortie produite par le service. Vous allez commencer par créer un gestionnaire JSF, un type de composant logique EGL qui contrôle une page Web, puis EGL va créer une page Web pour fonctionner avec ce gestionnaire JSF.
  1. Dans la vue Explorateur de projets, cliquez sur le projet EGLClient pour le sélectionner.
  2. Cliquez sur Fichier > Nouveau > Autre.
  3. Développez l'entrée EGL et cliquez sur Gestionnaire JSF.
  4. Cliquez sur Suivant.
  5. Dans la fenêtre Nouveau gestionnaire JSF EGL, assurez-vous que le dossier EGLSource de votre projet figure dans la zone Dossier source.
    EGLClient\EGLSource
  6. Dans la zone Package, tapez le nom suivant :
    jsfhandlers
  7. Dans la zone Nom du fichier source EGL, tapez le nom suivant :
    ClientPage
    La fenêtre ressemble à ceci :
    Fenêtre Nouveau gestionnaire JSF EGL
  8. Cliquez sur Terminer. Le nouveau gestionnaire JSF s'ouvre dans l'éditeur.

    Ne sauvegardez pas le fichier tant que les présentes instructions ne vous l'indiquent pas. Lorsque vous sauvegardez un gestionnaire JSF, EGL vérifie si la page web désignée par la propriété view existe. Dans la négative, EGL crée le fichier et y ajoute des zones automatiquement en se fondant sur les variables définies dans le gestionnaire JSF et sur les propriétés DisplayUse de ces variables. Si vous sauvegardez le fichier avant d'avoir ajouté toutes les variables, la nouvelle page Web ne les contiendra pas toutes. Dans ce cas, vous pouvez toujours supprimer le fichier JSP (et non pas le fichier du gestionnaire JSF) et générer à nouveau le gestionnaire JSF pour obtenir une nouvelle page Web.

  9. Supprimez l'exemple de code du nouveau gestionnaire JSF afin qu'il ne subsiste que les lignes de code suivantes :
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. Spécifiez ClientPage.jsp comme valeur de la propriété view (voir ci-dessous) :
    {view = "ClientPage.jsp"}
  11. Dans le gestionnaire JSF, créez les variables suivantes :
    nom string {DisplayUse = input};
    ville string {DisplayUse = input};
    sortie string {DisplayUse = output};
  12. Après les variables, ajoutez la déclaration de fonction suivante :
    function getHello()
    
    end
    Vous ajouterez le code d'implémentation de cette fonction plus tard. Le gestionnaire JSF ressemble à ceci :
    Code du gestionnaire JSF
  13. Sauvegardez le fichier. Lorsque vous sauvegardez le fichier, EGL crée automatiquement une page Web correspondante. Elle a pour nom de fichier la valeur de la propriété view (ClientPage.jsp dans le cas présent) et le fichier est placé dans le dossier WebContent de votre projet.
    Si vous ne trouvez pas de fichier JSP à l'emplacement prévu, cela signifie qu'EGL n'est pas configuré pour générer automatiquement les composants Gestionnaire JSF. Dans ce cas, générez le gestionnaire JSF manuellement en faisant un clic droit dessus dans la vue Explorateur de projets ou dans l'éditeur EGL et en sélectionnant Générer. Appliquez ensuite les étapes additionnelles suivantes pour activer la génération automatique des gestionnaires JSF dans les préférences :
    1. Cliquez sur Fenêtre > Préférences.
    2. Dans la fenêtre Préférences, développez EGL et cliquez sur Génération.
    3. Sur la page Génération, cochez la case Gestionnaire.
    4. Cliquez sur OK.

    Désormais, les gestionnaires JSF seront générés automatiquement lors de leur sauvegarde.

  14. Ouvrez le fichier ClientPage.jsp dans l'éditeur. Cette page comporte des zones dérivées des variables que vous avez créées dans le gestionnaire JSF. Ces zones sont pré-liées aux variables. Ainsi, lorsque leurs valeurs changent sur la page, les variables sont mises à jour en conséquence. Réciproquement, lorsque les valeurs des variables changent dans le gestionnaire JSF, le contenu des zones sur la page Web est mis à jour en conséquence.

    Cette page comporte aussi plusieurs zones de message d'erreur. Elles ne signifient pas qu'il existe des erreurs dans votre page ; elles marquent simplement l'endroit où seront affichés les éventuels messages d'erreur générés à l'exécution.

  15. Localisez la vue Données de page. Si vous ne la trouvez pas, cliquez sur Fenêtre > Afficher la vue > Données de page. Cette vue présente les données à la disposition de votre page, y compris les variables que vous avez créées dans le gestionnaire JSF. Elle répertorie également les fonctions définies dans le gestionnaire JSF.
  16. Dans la page Données de page, développez Gestionnaire JSF > Actions et localisez la fonction getHello().
  17. Faites glisser la fonction getHello() depuis la vue Données de page et déposez-la directement dans le bas de la page Web. Un bouton lié à la fonction apparaît sur la page. A l'exécution, lorsque l'utilisateur cliquera sur ce bouton, la fonction correspondante du gestionnaire JSF sera exécutée.
  18. Sauvegardez la page.
La page se présente comme suit :
Apparence de la page Web du client

Vous disposez maintenant d'une page Web prête à utiliser le service Web. Dans la leçon suivante, vous allez configurer le projet pour qu'il fasse office de client pour le service par l'intermédiaire de cette page Web.

< Précédent | Suivant >