Configuration de l'exemple Employee List (Liste d'employés)

Cet exemple contient une application Web fonctionnelle qui accède à une base de données via des entités JPA (Java Persistence API).
Pourquoi et quand exécuter cette tâche
Important : Cet exemple s'importe avec des erreurs. Avant d'exécuter cet exemple sur un serveur, vous devez configurer le fichier de persistance JPA pour corriger les erreurs. Les instructions correspondantes sont fournies ci-après.

Exécution de l'exemple sur WebSphere Application Server version 7.0

Pourquoi et quand exécuter cette tâche
Une fois l'importation terminée, effectuez les étapes suivantes pour exécuter l'exemple et le tester sur un serveur :
  1. Ouvrez la perspective Web (sélectionnez Fenêtre > Ouvrir la perspective > Web).
  2. Vérifiez que WebSphere Application Server version 7.0 est disponible :
    1. Ouvrez la vue Serveurs (sélectionnez Fenêtre > Afficher la vue > Serveurs).
    2. Si WebSphere Application Server v7.0 ne figure pas dans la liste, définissez un nouveau serveur (cliquez avec le bouton droit de la souris dans la vue Serveurs et sélectionnez Nouveau > Serveur). Suivez les instructions de l'assistant Nouveau serveur, en vérifiant que vous avez sélectionné WebSphere Application Server version 7.0. Sur la page Paramètres du serveur WebSphere, décochez Exécuter le serveur et les ressources dans l'espace de travail.
    3. Si WebSphere Application Server v7.0 se trouve dans la liste, double-cliquez sur celui-ci pour ouvrir l'éditeur de serveur. Dans la section Paramètres de publication pour WebSphere Application Server de l'éditeur, cliquez sur Exécuter le serveur et les ressources sur le serveur. Appuyez sur les touches CTRL+S pour enregistrer les paramètres.
  3. Vérifiez que votre projet Web est associé à un environnement d'exécution :
    1. Dans l'Explorateur Enterprise, cliquez avec le bouton droit de la souris sur EmployeeListWeb et sélectionnez Propriétés. La fenêtre de propriétés du projet EmployeeListWeb s'ouvre.
    2. Cliquez sur Environnements d'exécution cible.
    3. Sélectionnez WebSphere Application Server v7.0 dans la liste des environnements d'exécution si celui-ci n'est pas déjà sélectionné. Cliquez sur Appliquer pour appliquer les modifications à votre projet Web.
    4. Cliquez sur OK pour accepter les modifications et revenir au plan de travail.
  4. Editez manuellement le fichier de configuration JPA relatif à la persistance :
    1. Dans la vue Explorateur Enterprise, développez EmployeeListWeb > Ressources Java/source > META-INF.
    2. Double-cliquez deux fois sur persistence.xml pour l'ouvrir dans l'éditeur.
    3. Passez à l'onglet Source de l'éditeur.
    4. Editez les informations relatives à l'adresse URL de connexion en fonction de votre espace de travail :
      Editez la ligne suivante :
      <property name="openjpa.ConnectionURL" 
	value="jdbc:derby:<emplacement_espace_travail>\EmployeeListWeb\WebContent\sample" />
      Remplacez <emplacement_espace_travail> par le répertoire dans lequel se trouve votre espace de travail courant. Par exemple :
      <property name="openjpa.ConnectionURL" 
	value="jdbc:derby:C:\workspace\EmployeeListWeb\WebContent\sample" />
    5. Enregistrez le fichier. Les erreurs de persistence.xml sont corrigées.
    Important : Si des ressources JavaServer Faces ou des données de configuration de projet plus récentes sont disponibles, une erreur supplémentaire sera affichée dans la vue Erreurs. 
    Les ressources Faces doivent être mises à jour (utilisez Correctif rapide).
    Pour corriger l'erreur :
    1. Dans la vue Erreurs, cliquez avec le bouton droit sur l'erreur et sélectionnez Correctif rapide. La boîte de dialogue Correctif rapide s'ouvre.
    2. Dans la liste Sélectionnez un correctif, sélectionnez Ouvrir la boîte de dialogue de mise à jour de ressources. Cliquez ensuite sur Terminer. Le boîte de dialogue Mise à jour de ressources s'ouvre.
      • Cliquez sur Oui pour effectuer la mise à jour automatiquement. Si un projet est toujours en cours de développement, il est recommandé d'utiliser les ressources les plus récentes car dans certains cas, le produit peut générer des balises ou des attributs qui ne seront pas disponibles tant que les ressources n'ont pas été mises à jour.
      • Cliquez sur Plus tard pour différer la décision de mettre à jour. Ceci supprimera le marqueur d'erreur pour la session du plan de travail en cours. Pour revenir à la boîte de dialogue Mise à jour de ressources après avoir sélectionné Plus tard, fermez et réouvrez le projet Web ou redémarrez le plan de travail pour que l'analyse d'arrière-plan se produise à nouveau. Il peut être nécessaire de régénérer votre espace de travail pour initialiser l'analyse.
      • Cliquez sur Jamais pour conserver vos ressources d'exécution à leur niveau en cours, plus ancien. Si un projet est déjà terminé et fonctionnel, vous pouvez choisir de laisser les ressources Faces à leur version en cours. Le projet ne sera pas analysé à nouveau tant que des versions ultérieures des ressources ne seront pas disponibles dans le produit.
  5. Dans la vue Serveurs, cliquez avec le bouton droit de la souris sur WebSphere Application Server v7.0 et sélectionnez Démarrer. Attendez le démarrage du serveur.
    Remarque : Si le serveur est déjà démarré, redémarrez-le.
  6. Dans la vue Explorateur Enterprise, développez EmployeeListWeb > WebContent. Cliquez avec le bouton droit de la souris sur index.jsp et sélectionnez Exécuter en tant que > Exécuter sur le serveur. La fenêtre Exécuter sur le serveur s'ouvre.
  7. Sélectionnez WebSphere Application Server v7.0.
  8. Cliquez sur Terminer.
