ATLAS MIGRACIÓN AL ENTORNO DE DESARROLLO ATLAS LUNA

(1)

ATLAS

MIGRACIÓN AL ENTORNO DE

DESARROLLO ATLAS LUNA

Versión 1.0

(2)

Migración al Entorno de Desarrollo Atlas Luna

Hoja de Control

Título _{MIGRACIÓN AL ENTORNO DE DESARROLLO ATLAS LUNA}

Documento de

Referencia PREPARACION DEL ENTORNO DE DESARROLLO Responsable _{Arquitectura de Software}

Versión _1.0 Fecha Versión _23/09/2014

Registro de Cambios

Versión Causa del Cambio Responsable del Cambio Fecha del Cambio 1.0 Versión inicial del documento

Área de Integración y Arquitectura de

(3)

Migración al Entorno de Desarrollo Atlas Luna Índice 1. INTRODUCCIÓN ... 4 1.1. AUDIENCIAOBJETIVO ... 4 1.2. CONOCIMIENTOSPREVIOS ... 4 1.3. PRERREQUISITOS ... 4 1.3.1. Prerrequisitos hardware... 4 1.3.2. Prerrequisitos software ... 5

2. NOVEDADES DE ATLAS LUNA ... 6

2.1. ECLIPSE ... 6 2.2. PLUGINS DE ECLIPSE ... 11 2.2.1. CkechStyle ... 12 2.2.2. PMD ... 13 2.2.3. Subclipse ... 14 2.2.4. m2e ... 15 2.2.5. Hibernate Tools ... 16

2.2.1. JBoss Tools RichFaces ... 17

2.2.2. StartExplorer ... 18 2.2.1. Spring IDE ... 19 2.2.2. JD-Eclipse ... 20 3. MIGRACIÓN DE PROYECTOS ... 22 3.1. PRERREQUISITOS ... 22 3.2. PROYECTOS NO VERSIONADOS ... 22 3.3. PROYECTOS VERSIONADOS ... 32 4. PREGUNTAS MÁS FRECUENTES ... 45 5. ENLACES RELACIONADOS ... 46

(4)

1. INTRODUCCIÓN

Este documento sirve de presentación del nuevo entorno de desarrollo Atlas así como de manual para la migración de proyectos del anterior entorno al nuevo.

Para facilitar la identificación de las diferentes versiones del entorno de desarrollo Atlas (Atlas IDE) se ha utilizado el nombre de la versión de eclipse que incluye. Así, la versión más antigua, que utiliza el eclipse Galileo, se ha llamado Atlas Galileo y la actual Atlas Luna.

En el apartado de presentación del nuevo entorno se describen las novedades y actualizaciones incluidas con respecto a Atlas Galileo, tanto en el propio eclipse como en los plugins externos. Mientras que en el apartado de migración de proyectos se detallan los pasos a seguir para migrar proyectos versionados y no versionados desde Atlas Galileo a Atlas Luna

1.1. AUDIENCIA OBJETIVO

Este documento está destinado a personas que deseen desarrollar aplicaciones basadas en el framework Atlas de la Agencia de Informática y Comunicaciones de la Comunidad de Madrid (en adelante ICM) con el entorno de desarrollo Atlas Luna.

1.2. CONOCIMIENTOS PREVIOS

Para un completo entendimiento del documento, el lector deberá tener conocimientos previos sobre las siguientes tecnologías: - Lenguaje Java - JavaServer Faces (JSF) - Spring Framework. - Hibernate - Eclipse - Maven 2

(5)

1.3.2. Prerrequisitos software

Debe tener instalado el entorno de desarrollo Atlas Luna. En el portal para el desarrollo de aplicaciones

existe un fichero ZIP preparado con todo lo necesario para comenzar a desarrollar (incluida la JDK, Maven, Eclipse con todos sus plugins, etc.). En la misma página también hay un manual en el cual se describen los pasos a seguir para la instalación y configuración manual del entorno.

ATENCIÓN

Los proyectos que se quieran migrar desde Atlas Galileo a Atlas Luna deben encontrarse, al menos, en la versión 1.2.7 de Atlas

(6)

2. NOVEDADES DE ATLAS LUNA

A continuación se dan a conocer las novedades incorporadas en el nuevo entorno de desarrollo.

2.1. Eclipse

Se ha actualizado la versión de eclipse de Galileo 3.5 a Luna 4.4 (5 versiones por delante). Esta actualización supone la solución de muchos bugs y una enorme mejora en el rendimiento del programa, así como la incorporación nuevas funcionalidades. Si lo desea puede consultar las mejoras que ha ido incorporando cada versión a través de la página de eclipse. Como en Atlas Galileo, la distribución utilizada es Eclipse IDE for Java EE Developers.

(7)

Dentro de las mejoras incorporadas al actualizar eclipse hay que destacar las incorporadas por la plataforma

Eclipse Web Tools Platform. Se han incluido herramientas muy útiles para el desarrollo web y en especial para JSF, JSF Tools.

