Importación de aplicaciones al entorno de desarrollo

Organización de proyecto de Eclipse tradicional

Para analizar el código fuente de aplicación para la migración, se debe importar la aplicación al IDE basado en Eclipse. Los módulos de aplicación se deben organizar en proyectos que reflejen la estructura como archivos EAR, WAR (archivador web) y EJB (Enterprise JavaBeans). Específicamente, algunos arreglos rápidos de migración que cambian las extensiones y los enlaces web y EJB sólo funcionan cuando se analizan proyectos con las facetas de proyecto adecuadas para indicar que contienen código para módulos web dinámicos y módulos EJB.

Si los archivos aún no están en Eclipse, puede importar los módulos EAR, WAR y EJB existentes o crear manualmente proyectos nuevos en el espacio de trabajo para cada módulo EAR, WAR y EJB. Puede utilizar las opciones Importar de Eclipse para crear la estructura de proyectos correcta. Son necesarios Rational Application Developer o las herramientas de desarrollador de Eclipse para Java EE para crear estos proyectos debidamente.

Por ejemplo, para importar un archivo EAR, vaya a Archivo > Importar, seleccione Java EE > Archivo EAR. Entre la ubicación del archivo EAR. Eclipse crea un proyecto para el archivo EAR y un proyecto para cada módulo de la aplicación.

Figura 1. Importación de un archivo EAR
Importar archivo EAR de Java EE

Cuando importa la aplicación, se crea la estructura de proyectos adecuada con la información del descriptor de despliegue. Si el archivo EAR contiene el código fuente de Java, también se importará al proyecto de Eclipse. Sin embargo, la mayoría de archivos EAR y de módulo no contienen código fuente y debe copiarlo en las carpetas de origen correctas. De nuevo, vaya a Archivo > Importar para importar el código fuente desde el sistema de archivos o desde un archivo ( .zip ). Repita este procedimiento para importar el código fuente de cada módulo.

Para crear proyectos manualmente, vaya a Archivo > Nuevo y seleccione el tipo de proyecto adecuado:
  • Archivo EAR: Proyecto de aplicación empresarial
  • Archivo WAR: Proyecto web dinámico
  • Módulo EJB: Proyecto EJB
Para copiar los archivos de origen a sus ubicaciones correctas en el proyecto, vaya a Archivo > Importar.

Revise las siguientes instrucciones para estructurar proyectos:

  • Coloque el código fuente Java de un archivo WAR (por ejemplo, clases de servlet, modelo o programa de utilidad) en la carpeta src del proyecto. La carpeta src ya está definida y se puede cambiar en las propiedades de la Vía de acceso de compilación Java del proyecto. Si más de un archivo WAR debe hacer referencia al código fuente Java, consulte Proyectos Java compartidos para obtener información sobre la estructuración de los archivos del proyecto.
  • Coloque el código fuente Java para un módulo EJB en la carpeta ejbModule del proyecto EJB.
  • Coloque las bibliotecas precompiladas de archivo Java (JAR) para un archivo WAR en la carpeta WebContent/WEB-INF/lib.
  • Coloque las bibliotecas JAR de nivel EAR en la carpeta EarContent del proyecto de aplicación empresarial. Si el proyecto contiene una carpeta APP-INF/lib, colóquela en la carpeta EarContent; sin embargo, debe ejecutar la regla de vía de acceso de clases y su arreglo rápido para actualizar las vías de acceso de clases correctamente.

Para obtener una descripción más detallada de cómo importar aplicaciones en el IDE, consulte la Guía de migración de WebSphere Application Server V8.5 ( http://www.redbooks.ibm.com/redbooks/pdfs/sg248048.pdf ).

Proyectos de Maven

Para analizar de forma eficaz una aplicación que utiliza Maven, instale el último M2Eclipse (m2e) en el entorno de Eclipse. WebSphere Developer Tools (WDT) y Rational Application Developer incluyen m2e en el paquete de instalación. Para que algunos de los arreglos rápidos de migración se ejecuten correctamente, es necesario establecer las facetas adecuadas en los proyectos. Por ejemplo, un proyecto web necesita la faceta de módulo web dinámico y un proyecto EJB necesita la faceta de módulo EJB. Cualquier proyecto recién creado en un IDE con m2e instalado se crea automáticamente con las facetas apropiadas cuando se elige el arquetipo correcto. Cuando importe proyectos de Maven que no se han creado en un entorno con m2e, compruebe el proyecto para ver si se han establecido las facetas adecuadas. Para verificar las facetas, haga clic con el botón derecho del ratón en el proyecto y vaya a Propiedades > Faceta del proyecto. Puede ejecutar en una ventana con un mensaje similar al de la Figura 4.

Figura 2. Convertir a faceta
Convertir a faceta

Seleccione la opción Convertir a formulario con facetas para ir a la vista de faceta de proyecto correcta. Seleccione la faceta correcta para proyectos web y proyectos EJB.