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.
- Dans la vue Explorateur de projets, cliquez sur le projet EGLClient pour
le sélectionner.
- Cliquez sur .
- Développez l'entrée EGL et cliquez sur Gestionnaire JSF.
- Cliquez sur Suivant.
- 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
- Dans la zone Package, tapez le nom suivant :
jsfhandlers
- Dans la zone Nom du fichier source EGL, tapez le nom
suivant :
ClientPage
La fenêtre ressemble à
ceci :
- 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.
- 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
- Spécifiez ClientPage.jsp comme valeur de la propriété view
(voir ci-dessous) :
{view = "ClientPage.jsp"}
- Dans le gestionnaire JSF, créez les variables suivantes :
nom string {DisplayUse = input};
ville string {DisplayUse = input};
sortie string {DisplayUse = output};
- 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 :
- 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 :
- Cliquez sur .
- Dans la fenêtre Préférences, développez EGL et cliquez sur Génération.
- Sur la page Génération, cochez la case Gestionnaire.
- Cliquez sur OK.
Désormais, les gestionnaires JSF seront générés automatiquement lors de leur sauvegarde.
- 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.
- Localisez la vue Données de page. Si vous ne la trouvez pas, cliquez sur . 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.
- Dans la page Données de page, développez et
localisez la fonction getHello().
- 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.
- Sauvegardez la page.
La page se présente comme suit :
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.