Conversión de proyectos existentes a Maven

Puede convertir proyectos Java™ EE existentes a Maven.

Antes de empezar

Realice una copia de seguridad de su espacio de trabajo para poder volver al estado original del proyecto, si es necesario.

Acerca de esta tarea

El orden recomendado de las tareas para convertir proyectos es el siguiente:

  1. Establecer preferencias recomendadas.
  2. Convertir proyectos no EAR.
  3. Convertir proyectos EAR.
    1. Crear una carpeta de contenido.
    2. Convertir el proyecto EAR.
    3. Añadir módulos a un EAR.
    4. Añadir dependencias a otros módulos.
    5. Añadir bibliotecas al directorio de bibliotecas EAR.

Establecer preferencias recomendadas

Acerca de esta tarea

Para utilizar el espacio de trabajo para proyectos Maven, defina primero las preferencias recomendadas.

Procedimiento

  1. Acceda a las preferencias de valores del proyecto Maven. Pulse Ventana > Preferencias > Java EE > Maven > Valores del proyecto Maven.
  2. Pulse Establecer todos los valores Maven. Se establecerán las preferencias que representan las recomendaciones para la configuración de Maven.
  3. Pulse Aceptar para completar la definición de las preferencias.

Conversión de proyectos web, EJB, conector, cliente de aplicaciones, programas de utilidad, fragmento web y cliente ejb.

Acerca de esta tarea

Cuando convierte un proyecto, tenga en cuenta las dependencias que tiene con otros artefactos y cómo se accede a los artefactos mediante el proyecto. En proyectos no Maven, se especifica esta información en los metadatos del proyecto y los archivos MANIFEST.MF directamente. Sin embargo, en proyectos Maven, las dependencias se especifican en el archivo pom.xml. Por ejemplo, se puede acceder a los artefactos a través del archivo MANIFEST.MF o se pueden desplegar en el directorio de bibliotecas del EAR que contenga el proyecto. Para proyectos web, los artefactos se pueden desplegar en el directorio WEB-INF/lib.

En primer lugar, utilice la página Conjunto de despliegue para recopilar la información de dependencias.
  1. Pulse el proyecto con el botón derecho del ratón.
  2. Seleccione Propiedades > Conjunto de despliegue.
  3. Pulse la pestaña Entradas de manifiesto. Tome nota de todas las entradas a las que hace referencia el proyecto.
  4. Para proyectos web, pulse la pestaña Conjunto de despliegue. Tome nota de todos los proyectos y archivos JAR con una vía de acceso de despliegue que empieza por WEB-INF/lib.
Nota: Si el proyecto EAR que contiene la faceta del proyecto EAR de la versión 5 o 6, puede que el proyecto haga referencia a las clases de los proyectos o archivos JAR en el directorio de bibliotecas del archivo EAR. Tome nota de estas referencias también.

Tras recopilar la información necesaria, puede convertir el proyecto a Maven.

Procedimiento

  1. Pulse el botón derecho del ratón en el proyecto y seleccione Configure > Convertir a proyecto Maven.
  2. Complete el diálogo POM de Maven. Escriba un ID de grupo, ID de artefacto y Versión o acepte los valores predeterminados. De forma opcional, escriba un Nombre y una Descripción. Para Empaquetado, realice la selección según los siguientes tipos de proyecto:
    Proyectos web
    war
    Proyectos EJB
    ejb
    Conector, programa de utilidad, fragmento web y proyectos de cliente EJB
    jar
    Proyectos de clientes de aplicaciones
    app-client
  3. Pulse Finalizar para completar el diálogo. Se abrirá el editor POM. Si hay referencias a otros proyectos que se han perdido, es posible que vea errores de compilación.
  4. Limpie los errores de compilación. Convierta los proyectos que desee que hagan referencia a Maven y, a continuación, añada dependencias Maven a estos proyectos. Consulte Adición de dependencias en otros módulos.
  5. Actualice el proyecto. Tras cambiar el proyecto, pulse el botón derecho del ratón en el proyecto y seleccione Maven > Actualizar proyecto.

Conversión de proyectos EAR

Acerca de esta tarea

La conversión de proyectos EAR implica varias tareas:
  1. Crear una carpeta de contenido.
  2. Convertir el proyecto EAR.
  3. Añadir módulos a un EAR.
  4. Añadir dependencias a otros módulos.
  5. Añadir bibliotecas al directorio de bibliotecas EAR.
Lleve a cabo los pasos siguientes para completar estas tareas.

Creación de una carpeta de contenido

Acerca de esta tarea

Cuando se crea un proyecto EAR en Herramientas del desarrollador de WebSphere® Application Server utilizando las preferencias del espacio de trabajo predeterminadas, el directorio de contenido del archivo EAR estará vacío, lo que significa que se incluye todo lo de la carpeta raíz del proyecto en el archivo EAR. Si el proyecto no tiene ninguna carpeta de contenido, debe crear un directorio de contenido.

