< Précédent | Suivant >

Leçon 2 : Configurer l'espace du travail

Avant d'écrire votre logique, créez deux projets EGL et importez les exemples Dojo.

Une application EGL est organisée en un ou plusieurs projets, chacun étant un dossier physique dans l'espace de travail. Un projet contient automatiquement un dossier source EGL, contenant un ou plusieurs packages qui, à leur tour, contiennent des fichiers source EGL. Cette hiérarchie est essentielle pour votre travail dans EGL : un projet, puis un dossier source EGL, puis un package avec les fichiers source EGL.

Les fichiers source EGL comprennent des composants EGL, qui sont des définitions de type créées par vous. Par exemple, un composant Service contient la logique, tandis qu'un composant Enregistrement peut constituer la base d'une variable déclarée dans le composant Service.

Les packages sont importants car ils répartissent les composants entre différents contextes, ou espaces de noms :
  • Un nom de composant peut être dupliqué dans deux packages différents, et tous les codes source EGL peuvent référencer chaque composant de façon précise. Le principal avantage des espaces de noms est que différentes équipes peuvent développer différents composants EGL sans provoquer des conflits de noms.
  • Chaque nom de composant dans un package donné est unique dans ce package :
    • Le composant d'un package peut facilement référencer un autre composant du même package à l'aide de son nom. Par exemple, voici une déclaration d'enregistrement qui repose sur le composant Enregistrement MyRecordPart :
      myRecord MyRecordPart{};
    • Le composant d'un package peut également référencer un composant d'un autre package en indiquant son nom et celui du package, ou par un raccourci impliquant l'importation du composant. Des exemples sont présentés dans ce tutoriel.

Un projet peut référencer les composants d'un second projet, mais seulement si le chemin de génération EGL du projet faisant référence identifie le projet référencé. A nouveau, des exemples sont présentés dans ce tutoriel. Cependant, dans tous les cas, évitez d'utiliser le même nom de package dans des projets différents, car cette utilisation peut provoquer des incidents dans la résolution des noms.

Votre prochaine tâche dans ce tutoriel consiste à créer les projets suivants :
MortgageServiceProject
Contient un composant Service EGL et les définitions associées
MortgageUIProject
Contient les gestionnaires Rich UI et les définitions associées

Vous pouvez inclure l'ensemble de votre code dans un projet unique, mais la séparation présentée ici vous permet de déployer facilement les deux types de code de différentes manières.

Création d'un projet de service EGL

  1. Si vous êtes dans une perspective de plan de travail différente d'EGL, passez dans la perspective EGL en cliquant sur Fenêtre > Ouvrir la perspective > [Autre] > EGL. L'icône de perspective est située dans l'angle supérieur droit du plan de travail.
    L'icône EGL indique la perspective EGL et s'affiche dans un onglet qui se trouve sous les icônes de réduction, d'agrandissement et de fermeture.
  2. Cliquez sur Fichier > Nouveau > Projet EGL, ou cliquez sur l'icône Nouveau projet EGL dans la barre de menus.
    L'icône de nouveau projet est la première sur quatre dans le deuxième groupe d'icônes de la barre de menus.
  3. Dans la fenêtre Projet EGL, entrez les informations suivantes :
    1. Dans la zone Nom du projet, entrez le nom suivant :
      MortgageServiceProject
    2. Dans la section Types de projet EGL, cliquez sur Projet général.
      La fenêtre Nouveau projet EGL avec le nom de projet "MortgageServiceProject".
    3. Cliquez sur Suivant.
  4. Dans la deuxième fenêtre du Projet EGL, les valeurs par défaut fournies par EGL doivent être correctes. Vérifiez les informations suivantes :
    1. La Plateforme d'exécution cible est Java. Ce paramètre indique qu'EGL génère du code source Java à partir de votre composant Service EGL.
    2. Sous Options du descripteur de génération, l'option Créer un descripteur de génération est sélectionnée. Les descripteurs de génération contrôlent le processus de génération. Etant donné que vous créez un projet distinct pour votre service, vous pouvez utiliser le descripteur de génération par défaut créé automatiquement par EGL.
  5. Cliquez sur Terminer.
EGL crée un projet nommé MortgageServiceProject. Remarquez les dossiers à l'intérieur du répertoire :
EGLSource
Placez vos packages et vos fichiers source à cet endroit.
EGLGen/JavaSource
C'est ici qu'EGL place les fichiers Java qu'il génère.
JavaSource
Placez ici les fichiers source Java personnalisés. Ces fichiers ne sont pas écrasés durant le processus de génération.
JRE System Library
EGL utilise ce dossier pour les fichiers JAR prenant en charge Java Runtime Environment.
La vue Explorateur de projets affiche le nouveau projet et ses dossiers.

