Mise à jour de ressources d'exécution Faces dans un projet Web

Les ressources d'exécution JavaServer Faces initialement disponibles dans WebSphere Studio Site Developer version 5.1.x ont été mises à jour pour Rational Web Developer version 6.0.1. Si vous souhaitez continuer le développement dans des projets Web créés avec la version précédente du produit, il est recommandé de mettre à niveau les ressources d'exécution Faces.

Dans Rational Web Developer version 6.0.1, les mises à jour des ressources d'exécution Faces sont automatiquement appliquées lorsqu'un projet Web est importé ou qu'un espace de travail contenant des ressources antérieures est ouvert. A l'issue de l'importation d'un projet Web ou de l'ouverture d'un espace de travail de WebSphere Studio Site Developer version 5.1.x vers Rational Web Developer version 6.0.1, le système vous invite à mettre à niveau les ressources d'exécution Faces.

Mise à jour automatique des ressources d'exécution

Pour mettre à jour automatiquement les ressources d'exécution Faces d'un projet Web :
  1. Importez un projet Web (ou un espace de travail) stockant les données Faces de WebSphere Studio Site Developer version 5.1.x. La fenêtre Migration du projet s'affiche.
    Remarque : Si la fenêtre Migration du projet ne s'affiche pas, il est probable que les paramètres de préférences de génération automatique sont désactivés. Dans l'explorateur de projets, cliquez à l'aide du bouton droit de la souris sur un projet Web et sélectionnez Générer > Projet. Le processus de génération d'un projet entraîne l'affichage de la fenêtre Migration du projet.
  2. Si l'espace de travail comporte d'autres projets Web stockant des données Faces, cochez la case Appliquer cette option aux autres projets à mettre à jour pour mettre à jour tous les projets Web.
  3. Cliquez sur l'une des options suivantes :
    • Oui pour exécuter la mise à jour automatiquement.
    • Plus tard pour différer la mise à jour. Pour mettre automatiquement à jour les ressources d'exécution après avoir sélectionné Plus tard, vous devez fermer et rouvrir le projet Web et redémarrer le plan de travail avant de regénérer le projet Web. Si vous avez désactivé les générations automatiques, cliquez sur le projet Web à l'aide du bouton droit de la souris et sélectionnez Générer un projet.
    • Jamais pour conserver les ressources d'exécution à un niveau antérieur. Si vous sélectionnez Jamais et que vous conservez volontairement les ressources d'exécution à un niveau antérieur, le système ne vous invite plus à les mettre à jour. Vous devrez migrer manuellement les ressources de projet si vous en avez besoin ultérieurement.
Remarque : Si vous avez créé des pages JSP Faces qui contiennent des composants Faces Client, vous devez mettre à niveau séparément les ressources d'exécution des composants Faces Client. Reportez-vous à la section Mise à jour de ressources d'exécution Faces client dans un projet Web.

Mise à jour manuelle des ressources d'exécution

Pour mettre à jour manuellement les ressources d'exécution Faces d'un projet Web :
  1. Importez le projet Web stockant les données Faces dans un environnement Rational Web Developer version 6.0.1.
  2. Créez un projet Web (ou si vous utilisez EGL, créez un projet Web EGL) et appelez-le JSF601. Vous devez utiliser ce projet uniquement comme source pour les artefacts d'exécution les plus récents. Il peut être supprimé une fois que la mise à jour est terminée.
  3. Dans l'explorateur de projets, cliquez à l'aide du bouton droit de la souris sur JSF601 et sélectionnez Propriétés dans le menu.
  4. Cliquez sur Fonctions du projet Web et sélectionnez Ajout des composants de base Faces et Ajout de Faces Client Framework, puis cliquez sur OK.
  5. Si vous utilisez EGL, créez un fichier JSP de la manière suivante :
    1. Cliquez à l'aide du bouton droit de la souris sur le dossier WebContent du nouveau projet Web EGL.
    2. Sélectionnez Nouveau > Autre > Fichier JSP Faces.
    Les fichiers eglintdebug.jar et eglintdebugsupport.jar sont ajoutés au projet.
  6. Pour chaque projet Faces à mettre à jour, procédez comme suit :
    1. Dans l'explorateur de projets, développez un projet pour visualiser les fichiers du dossier WebContent/WEB-INF/lib/. Dans ce répertoire, recherchez et supprimez les fichiers JAR suivants :
      • eglintdebug.jar (EGL uniquement)
      • eglintdebugsupport.jar (EGL uniquement)
      • fda.jar (EGL uniquement)
      • fdaj.jar (EGL uniquement)
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • odc-jsf.jar
    2. Recherchez et ouvrez le fichier WebContent/WEB-INF/faces-config.xml. Si nécessaire, ajoutez les éléments suivants à ce fichier de configuration :
      	<lifecycle>
      		<phase-listener>com.ibm.faces.webapp.ValueResourcePhaseListener</phase-listener>
      	</lifecycle>
      	
      	<application>
      		<variable-resolver>com.ibm.faces.databind.SelectItemsVarResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
    3. Pour les fichiers JAR supprimés, copiez le fichier JAR portant le même nom dans le répertoire WebContent/WEB-INF/lib du projet JSF601 et collez-le dans le projet d'origine situé au même emplacement. Certaines configurations ne requièrent pas le stockage de tous ces fichiers JAR dans le projet. Ne copiez pas un fichier JAR spécifique s'il ne figure pas dans le projet d'origine.
    4. Ouvrez le descripteur de déploiement web.xml dans le projet d'origine et ajoutez les chaînes suivantes à la configuration :
      	<context-param>
      		<param-name>com.ibm.ws.jsf.JSP_UPDATE_CHECK</param-name>
      		<param-value>true</param-value>
      	</context-param>
      	<context-param>
      		<param-name>com.ibm.ws.jsf.LOAD_FACES_CONFIG_AT_STARTUP</param-name>
      		<param-value>true</param-value>
      	</context-param>
    5. Si le projet d'origine utilisait des objets WDO (WebSphere Data Object) pour l'accès aux données, suivez la procédure ci-après.
      1. Dans le projet d'origine, cliquez sur Fichier > Nouveau > Fichier JSP Faces pour créer un fichier JSP Faces temporaire.
      2. Déplacez un composant de liste d'enregistrements relationnels à partir du tiroir de données sur la palette de la page.
      3. Sélectionnez une connexion et une source de données et cliquez sur Terminer. Les données sélectionnées ne sont pas importantes. Cette procédure génère les configurations nécessaires pour continuer à utiliser les objets WDO dans ce projet.
      4. Supprimez le fichier JSP temporaire.
    6. Si vous utilisez EGL, cliquez avec le bouton droit de la souris sur le nom de chaque projet Web EGL et cliquez sur Générer. Puis, si vous ne créez pas de projets automatiquement, cliquez sur Projet > Construire tout.
  7. Supprimez le projet JSF601.
Tâches associées
Mise à jour des ressources d'exécution Faces pour les projets Web de Rational Web Developer version 6.0
Mise à jour de ressources d'exécution Faces client dans un projet Web
Commentaires
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.