Résultats
Le projet EmployeeListWeb est publié sur le serveur. Une fenêtre de navigateur Web s'ouvre et affiche une page initiale qui vous redirige vers la page d'accueil du site Web.
Page d'accueil de l'application Employee List (Liste d'employés)

Connexion à la base de données

Vous pouvez vous connecter à la base de données pour générer et configurer des entités JPA.
Avant de commencer
Vous devez arrêter le serveur pour pouvoir vous connecter à la base de données. Pour cela, dans la vue Serveur, cliquez avec le bouton droit sur le serveur et sélectionnez Arrêter. Attendez que le serveur s'arrête avant de créer la connexion à la base de données.
Pourquoi et quand exécuter cette tâche

Pour plus d'informations sur l'accès aux données d'une application Web à l'aide de JPA, voir la rubrique d'aide Aide : Ajout de données à une page Web à l'aide de JPA.

Pour créer une connexion à la base de données :

  1. Dans l'Explorateur Enterprise, cliquez avec le bouton droit de la souris sur EmployeeListWeb et sélectionnez Propriétés. La fenêtre Propriétés de EmployeeListWeb s'ouvre.
  2. Cliquez sur JPA.
  3. Vérifiez que la plateforme RAD JPA est sélectionnée dans la liste des plateformes.
  4. Cliquez sur Ajouter une connexion. L'assistant Nouveau profil de connexion s'ouvre.
  5. Dans la liste des profils de connexion, cliquez sur Derby puis sur Suivant. L'assistant Base de données Derby imbriquée s'ouvre.
  6. Nommez votre connexion EmployeeDB. Cliquez sur l'option de connexion automatique au démarrage puis cliquez sur Suivant.
  7. Dans l'assistant, sur la page Spécification d'un pilote et des caractéristiques de la connexion, sélectionnez Derby 10.2 - Pilote JDBC intégré par défaut dans la liste Pilotes.
  8. Dans la zone Emplacement de la base de données de l'onglet Propriétés générales de l'assistant, cliquez sur Parcourir et sélectionnez <emplacement_espace_de_travail>EmployeeListWeb\WebContent\sample puis cliquez sur OK.
  9. Cliquez sur Tester la connexion pour vérifier que vous pouvez vous connecter à la base de données Derby. Dans la boîte de dialogue Réussite, cliquez sur OK. Cliquez sur Suivant.
  10. Cliquez sur Terminer pour terminer la connexion à la base de données Derby. Cliquez sur Appliquer pour appliquer les modifications à votre projet Web. Cliquez sur OK.
Vos commentaires