Création d'un projet EGL Rich UI

  1. Cliquez sur l'icône Nouveau projet EGL dans la barre de menus.
  2. Dans la fenêtre Nouveau projet EGL, entrez les informations suivantes :
    1. Dans la zone Nom du projet, entrez le nom suivant :
      MortgageUIProject
    2. Dans la section Types de projet EGL, cliquez sur Projet Rich UI.
      La fenêtre Projet EGL avec le nom de projet "MortgageUIProject".
    3. Cliquez sur Suivant.
  3. Dans la deuxième fenêtre du Projet EGL, les valeurs par défaut fournies par EGL doivent être correctes. Vérifiez les informations suivantes :
    1. L'option Utiliser l'emplacement par défaut pour le projet est sélectionnée.
    2. La liste Bibliothèques de widgets contient les projets suivants :
      • Widgets EGL Rich UI
      • Widgets EGL Dojo
    3. Dans le groupe Fonction de projet EGL, la case Créer un descripteur de déploiement de service EGL est cochée.
  4. Cliquez sur Suivant.
  5. Sur la page Paramètres EGL, sélectionnez MortgageServiceProject. Le projet de service est ajouté au chemin de génération du nouveau projet, afin que le projet d'interface utilisateur puisse utiliser des composants définis dans le projet de service.
  6. Cliquez sur Terminer.
EGL crée un projet nommé MortgageUIProject et ajoute à l'espace de travail les projets de support pour Rich UI, les widgets Dojo, et la bibliothèque d'exécution Dojo. Outre les répertoires créés par EGL pour le projet général, un projet Rich UI inclut le répertoire suivant :
WebContent
Il contient les fichiers de support, tels que les feuilles de style en cascade (CSS) et les images.
La vue Explorateur de projets affiche le nouveau projet et ses dossiers.

Importation des exemples de widgets EGL Dojo

  1. Dans la barre de menus principale du plan de travail, cliquez sur Aide > Table des matières de l'aide.
  2. Dans la table des matières, développez Samples > Technology samples > EGL, et cliquez sur EGL Dojo widgets.
    Le menu Samples développé.
  3. Dans la sous-fenêtre de contenu, cliquez sur Get the sample.
    La sous-fenêtre de contenu
  4. Dans la fenêtre d'importation, les valeurs par défaut sont correctes. Cliquez sur Terminer.
La dernière version du projet com.ibm.egl.rui.dojo.samples est ajoutée à votre espace de travail.
Le projet d'exemples Dojo dans la vue Explorateur de projets.

Modifiez le chemin de génération de MortgageUIProject

Le chemin de génération EGL détermine que les projets examinés par EGL lorsqu'il tente de résoudre les références de votre logique. Pour ajouter le projet que vous venez d'importer :

  1. Dans la vue Explorateur de projets, cliquez avec le bouton droit sur MortgageUIProject, puis cliquez sur Propriétés. Sur le côté gauche de la fenêtre Propriétés de MortgageUIProject, cliquez sur Chemin de génération EGL. EGL affiche la liste des projets de votre espace de travail.
  2. Sélectionnez le projet com.ibm.egl.dojo.samples. Vous n'avez pas besoin de sélectionner le projet com.ibm.egl.dojo.widgets car il est déjà dans le chemin de génération du projet com.ibm.egl.dojo.runtime.local. La fenêtre du chemin de génération doit ressembler à l'image suivante :
    Quatre des cinq projets sont sélectionnés.
    Cela signifie que lorsque vous organisez les instructions d'importation qui fournissent les informations détaillées à vos programmes, EGL va effectuer des recherches dans tous les projets sélectionnés pour résoudre les références.
  3. Cliquez sur OK.

Récapitulatif de la leçon

Dans cette leçon, vous avez effectué les tâches suivantes :
  • Créer un projet EGL pour le service de prêt hypothécaire
  • Créer un projet EGL pour l'application Rich UI
  • Importer un projet d'exemples EGL Dojo
  • Corriger le chemin de génération EGL du second projet

Dans la leçon suivante, vous allez créer un service dédié au calcul des mensualités d'un prêt hypothécaire.

< Précédent | Suivant >

Retour d'informations