Exercice 1.1 : Configuration

Avant de commencer à développer des portlets et des portails dans ce tutoriel, vous devez effectuer quelques opérations de configuration :

  1. Créer un projet et importer les ressources nécessaires pour le développement des portlets.
  2. Installer et configurer l'environnement de test WebSphere Portal version 5.1, qui nous permettra de tester l'application que nous créons.
  3. Configurer un serveur de base de données qui fournira les données nécessaires à l'exécution de l'application.

La première opération consiste à importer les projets EJB et client EJB dans le projet de portlet que nous utiliserons dans le tutoriel. Le projet AuctionPortletEAR créé lors de la création du projet de portlet contiendra les ressources importées. Ces projets fournissent les services dorsaux qui permettent de créer le portlet inclus dans le projet de portlet.

Création d'un projet de type portlet

La totalité du développement de portlet s'effectue dans le contexte d'un projet de type portlet. Pour créer le projet de portlet pour le portlet UserAdmin, procédez comme indiqué c-après.

  1. Ouvrez Rational Developer.
  2. Sélectionnez Fichier > Nouveau > Projet.
  3. Sélectionnez l'option Projet de portlet. Cette option génère des ressources de projet qui prennent en charge l'API de portlet IBM, par opposition à l'API de portlet JSR 168. Cliquez sur Suivant.
  4. Cliquez sur OK dans la boîte de dialogue de confirmation de l'activation. Cette dernière confirme l'activation des fonctions de développement de portail. Les fonctions sont les éléments de votre environnement de développement ainsi que le jeu d'outils appropriés qui automatisent la plupart des normes de programmation et des fonctions de génération de code requises pour le développement des applications Web basées sur le portail exécutées sur WebSphere Portal.
  5. Nommez le projet AuctionPortlet.
    Lorsque vous entrez le nom du projet (et que vous cliquez sur le bouton Afficher les options avancées >>), le module de ce projet s'ajoute automatiquement à un projet EAR portant un nom similaire.
  6. La version WebSphere Portal est par défaut la version 5.1. Cliquez sur Suivant.
  7. Sélectionnez le bouton d'option Portlet Faces, car les portlets créés dans ce tutoriel tirent parti de la vitesse et de la souplesse fournies par JavaServer Faces et des outils de portlet permettant la génération d'interfaces utilisateur pour les applications Web. Cliquez sur Suivant.
  8. Cliquez de nouveau sur Suivant.
  9. Sur la page Paramètres de portlet, saisissez portlet UserAdmin dans la zone Nom du portlet et User Admin dans la zone Titre du portlet.
  10. Cochez la case Modification des options de génération de codes. Entrez UserAdminPortlet dans la zone Préfixe de classe.
  11. Cliquez sur Suivant.
  12. Sur la page Divers, notez que la valeur Page initiale, dans le groupe Mode Affichage est /UserAdminView.jsp. Cette page par défaut sera générée dans le projet et fera office de page principale du portlet UserAdmin. D'autres pages seront ajoutées dans les exercices suivants.
  13. Cliquez sur Fin.

    Si vous êtes invité à accéder à la perspective Web, cliquez sur Oui.

La page d'affichage de portlet par défaut, UserAdminView.jsp, apparaît dans la zone d'édition de votre espace de travail.

Importation des ressources utilisées dans cet exemple

Pour importer AuctionPortal.zip, qui inclut toutes les ressources de projet préalablement générées, nécessaires à la création des interfaces et des accès aux données décrits dans ce tutoriel, procédez comme indiqué ci-après.

  1. Dans la barre de menus, sélectionnez Fichier > Importer. La boîte de dialogue Importation s'affiche.
  2. Dans Sélectionnez une source d'importation, cliquez sur Echange de projets.
  3. Cliquez sur Suivant. La boîte de dialogue Importation des informations d'échange de projets s'affiche.
  4. Etant donné que les différents produits Rational utilisent des emplacements cible d'installation différents, vous devez laisser l'interface utilisateur du produit pour localiser le plug-in renfermant le contenu de la base de données. A l'aide d'un outil de recherche de fichiers, localisez le dossier du plug-in com.ibm.etools.portal.examples.application_6.0.0.1 dans le chemin d'installation du produit, dans le système de fichiers local.
  5. En regard de A partir du fichier zip, cliquez sur Parcourir et accédez à AuctionPortal.zip à l'emplacement suivant :
    x:\com.ibm.etools.portal.examples.application_6.0.0.1/samples
    x: représente le chemin absolu contenant le plug-in com.ibm.etools.portal.examples.application_6.0.0.1 sur votre ordinateur. Cliquez sur Ouvrir.
  6. Cochez les cases AuctionEJB50 et AuctionEJB50Client.
  7. Cliquez sur Fin.

    L'assistant importe les projets dans votre espace de travail.

  8. Vous devez également ajouter les projets importés en tant que modules dans le projet AuctionPortletEAR. Dans l'explorateur de projets, développez Applications d'entreprise > AuctionPortletEAR, puis cliquez deux fois sur Descripteur de déploiement : AuctionPortletEAR.
  9. Sélectionnez l'onglet Module.
  10. Cliquez sur Ajouter sous Modules. Sélectionnez AuctionEJB50 et cliquez sur Terminer. Si la boîte de dialogue Changement de serveur cible vous invite à modifier le serveur cible du module en serveur cible EAR, cliquez sur Oui.
  11. Cliquez sur Ajouter sous Fichiers JAR d'utilitaire du projet. Sélectionnez AuctionEJB50Client et cliquez sur Terminer. Si la boîte de dialogue Changement de serveur cible vous invite à modifier le serveur cible du module en serveur cible EAR, cliquez sur Oui.
  12. Sauvegardez et fermez le descripteur de déploiement.

