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 :
- Créer un projet et importer les ressources nécessaires pour le
développement des portlets.
- Installer et configurer l'environnement de test WebSphere Portal v5.1, qui nous permet de tester l'application que nous créons.
- 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é ci-après.
- Ouvrez Rational Software Development Platform.
- Sélectionnez Fichier > Nouveau > Projet.
- 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.
- 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.
- 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.
- La version WebSphere Portal est par défaut la version
5.1. Cliquez sur Suivant.
- 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.
- Cliquez de nouveau sur Suivant.
- 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.
- Cochez la case Modification des options de génération de codes. Entrez UserAdminPortlet dans la zone Préfixe de classe.
- Cliquez sur Suivant.
- 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.
- 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.
- Dans la barre de menus, sélectionnez Fichier > Importer. La boîte de dialogue Importation s'affiche.
- Dans Sélectionnez une source d'importation, cliquez sur Echange de projets.
- Cliquez sur Suivant. La boîte de dialogue Importation des informations
d'échange de projets s'affiche.
- 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.
- 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
où 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.
- Cochez les cases AuctionEJB50 et
AuctionEJB50Client.
- Cliquez sur Fin.
L'assistant importe les projets dans votre espace de travail.
- 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.
- Sélectionnez l'onglet Module.
- 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.
- 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.
- Sauvegardez et fermez le descripteur de déploiement.
Installation et configuration de l'environnement de test WebSphere Portal v5.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 les outils Rational.
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 :
- Sélectionnez Fenêtre > Préférences dans la barre
de menus.
- Développez la section Serveur et cliquez sur
Environnements d'exécution installés.
- Cliquez sur Module de remplacement WebSphere Portal version 5.1, cochez la case et
cliquez sur Editer.
- 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.
- Cliquez sur Fin.
- 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.
- Affichez la vue Serveurs. Elle se situe à proximité des vues
Propriétés et Edition rapide.
- Sélectionnez Nouveau > Serveur dans le menu en
incrustation de la vue.
- Sélectionnez Environnement de test WebSphere Portal version 5.1
dans la liste des types de serveur.
- Cliquez sur Fin.
- Cliquez deux fois sur Environnement de test WebSphere Portal
version 5.1 dans la vue Serveurs.
- Sélectionnez l'onglet Sources de données dans l'éditeur de
serveur.
- Dans la section Paramètres du serveur, cliquez sur
Ajouter pour ajouter une liste dans la liste des fournisseurs
JDBC.
- 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.
- Cliquez sur Suivant.
- Saisissez Cloudscape JDBC Provider dans la zone
Nom.
- Cliquez sur Fin.
- 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.
- 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.
- Saisissez Vente aux enchères dans la zone
Nom.
- Entrez jdbc/auction dans la zone Nom JNDI.
- Cliquez sur Suivant.
- Sélectionnez databaseName dans la liste
Propriétés des ressources.
- 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.
- 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
où x: représente le chemin absolu contenant le plug-in
com.ibm.etools.auction.sampledb_6.0.0 sur votre
ordinateur.
- Cliquez sur Fin.
- 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 :

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.