Migrar los recursos JavaServer Faces de un proyecto Web

El soporte JavaServer Faces que originalmente venía con WebSphere Studio Site Developer V5.1.2 se ha actualizado en Rational Web Developer V6.0. Si desea seguir desarrollando en los proyectos Web de la V6.0 que se crearon con WebSphere Studio Site Developer V5.1.2, le recomendamos que actualice los recursos de tiempo de ejecución del proyecto Faces con los niveles más recientes.

Nota: Si creó JavaServer Pages (JSP) que contenían componentes de cliente Faces, debe migrar por separado los recursos de tiempo de ejecución de componentes de cliente Faces a los últimos niveles. Consulte Migrar los recursos JavaServer Faces con componentes de cliente Faces.
Si crea o edita archivos JSP en un proyecto que se haya migrado de WebSphere Studio Site Developer V5.1.2, se le indicará que puede migrar los recursos de tiempo de ejecución del proyecto a los niveles más recientes. Si desea que la migración se lleve a cabo automáticamente, pulse Aceptar.
Nota: Si contesta que No la primera vez que se le pregunte si desea migrar y se queda intencionadamente con los archivos Java de archivado (JAR) anticuados, no se le planteará nuevamente la pregunta. Si más adelante necesita los recursos del proyecto, tendrá que migrarlos manualmente.
Para migrar manualmente los recursos de un proyecto JavaServer Faces:
  1. Importe el proyecto Web existente con el contenido Faces a un área de trabajo de Rational Web Developer V6.0.
  2. Cree un proyecto Web nuevo (o, si está trabajando con EGL, un proyecto Web EGL nuevo) y llame al proyecto JSF60. Este proyecto tan solo lo utilizará como origen de los artefactos de tiempo de ejecución más recientes. Podrá suprimirlo cuando haya terminado la migración.
  3. En el explorador de proyectos, pulse el proyecto JSF60 con el botón derecho del ratón y seleccione Propiedades en el menú. Pase a la pestaña de Características del proyecto Web y seleccione Añadir componentes base de Faces y Añadir infraestructura de cliente Faces.
  4. Si está trabajando con EGL, cree un archivo de página JSF de la forma siguiente:
    1. Pulse el botón derecho del ratón sobre la carpeta WebContent del proyecto Web EGL nuevo.
    2. Seleccione Nuevo > Otros > Archivo JSP Faces. Si necesita ayuda para crear el archivo JSP, pulse la tecla F1.
    Este paso añade los archivos siguientes al proyecto:
    • eglintdebug.jar
    • eglintdebugsupport.jar
  5. Para cada proyecto Faces existente que desee actualizar, haga lo siguiente:
    1. Expanda el proyecto original en el explorador de proyectos para ver los archivos que hay en la carpeta WebContent/WEB-INF/lib/. En este directorio, localice cada uno de los siguientes archivos JAR y suprímalos:
      • eglintdebug.jar (solo EGL)
      • eglintdebugsupport.jar (solo EGL)
      • fda.jar (solo EGL)
      • fdaj.jar (solo EGL)
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • odc-jsf.jar
    2. Localice el archivo WebContent/WEB-INF/faces-config.xml. Añada los siguientes elementos a este archivo de configuración, si todavía no están presentes:
      	<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. Si está trabajando con EGL, copie los archivos fda6.jar y fdaj6.jar en el proyecto existente y no haga nada más con los archivos fda.jar y fdaj.jar, que ya no se utilizan.
    4. Por cada uno de los archivos JAR que suprimió (que no sean los archivos fda.jar y fdaj.jar; consulte el paso anterior), copie el archivo JAR que tenga el mismo nombre en el directorio WebContent/WEB-INF/lib del proyecto JSF60 y péguelo en el proyecto original en la misma ubicación. En algunas configuraciones no hará falta que todos estos archivos JAR estén presentes en el proyecto; no los copie si el proyecto original no tenía un archivo JAR concreto.
    5. Abra el descriptor de despliegue web.xml del proyecto original y añada las siguientes líneas de código a la configuración:
      	<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>
    6. Si el proyecto original utiliza Objetos de datos de WebSphere (WDO) para cualquier acceso de datos, siga estos pasos adicionales:
      1. Cree un archivo JSP Faces temporal en el proyecto original. (Pulse Archivo > Nuevo > Archivo JSP Faces. Consulte la ayuda en línea para obtener ayuda.)
      2. Arrastre un componente de lista de registro relacional de la bandeja Datos de la paleta a la página. Seleccione cualquier conexión y origen de datos y pulse Finalizar; los datos seleccionados no son importantes. Este proceso generará la configuración necesaria para continuar utilizando WDO en este proyecto.
      3. Suprima el archivo JSP temporal.
Si sigue estos pasos, actualizará un proyecto Web más antiguo con los niveles más recientes de la funcionalidad de Faces en Rational Web Developer V6.0.

Si está trabajando con EGL, pulse con el botón derecho del ratón sobre el nombre de cada proyecto Web EGL y pulse Generar; si no está construyendo los proyectos automáticamente, pulse Proyecto > Construir todo.

Tema principal: Migrar de WebSphere Studio V5.1, V5.1.1 o V5.1.2

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.