Installation et configuration de l'environnement de test WebSphere Portal version 5.1

Bien que l'environnement de test WebSphere Portal version 5.0 soit installable à partir du tableau de bord du produit, les ressources présentes dans ce tutoriel sont conçues pour fonctionner sous WebSphere Portal version 5.1. Vous devez installer l'environnement de test WebSphere Portal 5.1 comme il est décrit dans le Guide d'installation du produit. Pour cette installation, utilisez les supports WebSphere Portal fournis avec Rational Developer.

Après avoir installé cette version de l'environnement de test, configurez-le de telle sorte qu'il s'exécute dans votre espace de travail :

  1. Sélectionnez Fenêtre > Préférences dans la barre de menus.
  2. Développez la section Serveur et cliquez sur Environnements d'exécution installés.
  3. Cliquez sur Module de remplacement WebSphere Portal version 5.1, cochez la case et cliquez sur Editer.
  4. Remplacez le nom par WebSphere Portal version 5.1 et les valeurs de Emplacement de WebSphere Portal et Emplacement de WebSphere Application Server par les répertoires d'installation de l'environnement de test WebSphere Portal version 5.1 que vous avez indiqués lors de l'installation de l'environnement de test.
  5. Cliquez sur Terminer.
  6. Cliquez sur OK dans la boîte de dialogue Préférences.

Une fois ces opérations terminées, le serveur d'environnement de test WebSphere Portal version 5.1 est disponible pour les tests, le débogage ou le profilage.

Vous devez ensuite configurer un serveur de base de données contenant les données utilisées par les applications dans ce tutoriel.

Création et configuration d'un serveur contenant une base de données d'application exemple

Dans cet exercice, vous devez importer et configurer une base de données Cloudscape pour fournir des données à l'application AuctionPortal.

  1. Affichez la vue Serveurs. Elle se situe à proximité des vues Propriétés et Edition rapide.
  2. Sélectionnez Nouveau > Serveur dans le menu en incrustation de la vue.
  3. Sélectionnez Environnement de test WebSphere Portal version 5.1 dans la liste des types de serveur.
  4. Cliquez sur Fin.
  5. Cliquez deux fois sur Environnement de test WebSphere Portal version 5.1 dans la vue Serveurs.
  6. Sélectionnez l'onglet Sources de données dans l'éditeur de serveur.
  7. Dans la section Paramètres du serveur, cliquez sur Ajouter pour ajouter une liste dans la liste des fournisseurs JDBC.
  8. Sur la première page de l'assistant Création d'un fournisseur JDBC, sélectionnez Cloudscape comme Type de base de données et Cloudscape JDBC Provider comme type de fournisseur JDBC.
  9. Cliquez sur Suivant.
  10. Saisissez Cloudscape JDBC Provider dans la zone Nom.
  11. Cliquez sur Fin.
  12. Cliquez sur le bouton Ajouter situé en regard de la liste Source de données définie dans le fournisseur JDBC sélectionné ci-dessus.
  13. Sur la première page de l'assistant Création d'une source de données, sélectionnez Cloudscape JDBC Provider et cliquez sur Suivant.
  14. Saisissez Vente aux enchères dans la zone Nom.
  15. Entrez jdbc/auction dans la zone Nom JNDI.
  16. Cliquez sur Suivant.
  17. Sélectionnez databaseName dans la liste Propriétés des ressources.
  18. Etant donné que les différents produits Rational utilisent des emplacements cible d'installation différents, vous devez laisser l'interface utilisateur du produit pour localiser le plug-in renfermant le contenu de la base de données. A l'aide d'un outil de recherche de fichiers, localisez le dossier du plug-in com.ibm.etools.auction.sampledb_6.0.0 dans le chemin d'installation du produit, dans le système de fichiers local.
  19. Revenez à l'assistant Création d'une source de données et entrez le chemin suivant dans la zone Valeur :
    x:\com.ibm.etools.auction.sampledb_6.0.0\db\AUCTION60
    x: représente le chemin absolu contenant le plug-in com.ibm.etools.auction.sampledb_6.0.0 sur votre ordinateur.
  20. Cliquez sur Fin.
  21. Sauvegardez et fermez le fichier de configuration du serveur.

Vous pourrez désormais accéder aux données de la base de données AUCTION60 lors des tests des portlets dans le projet AuctionPortlet, au fur et à mesure de leur développement dans le Module 1.

A propos des fichiers utilisés dans ce tutoriel

Vous pouvez accéder aux fichiers dans les projets AuctionEJB50 et AuctionEJB50Client, notamment aux sources de données et à la logique des pages de portlet. Lorsque vous développez les dossiers, le contenu de l'explorateur de projets doit avoir l'aspect suivant :
AuctionPortletEJB dans la vue Navigateur

Les ressources de ce projet permettront de créer les interfaces utilisateur pour les portlets créés dans ce tutoriel et de fournir l'accès aux données de la base de données Cloudscape exemple. Les beans EJB session UserFacade et ListingFacade fourniront les méthodes appelées à partir des portlets créés dans ce tutoriel. Les beans d'accès aux données RegistrationData et ItemData seront utilisés pour acheminer les données entre les portlets et la base de données Cloudscape, à l'aide de beans entity. Le projet EJB fournit les mappages de base de données pour les beans entity.

A présent, vous êtes prêt à commencer l'Exercice 1.2 : Préparation du développement de portlet et définition du flux de l'application.

Conditions d'utilisation | Commentaires
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.