< Précédent | Suivant >

Leçon 2 : Créer les projets et importer la base de données

Dans cette leçon, vous créez des projets pour contenir votre application EGL et vous ajoutez une base de données à utiliser.

Dans ce tutoriel, vous aller travailler principalement avec les fichiers d'un projet Web EGL. Ce projet contiendra le code EGL, les pages web et l'exemple de base de données qui constituent la logique, l'interface et les données de l'application. Mais avant tout, vous devez décider du serveur que vous utiliserez dans le cadre de ce tutoriel.

Si vous choisissez WebSphere Application Server, vous aurez besoin d'un projet EAR (Enterprise Application Resource) en plus du projet Web EGL. Le projet EAR contient des informations sur le déploiement d'une application dans l'infrastructure J2EE, notamment comment l'exécuter sur un serveur et comment la connecter à des sources de données. Un projet EAR peut contenir un ou plusieurs projets, ce qui signifie que le projet EAR contient des informations sur le déploiement de ces projets. Les projets contenus dans un projet EAR sont appelés des modules. Dans ce cas, votre projet Web EGL sera un module dans le projet EAR. Dans une grosse application, un projet EAR peut avoir de nombreux modules de différents types effectuant des travaux différents.

Si vous choisissez Apache Tomcat, vous n'aurez pas besoin de projet EAR (et d'ailleurs, vous ne pourrez pas utiliser un tel projet avec ce serveur). WebSphere Application Server est un serveur d'applications complet qui peut exécuter chacun des types de modules dans l'infrastructure J2EE, y compris des projets Web (comme votre projet Web EGL), EAR et EJB (Enterprise JavaBean). En revanche, Tomcat est un serveur web qui n'exécute que des projets Web ; il ne prend pas en charge les autres types de projets J2EE comme les projets EAR ou EJB.

L'application décrite dans ce tutoriel fonctionnera de la même manière sur les deux serveurs, mais vous devez être conscient de ce qui les différencie. Si vous utilisez WebSphere Application Server, vous devrez créer un projet EAR et y placer les informations de connexion à la base de données. Si vous optez pour Tomcat, vous placerez ces informations directement dans le projet Web EGL.

Pour le reste du tutoriel, tenez compte des sections qui concernent spécifiquement WebSphere Application Server ou Apache Tomcat. Si les instructions font état de projets, de fichiers ou d'options que vous n'avez pas, vérifiez que vous êtes bien en train de suivre la section qui s'applique à votre serveur.

Installation du serveur (WebSphere Application Server)

WebSphere Application Server nécessite généralement d'être installé séparément de votre produit EGL. Vous devez installer WebSphere Application Server dans le même groupe de packages que celui qui contient votre produit EGL. Si vous pouvez voir WebSphere Application Server dans la vue Serveurs, située par défaut en bas du plan de travail, le produit est installé. Si ce n'est pas le cas, vous devez acheter le produit ou utiliser Tomcat.
Le produit est visible dans la vue Serveurs.

Installation du serveur (Tomcat)

L'installation de Tomcat est particulièrement simple, puisqu'elle consiste à télécharger et décompresser une archive contenant les fichiers du serveur et à indiquer au plan de travail où trouver ces fichiers. Suivez les étapes ci-après pour installer et configurer Tomcat 6.0 :
  1. Dans la vue Serveurs, située par défaut en bas du plan de travail, cliquez avec le bouton droit n'importe où dans l'espace vide, puis cliquez sur Nouveau > Serveur.
  2. Dans la fenêtre Définition d'un nouveau serveur, développez IBM si nécessaire, et sélectionnez la version de Tomcat que est installée sur votre système, ou que vous souhaitez qu'EGL installe sur votre système pour vous. Si vous sélectionnez une version avec support de débogage, vous pouvez réaliser vos programmes dans le débogueur EGL.
    Le serveur Tomcat dans la fenêtre Nouveau serveur.
  3. La fenêtre Tomcat Server vous offre le choix suivant :
    • Si Tomcat est déjà installé sur votre système, accédez au Répertoire d'installation de Tomcat.
    • Si vous n'avez pas encore installé Tomcat, cliquez sur Télécharger et installer et suivez les instructions à l'écran. Répétez cette étape lorsque vous avez installé le logiciel.
    Fenêtre du serveur Tomcat.
  4. Cliquez sur Terminer. Le nouveau serveur s'affiche dans la fenêtre Serveurs.
  5. Quittez le plan de travail EGL temporairement et utilisez l'Explorateur Windows pour accéder au dossier dans lequel vous avez installé Tomcat. Localisez le dossier lib dans ce dossier. Le chemin pourrait être le suivant :
    D:\Program Files\Apache\lib
    Vérifiez que ce dossier contient un fichier nommé derby.jar. Si ce n'est pas le cas, copiez le fichier dans le dossier lib à partir du dossier suivant de votre répertoire d'installation :
    répertoire d'installation\plugins\org.apache.derby.core_10.1.2.1