El proyecto JSF Tools añade soporte en eclipse para simplificar el desarrollo y la implementación de aplicaciones JavaServer Faces (JSF). Algunas de sus características son las siguientes:

(8)

(9)

(10)

(11)

El resto de actualizaciones del eclipse IDE se encuentran en los plugins externos. 2.2. Plugins de Eclipse

Como ya se ha adelantado se han actualizado los plugins de eclipse de Atlas Galileo y se han añadido nuevos. A continuación se detallan los plugins de Atlas Luna, indicando el porqué de su instalación y si se tratan de una actualización o son nuevos.

En el manual de preparación del entorno de desarrollo se encuentra toda la información necesaria para la instalación y configuración de cada uno de los plugins.

(12)

Atlas Galileo Atlas Luna

2.2.1. CkechStyle

Checkstyle es una herramienta que valida el estilo del código. Podemos instalar en Eclipse el plugin de

(13)

Se trata de una actualización de la versión 5.3.0, en Atlas Galileo, a la 5.7.0, en Atlas Luna.

2.2.2. PMD

PMD es una herramienta que valida el estilo del código. Podemos instalar en Eclipse el plugin de PMD para que tengamos conocimiento de los errores de estilo según vamos implementando nuestro código.

(14)

2.2.3. Subclipse

Para que desde Eclipse se pueda acceder a proyectos que se encuentran en un repositorio de subversion es necesario instalar un plugin para Subversion llamado Subclipse.

(15)

Cliente SVN

Subclipse 1.10.x incluye un cliente SVN con la versión 1.8.x así que requiere una working copy con, al menos, esta versión. Por esta razón, se recomienda crear un nuevo workspace para Atlas Luna. Más detalles en el Manual de Preparación del Entorno de Desarrollo.

2.2.4. m2e

El objetivo del proyecto m2e es proporcionar soporte para Apache Maven en Eclipse IDE, facilitando editar pom.xml de Maven, ejecutar una compilación desde el IDE y mucho más.

(16)

2.2.5. Hibernate Tools

Hibernate Tools es un conjunto de herramientas para Hibernate implementado como una suite de plugins

integrados en Eclipse. Dentro de la multitud de funcionalidades de las que dispone la más potente y utilizada en el Atlas IDE es la herramienta de generación inversa.

(17)

2.2.1. JBoss Tools RichFaces

Este plugin (en realidad, compendio de varios) extiende las herramientas de desarrollo web incluidas en la suite de Eclipse Java EE. Sobre todo a la hora desarrollar con JSF y más concretamente con componentes de Richfaces. Entre otras cosas, nos proporciona: wizards de creación de diferentes elementos de JSF, validación, navegación entre páginas, edición visual (con previsualización de la página final) y ayuda contextual para los proyectos JSF y para librerías de componentes.

Como se ha dicho, el plugin JBoss Tool RichFaces es en realidad un conjunto de éstos: JBoss Tools Common

JBoss Tools Common Core JBoss Tools Common Text JBoss Tools Common UI

JBoss Tools Java Standard Tools JBoss Tools JSF

JBoss Tools Verification JBoss Tools Visual Page Editor

(18)

Se trata de una plugin incorporado en Elipse Luna, la versión es 3.5.1.

2.2.2. StartExplorer

StartExplorer ofrece una estrecha integración entre el administrador de archivos del sistema (explorador de archivos para Windows) y el shell (cmd.exe para Windows) y Eclipse.

(19)

2.2.1. Spring IDE

Spring IDE es un conjunto de plugins que dan soporte del framework Spring dentro de Eclipse. Las características que aporta son las siguientes:

Constructores incrementales de ficheros de configuración Iconos identificativos de los ficheros de Spring

Vista especial donde se pueden consultar todos los bean y artefactos especiales de Spring que contiene cada proyecto

(20)

2.2.2. JD-Eclipse

JD-Eclipse es un plugin para la plataforma Eclipse que permite visualizar todas las fuentes Java durante el proceso de depuración, incluso si no dispones de ellas.

(21)

(22)

3. MIGRACIÓN DE PROYECTOS

En este apartado se explican los pasos a seguir para migrar un proyecto creado con Atlas Galileo a Atlas Luna. Aunque el proceso es muy similar, se ha incluido una explicación para los proectos versionados que se

encuentren en SVN y otra para los que no.

3.1. Prerrequisitos

Como se ha indicado en el apartado 5 Prerrequisitos software es necesario tener instalado el nuevo entorno, Atlas Luna, a este prerrequisito se le suma el de que el proyecto a migrar debe encontrarse (al menos) en la versión 1.2.7 de Atlas. De lo contrario aparecerán mensajes de error en eclipse y no se aprovecharán todas las mejoras del nuevo entorno.

ATENCIÓN

Los proyectos que se quieran migrar desde Atlas Galileo a Atlas Luna deben encontrarse, al menos, en la versión 1.2.7 de Atlas

3.2. Proyectos no versionados