Procedimiento

  1. Compruebe si el EAR tiene una carpeta de contenido.
    1. Pulse el botón derecho del ratón en el proyecto y seleccione Propiedades > Conjunto de despliegue.
    2. Si ve una carpeta de contenido que se correlaciona con / (raíz) como en la imagen siguiente, el archivo EAR tiene una carpeta de contenido distinto de la raíz del proyecto.
      Carpeta de contenido no raíz
    3. Si ve que la raíz del proyecto se correlaciona con la raíz como en la imagen siguiente, el proyecto no tiene ningún directorio de contenido:
      Carpeta de contenido raíz
  2. Si el proyecto no tiene ninguna carpeta de contenido, pulse Cancelar en la página Conjunto de despliegue y siga estos pasos para crear uno:
    1. Pulse el botón derecho del ratón en el proyecto EAR y seleccione Nuevo > Carpeta. En el Nombre de carpeta, escriba el nombre de la estructura de la carpeta. Para proyectos Maven, la estructura de la carpeta recomendada es src/main/application. Pulse Finalizar.
      Crear estructura de carpeta
    2. Acceda a la página de conjunto de despliegue. Pulse el botón derecho del ratón en el proyecto y seleccione Propiedades > Conjunto de despliegue.
    3. Seleccione la entrada que correlaciona la raíz del proyecto con la raíz del archivo EAR y pulse Eliminar.
    4. Pulse Añadir, seleccione Carpeta y pulse Siguiente.
    5. Seleccione la carpeta que ha creado y pulse Finalizar. Por ejemplo, si ha creado la estructura de carpeta recomendada, seleccione la carpeta aplicación que está bajo src/main.
      Selección de carpeta
    6. Compruebe la estructura. En la sección conjunto de despliegue, ahora tiene la carpeta que ha creado correlacionada con la raíz del proyecto. En la imagen siguiente se muestra el ejemplo si ha creado una carpeta src/main/application.
      La carpeta está correlacionada con la raíz
    7. Pulse Aceptar para completar la correlación del conjunto de despliegue.
    8. Mueva todos los recursos que desea incluir en el archivo EAR desde la raíz del proyecto a la carpeta que ha creado. Por ejemplo, si ha utilizado la estructura de carpeta recomendada, src/main/application, y el archivo EAR tiene un descriptor de despliegue, mueva la carpeta META-INF de la raíz del archivo EAR a la carpeta aplicación.

Conversión del proyecto EAR

Acerca de esta tarea

Cuando convierte un proyecto, tenga en cuenta las dependencias que tiene con otros artefactos y cómo se accede a los artefactos mediante el proyecto. En proyectos no Maven, se especifica esta información en los metadatos del proyecto y los archivos MANIFEST.MF directamente. Sin embargo, en proyectos Maven, las dependencias se especifican en el archivo pom.xml. Tenga en cuenta los módulos que forman parte del archivo EAR, las bibliotecas que se comparten con otros módulos que utilizan el directorio de bibliotecas (para los EAR de la versión 5 o posterior) u otras dependencias.

En primer lugar, utilice la página Conjunto de despliegue para recopilar la información de dependencias:
  1. Pulse el proyecto con el botón derecho del ratón.
  2. Seleccione Propiedades > Conjunto de despliegue.
  3. Tome nota de los módulos que forman parte del archivo EAR.
  4. Tome nota del valor del directorio de bibliotecas EAR si el EAR es de la versión 5 o posterior.
  5. Tome nota de los archivos JAR y de los proyectos del directorio de bibliotecas. Para identificar estos archivos, busque los archivos JAR y los proyectos que tengan una vía de acceso de despliegue que empiece con el valor del directorio de bibliotecas.
Nota: Antes de convertir el proyecto, guarde una copia del archivo del descriptor de despliegue del archivo EAR, META-INF/application.xml, si existe. Es necesario guardar una copia porque durante la conversión del descriptor de despliegue existente se sustituye por un descriptor de despliegue vacío.

Procedimiento

  1. Pulse el botón derecho del ratón en el proyecto y seleccione Configure > Convertir a proyecto Maven.
  2. Complete el diálogo POM de Maven. Escriba un ID de grupo, ID de artefacto y Versión o acepte los valores predeterminados. De forma opcional, escriba un Nombre y una Descripción. Para Empaquetado, escriba ear.
  3. Pulse Finalizar. Se abrirá el editor POM.
    Nota: Si el archivo EAR tenía un descriptor de despliegue, a continuación, se genera un descriptor de despliegue nuevo, vacío. Si el descriptor de despliegue original contenía elementos tales como roles de seguridad, configure los elementos en el archivo pom.xml. Para obtener más información, consulte: Plugin EAR de Maven
  4. Actualice el proyecto. Tras cambiar el proyecto, pulse el botón derecho del ratón en el proyecto y seleccione Maven > Actualizar proyecto.
  5. Para completar la conversión EAR, debe completar las siguientes tres tareas:
    1. Adición de módulos a un proyecto EAR
    2. Adición de dependencias en otros módulos
    3. Adición de bibliotecas al directorio de bibliotecas EAR
Icono que indica el tipo de tema Tema de tarea
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: convert.html