Création du projet Web EGL (s'applique aux deux serveurs)

Comme votre projet aura une interface de type page Web, vous devez créer un projet Web EGL. Un projet Web EGL combine les fonctions d'un projet Web dynamique et d'un projet EGL. Si vous utilisez WebSphere Application Server, vous devrez aussi créer un projet EAR.

  1. Cliquez sur l'icône Nouveau projet EGL dans la partie supérieure gauche du plan de travail.
    Icône Nouveau projet EGL.
    EGL affiche l'assistant Nouveau projet EGL.
  2. Vous pouvez aussi cliquer sur Fichier > Nouveau > Autre, puis dans la boîte de dialogue de sélection d'un assistant, développer le dossier EGL et cliquer sur Projet EGL, puis sur Suivant.
    La boîte de dialogue de sélection d'un assistant affiche le dossier EGL, contenant l'icône Projet EGL.
    EGL affiche l'assistant Nouveau projet EGL.
  3. Dans la zone Nom du projet, entrez le nom de votre projet :
    EGLWeb
  4. Sous Types de projet EGL, sélectionnez Projet Web. Cliquez sur Suivant.
    L'assistant de nouveau projet EGL présente les différents types de projets.
  5. Cliquez sur Suivant.
  6. Dans la zone Environnement d'exécution cible, sélectionnez le nom du serveur d'applications que vous avez vérifié au début de cette leçon.
  7. Sous Options de descripteur de génération, vérifiez que Créer un descripteur de génération est sélectionné.
  8. Cochez la case Afficher les paramètres avancés, puis cliquez sur Suivant.
  9. Laissez la case Utiliser l'emplacement par défaut du projet cochée.
  10. Si vous utilisez WebSphere Application Server, la case Ajouter un projet à un fichier EAR doit être cochée et le nom indiqué dans Nom du projet EAR doit être EGLWebEAR. Acceptez ces deux valeurs par défaut.
  11. Ne modifiez pas les valeurs de la section Modifier les facettes du projet.
  12. Désélectionnez la case Créer un descripteur de déploiement EGL. Les fichiers de descripteur de déploiement EGL contiennent des informations relatives au déploiement et à l'utilisation des services Web. Ce tutoriel ne se connecte à aucun service Web.
    Image de la fenêtre Nouveau projet Web EGL utilisant WebSphere Application Server
  13. Cliquez sur Terminer.
  14. Il est possible qu'un message apparaisse, vous demandant si vous voulez basculer vers la perspective J2EE. Si vous voyez ce message, cliquez sur Non.
Le ou les nouveaux projets sont créés dans votre espace de travail. L'espace de travail peut afficher une fenêtre Technology Quickstarts avec des informations relatives à l'aide. Vous pouvez fermer cette fenêtre.

Importation de la base de données

Ce tutoriel inclut un exemple de base de données Derby à utiliser dans votre application. Dans les étapes qui suivent, vous ajoutez cette base de données à votre projet. Pour plus d'informations sur Apache Derby, une base de données relationnelle à code source ouvert, voir http://db.apache.org/derby/.
  1. Cliquez sur le lien suivant et téléchargez l'exemple de base de données dans un dossier temporaire de votre ordinateur :

    Exemple de base de données

    Vous pouvez sauvegarder la base de données où vous le souhaitez, pourvu que vous puissiez la retrouver ultérieurement.

    Vous pouvez aussi trouver cet exemple de base de données dans le répertoire d'installation de votre produit, à l'emplacement suivant :
    ressources_partagées/plugins/com.ibm.etools.egl.tutorial0001.doc_version/
       resources/EGLDerbyDB.zip
    shared_resources
    The shared resources directory for your product, such as C:\Program Files\IBM\SDP70Shared on a Windows system or /opt/IBM/SDP70Shared on a Linux system. If you installed and kept a previous version of an IBM® product containing EGL before installing your current product, you may need to specify the shared resources directory that was set up in the earlier installation.
    version
    The installed version of the plugin. If more than one is present, use the one with the most recent version number, unless you have a reason to use an older version.
  2. Dans le plan de travail, cliquez sur Fichier > Importer.
  3. Dans la fenêtre Importation, développez Général, cliquez sur Fichier archive, puis sur Suivant.
  4. Dans la zone A partir du fichier d'archive de la fenêtre Fichier archive, entrez l'emplacement du fichier que vous venez de télécharger. Vous pouvez utiliser le bouton Parcourir pour le rechercher.
  5. Dans le bas de l'assistant, à côté de la zone Dans le répertoire, cliquez sur le bouton Parcourir.
  6. Dans la fenêtre Importer dans un dossier, développez EGLWeb, cliquez sur le dossier WebContent pour le sélectionner, puis cliquez sur OK. Ce dossier se trouve là où votre base de données sera ajoutée à votre projet. La fenêtre Importation apparaît comme suit :
    Image de la fenêtre Importation
  7. Cliquez sur Terminer.
La base de données est ajoutée à votre espace de travail dans le dossier WebContent du projet EGLWeb. Ne modifiez directement aucun des fichiers de la base de données. Ultérieurement, vous allez créer une application EGL pour visualiser et modifier cette base de données.

Récapitulatif de la leçon

Dans cette leçon, vous avez créé un ou deux projets, selon le type de serveur choisi. Vous pouvez les parcourir dans la vue Explorateur de projets :
  • Le projet EGLWeb contiendra le code EGL, des pages Web et d'autres fichiers associés à l'application. En particulier, vous allez utiliser les dossiers EGLSource et WebContent qui contiendront respectivement les fichiers de code source EGL et les pages Web de l'application.
  • Le projet EGLWebEAR est la ressource EAR (Enterprise Application Resource) pour le projet EGLWeb. Vous ne l'avez que si vous utilisez WebSphere Application Server.

La vue Explorateur d'entreprise se présente comme suit si vous utilisez : WebSphere Application Server:

Image de la vue Explorateur d'entreprise contenant le projet Web EGL et le projet EAR

La vue Explorateur d'entreprise ressemble à ce qui suit si vous utilisez Tomcat :

La vue Explorateur d'entreprise contient le projet EGLWeb

< Précédent | Suivant >

Retour d'informations