Exercice 1.1 : Importation des ressources requises
Avant de commencer ce module, importez les projets client EJB
et EJB préalablement générés dans le projet de portlet utilisé dans ce
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.
- Ouvrez Rational Developer.
- 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.
Remarque : Lorsque vous entrez le nom du projet (et si vous
cliquez sur le bouton Afficher les options avancées >>),
le module de ce projet s'ajoute automatiquement dans un projet EAR portant un nom similaire.
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
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/samples
où x: représente le chemin absolu contenant le plug-in
com.ibm.etools.portal.examples.application_6.0.0 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.
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 v5.0
dans la liste des types de serveur.
- Cliquez sur Terminer.
- Cliquez deux fois sur Environnement de test WebSphere Portal
v5.0 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.