Se parte de un proyecto eclipse creado en Atlas Galileo con una versión de Atlas ≥ 1.2.7. Como ejemplo para este manual se ha utilizado un proyecto de eclipse creado a partir del atrtefacto atlasfrm-arquetipos-generador-proyecto de Atlas de la versión 1.2.7 llamado a127.y que dispone de un submódulo generado a través de

(23)

Estructura del proyecto en Atlas Galileo

A continuación se detallan los pasos a seguir.

Paso 1: Abrir Atlas Luna

(24)

(25)

Paso 4: Indicar la ruta de la raíz del proyecto que se quiere importar. Para ello, en la opción “Select root directory” se ha de pulsar “Browse…” y escoger el directorio “C:\Workspace\a127”.

(26)

(27)

Paso 6: Actualizar la versión de la configuración del plugin m2e. Cuando aparezca una ventana preguntando si se quiere convertir el código heredado del proyecto Maven (“Should convert legacy Maven projects?”) se ha de elegir la opción Yes.

(28)

NOTA

Una vez realizado este paso, ya se dispone del proyecto migrado en el workspace de Atlas Luna.

Los siguientes pasos sirven configurar el entorno de manera que se aprovechen las nuevas herramientas y para realizar una comprobación rápida del buen funcionamiento del proyecto migrado

(29)

(30)

Paso 9: Seleccionar proyectos a importar. En el caso del presente ejemplo se trata del módulo appw y sus submódulos web y test. Tras esto se pulsa Finish.

(31)

Paso 10: Aceptar la actualización de la configuración de m2e. Para evitar que la ventana de confirmación aparezca de nuevo se puede seleccional la opción “Don’t show this dialog again”

(32)

3.3. Proyectos versionados

Se parte de un proyecto eclipse que ha sido creado en Atlas Galileo y que tiene tiene las siguientes

características: está versionado con SVN y su versión de Atlas es ≥ 1.2.7. Como ejemplo para este manual se ha utilizado el proyecto de SVN de la aplicación de componentes web llamado atlas-componentes.

(33)

(34)

Estructura del proyecto en Atlas Galileo

A continuación se detallan los pasos a seguir.

Paso 1: Abrir Atlas Luna

(35)

(36)

Paso 4: Indicar la ruta de la raíz del proyecto que se quiere importar. Para ello, en la opción “Select root directory” se ha de pulsar “Browse…” y escoger el directorio. Para el presente ejemplo

(37)

(38)

Paso 6: Actualizar la versión de la configuración del plugin m2e. Cuando aparezca una ventana preguntando si se quiere convertir el código heredado del proyecto Maven (“Should convert legacy Maven projects?”) se ha de elegir la opción Yes.

(39)

Paso 6: Actualizar la versión de la copia de trabajo.Cuando aparezca una ventana para confirmar si se quiere actualizar la versión de la working copy del proyecto se aceptará dicha modificación. Esta actualización es necesaria ya que el cliente SVN integrado an Atlas Galileo era de la versión 1.6 y la utilizada en Atlas Luna la 1.8.

(40)

NOTA

Una vez realizado este paso, ya se dispone del proyecto migrado en el workspace de Atlas Luna.

Los siguientes pasos sirven configurar el entorno de manera que se aprovechen las nuevas herramientas y para realizar una comprobación rápida del buen funcionamiento del proyecto migrado

Paso 7:Importar los proyectos Maven incluidos dentro del proyecto eclipse importado. Para ello, se pincha el botón derecho sobre la carpeta del proyecto atlas_componentes y se elige la opción “Import…”

(41)

(42)

Paso 9: Seleccionar proyectos a importar. En el caso del presente ejemplo se trata de los módulos web y test. Tras esto se pulsa Finish.

(43)

Paso 10: Aceptar la actualización de la configuración de m2e. Para evitar que la ventana de confirmación aparezca de nuevo se puede seleccional la opción “Don’t show this dialog again”

Paso 11: Para confirmar que todo funciona correctamente se recomienda compilar el proyecto y lanzar la aplicación web (clean install sobre atlas_componentes y tomcat7:run sobre atlas_componentes_web)

(44)

(45)

4. PREGUNTAS MÁS FRECUENTES

(46)

5. ENLACES RELACIONADOS

Producto URL

Apache Maven http://maven.apache.org/

Eclipse IDE https://www.eclipse.org

The Java EE 7 Tutorial http://docs.oracle.com/javaee/7/tutorial/doc/home.htm

Hibernate http://www.hibernate.org/ JavaServer Faces Technology http://docs.oracle.com/javaee/7/tutorial/doc/jsf-intro.htm#BNAPH RichFaces http://www.jboss.org/jbossrichfaces/ Spring http://www.springframework.org/ Portal de Arquitectura de ICM http://www.madrid.org/arquitecturasw/

Eclipse Web Tools Platform. http://www.eclipse.org/webtools/ JavaServer Faces(JSF) Tools Project http://www.eclipse.org/webtools/jsf Checkstyle http://checkstyle.sourceforge.net/ PMD http://pmd.sourceforge.net/ Subclipse http://subclipse.tigris.org/ m2e http://www.eclipse.org/m2e/