Migration de ressources Faces dans un projet de portlet

Le support JavaServer Faces fourni dans WebSphere Studio Site Developer V5.1.2 a été mis à jour pour Rational Web Developer V6.0. Si vous souhaitez continuer le développement dans les projets de portlet V6.0 créés avec Portal Toolkit 5.0.2.2 sur WebSphere Studio Site Developer V5.1.2, il est recommandé de mettre à niveau les ressources d'exécution du projet Faces.

Remarque : Si vous créez des pages JSP (JavaServer Pages) qui contiennent des composants Faces Client, vous devez migrer séparément les ressources d'exécution des composants Faces Client vers les derniers niveaux. Reportez-vous à la section Migration de ressources JavaServer Faces avec des composants Faces Client.
Si vous créez ou modifiez des pages JSP dans un projet de portlet migré à partir de Portal Toolkit 5.0.2.2 sur WebSphere Studio Site Developer V5.1.2, vous êtes invité à migrer les ressources d'exécution du projet de portlet vers les derniers niveaux. Cliquez sur OK pour terminer la migration.
Remarque : Si vous répondez Non à la première invite de migration et que vous conservez intentionnellement des fichiers JAR de niveaux antérieurs, cette invite ne s'affiche plus. Vous devez migrer les ressources du projet de portlet manuellement si vous en avez besoin ultérieurement. Procédez comme suit :
  1. Importez le projet de portlet existant avec le contenu Faces dans un espace de travail Rational Web Developer V6.0.
  2. Créez un projet de portlet nommé JSFP60 avec l'option Portlet Faces sélectionnée dans la deuxième page. Vous ne devez utiliser ce projet uniquement comme source pour les artefacts d'exécution les plus récents. Il peut être supprimé une fois la migration terminée.
  3. Dans l'explorateur de projets, cliquez à l'aide du bouton droit de la souris sur le projet JSFP60 et sélectionnez Propriétés dans le menu. Dans l'onglet Fonctions du projet Web et sélectionnez Ajouter la structure de client Faces au projet de portlet.
  4. Pour chaque projet Faces existant à mettre à niveau, procédez comme suit :
    1. Développez le projet d'origine dans l'explorateur de projets afin d'afficher les fichiers du dossier WebContent/WEB-INF/lib/. Dans ce répertoire, localisez et supprimez les fichiers JAR suivants :
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • jsf-portlet.jar
      • odc-jsf.jar
    2. Localisez 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>
      		<variable-resolver>com.ibm.faces.application.WPPortletVariableResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
      Remarque : Si le projet de portlet utilise l'API JSR 168, indiquez com.ibm.faces.application.PortletVariableResolver à la place de com.ibm.faces.application.WPPortletVariableResolver.
  5. Pour les fichiers JAR supprimés, copiez le fichier JAR portant le même nom se trouvant dans le répertoire WebContent/WEB-INF/lib du projet JSFP60 et collez-le dans votre projet situé au même emplacement. Pour certaines configurations, il est nécessaire que tous ces fichiers JAR se trouvent dans le projet. Ne les copiez pas si le projet d'origine ne dispose d'aucun fichier JAR particulier.
    1. Si votre projet de portlet utilise l'API IBM ou un composant de lien personnel, copiez le fichier jsf-portlet-wp.jar dans le projet d'origine.
    2. Si vous copiez le fichier odc-jsf.jar, copiez également le fichier odc-jsf-portlet.jar.
Si vous suivez cette procédure, un projet de portlet antérieur bénéficiera des derniers niveaux de fonctionnalité Faces dans Rational Web Developer V6.0.

Tâches associées
Migration à partir de WebSphere Studio V5.1, 5.1.1 ou 5.1.2
Migration de ressources JavaServer Faces avec des composants Faces Client

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