< Précédent | Suivant >

Leçon 4 : Créer des composants EGL pour accéder à une base de données

Dans cette leçon, vous créez les composants de données et les composants logiques qui vous permettent d'accéder à l'exemple de base de données.
L'assistant Application EGL d'accès aux données crée le code EGL nécessaire pour accéder à une base de données. Bien que vous puissiez personnaliser le code quand l'assistant s'exécute, celui-ci crée généralement les composants EGL suivants :

Créer des composants EGL à partir de la connexion de base de données

Dans la leçon précédente, vous avez créé une connexion à la base de données. En partant de cette connexion, EGL peut créer les composants nécessaires pour permettre l'accès à la base de données :

  1. Cliquez sur Fichier > Nouveau > Autre. La fenêtre Nouveau (ou Création) s'ouvre.
  2. Développez EGL, puis cliquez sur Application d'accès aux données.
  3. Cliquez sur Suivant.
  4. Dans la fenêtre Définition des paramètres de projet, vérifiez qu'EGLWeb apparaît bien dans la liste Nom du projet.
  5. Dans la liste Connexion à la base de données, sélectionnez la connexion EGLDerbyDB que vous avez créée dans la leçon précédente. Un ID utilisateur et un mot de passe d'accès à la base de données peuvent vous être demandés. Dans ce cas, entrez le nom et le mot de passe de votre choix ; la base de données n'exige pas de mot de passe, mais les outils de données du plan de travail en attendent un. Vous avez établi une connexion à la base de données. Toutes les tables de la base de données figurent dans la liste située sous Nom de la table dans le bas de l'assistant. Vous ne créerez pas de composants de données pour toutes ces tables car certaines contiennent seulement des métadonnées.
  6. Sous Sélectionner les tables, cochez uniquement les cases associées aux tables suivantes :
    • EGL.CUSTOMER
    • EGL.ITEM
    • EGL.ORDERITEM
    • EGL.ORDERS
    • EGL.SITEUSER
    • EGL.STATETABLE
    L'assistant Application EGL d'accès aux données se présente comme ceci :
    Image de la fenêtre Application EGL d'accès aux données, avec six tables sélectionnées
  7. Assurez-vous que la case Créer des pages Web est désélectionnée. Si cette case reste cochée, EGL crée les pages Web directement à partir des tables de la base de données. Cette fonction permet de gagner du temps en créant une simple application Web d'accès aux données, mais cela ne répond pas aux objectifs de ce tutoriel.
    Remarque : Ne cliquez pas déjà sur Terminer. Vous devez encore modifier un paramètre dans cet assistant.
  8. Cliquez sur Suivant pour passer à la page Définition des zones. Cette page vous permet d'ajouter des zones clés aux tables de la base de données. Ne modifiez aucun paramètre sur cette page ; la base de données a déjà une zone clé pour chacune des tables.
  9. Cliquez à nouveau sur Suivant pour passer à la page Définition des options de création du projet.
  10. Sur la page Options de création du projet, cochez la case Qualifier les noms de table avec le schéma.
  11. Cliquez sur Terminer.

Récapitulatif de la leçon

L'assistant Application EGL d'accès aux données a créé plusieurs artefacts EGL dans votre projet EGLWeb.

Il y a d'abord plusieurs nouveaux packages EGL dans le dossier EGLSource de votre projet EGLWeb : eglderbydb.data, eglderbydb.access et eglderbydb.primitivetypes.data. Les packages fonctionnent comme des dossiers : ils contiennent vos fichiers de code source et les organisent en groupes significatifs. Dans ce cas, le package eglderbydb.data contient les enregistrements, le package eglderbydb.access contient les bibliothèques et le package eglderbydb.primitivetypes.data contient les éléments de données.

Voici quelques-uns des fichiers qui vous seront utiles pour ce tutoriel :
eglderbydb.primitivetypes.data.DataDefinitions.egl
Ce fichier contient la liste de tous les Eléments de données qui constituent les composants Enregistrement dans les autres fichiers. Par exemple, le numéro d'ID client donné à chaque enregistrement de client dans la base de données est représenté par l'Elément de données nommé CUSTOMER_ID :
dataitem CustomerId INT end
Dans ce cas, la zone du numéro d'ID est basée sur le type primitif entier. L'Elément de données peut avoir d'autres propriétés pour spécifier des détails tels que sa plage de valeurs valides et la façon dont il doit être formaté dans l'interface utilisateur.
eglderbydb.data.Customer.egl
Ce fichier contient un des enregistrements créés à partir des tables de la base de données, soit dans le cas présent la table Customer. Cet enregistrement contient des zones destinées à contenir des informations sur un client, par exemple le prénom, le nom, l'adresse, le numéro de téléphone et le numéro d'ID du client. La définition de l'enregistrement se présente comme suit :
record Customer type sqlRecord { 
        tablenames=[["EGL.CUSTOMER"]],
        fieldsMatchColumns = yes,
        keyItems=[CUSTOMERID]
    }  

  CUSTOMERID CUSTOMERID {column="CUSTOMERID"};
  FIRSTNAME FIRSTNAME {column="FIRSTNAME", sqlVariableLen=yes, maxLen=30, isSqlNullable=yes};
  LASTNAME LASTNAME {column="LASTNAME", sqlVariableLen=yes, maxLen=30, isSqlNullable=yes};
  ...
end
eglderbydb.access.CustomerLib.egl
Ce fichier contient une bibliothèque de fonctions générée automatiquement ; vous pouvez utiliser ces fonctions pour accéder à la table Customers de la base de données. Par exemple, la première fonction est AddCustomer, qui ajoute un nouvel enregistrement de client à la base de données. Il y a d'autres fonctions dans cette bibliothèque pour extraire, mettre à jour et supprimer des enregistrements dans la base de données, et chaque table a des fonctions similaires dans une bibliothèque distincte. Vous utiliserez ces fonctions ultérieurement dans le tutoriel.
< Précédent | Suivant >

Retour d'informations