Cómo generar un proyecto Xtend nuevo

Para realizar las prácticas, vas a crear un proyecto desde cero. Como ahora hay muchas más opciones, te dejamos una guía simple de cómo iniciarte.

Crear proyecto Maven

Todos los ejemplos que vas a descargar de la materia, así como los proyectos en los que vas a trabajar, se basan en la tecnología Maven. Para crear un proyecto Maven, te dejamos esta animación:

• Seleccionamos New > Project… Maven Project
• Chequeamos “Skip archetype selection” ya que no lo usaremos, y luego Next
• En la siguiente pantalla, escribimos cualquier cosa en “groupId”, que es un valor que luego borraremos, pero que si lo dejamos vacío Eclipse nos mostrará un error. Y el nombre de nuestro proyecto o artifactId, éste sí es importante, seguimos la nomenclatura de paquetes de Java, para que no haya confusiones en los nombres: ar.edu.unsam.prueba identifica nuestro proyecto en todo el mundo
• cuando finalizamos, se genera un proyecto con un archivo pom.xml, que es fundamental para que Eclipse regenere el proyecto en otra máquina y descargue las dependencias

Configuración de un proyecto Maven

El acrónimo POM es por “Project Object Model”. El archivo pom.xml es el core de la configuración de un proyecto maven. Es un solo archivo de configuración que contiene la mayoría de la información requerida para el build de un proyecto.

Pom, pom, pom, pom…

Para comenzar a escribir la configuración del proyecto en un archivo pom.xml existen algunas opciones:

• Inicializar un proyecto maven desde 0 desde la terminal con el comando mvn archetype:generate. Al hacer esto maven nos pedirá los datos iniciales para inicializar el proyecto (artifactId, groupId, etc) y nos dejará un pom.xml creado y listo para usar/modificar.
• Crear un proyecto maven desde eclipse u algún otro IDE.
• Copiarse un pom.xml de un proyecto maven existente y adecuar los valores de los campos que identifican el proyecto.

Te dejamos entonces el modelo de proyecto Maven por defecto para la cursada de Algoritmos 2 (UNSAM) del aǹo 2021: pom.xml de ejemplo. Luego tendrás que

• renombrar el archivo a pom.xml
• copiarlo dentro del directorio raíz de tu proyecto ya creado
• actualizar en base a los nombres de tu proyecto (el artifactId y groupId)
• revisar las dependencias

Para profundizar un poco más sobre lo que contiene un archivo de Maven, te recomendamos este artículo.

Sincronización entre Eclipse y Maven

Cada vez que hagamos un cambio en el archivo pom.xml, nos aparecerá un mensaje de error en la solapa Problems, que se soluciona forzando la sincronización entre Eclipse y Maven (dado que cada uno maneja su propia estructura de proyectos Java). Como regla general, siempre que necesitemos agregar alguna biblioteca, o dependencia, debemos hacerlo en el archivo pom y no desde las opciones que ofrece el Eclipse, porque nuestros compañeros o los docentes no tendrán esa biblioteca. Para sincronizar Maven y Eclipse, nos paramos en el proyecto y con un botón derecho elegimos “Maven > Update Project”.

Primeros pasos

Ahora solo nos queda eliminar la línea groupId (con Ctrl + D), formatear el pom.xml (con Ctrl + Shift + F) y crear nuestra primera clase Perro. Es importante notar que tendremos dos carpetas donde ubicaremos los fuentes:

• src/main/java: donde irán las clases
• src/test/java: donde irán los tests

Por eso, nos ubicamos en src/main/java y con un botón derecho, New > Xtend Class (es importante que hayas configurado el Eclipse para que no esté escondida esta opción).

Generación de archivos .java

En src/main/generated-sources vas a tener los archivos .java que se generan en base a los archivos de xtend. ¡No los toques! Porque cada cambio que hagas en tu clase xtend va a pisar los cambios de los archivos .java. En general no deberías mirar nunca el java que genera, porque además utiliza construcciones menos simples que si programaras directamente en java.

Recomendaciones

A continuación te dejamos algunas recomendaciones para que tu estadía en Eclipse + Xtend sea más feliz:

• ¡Formatear el código! Nunca nos olvidemos de que nuestro código tiene que ser entendible para el resto de la humanidad. Además, el Eclipse lo hace solo (Ctrl + Shift + F).

• Utilización de packages (paquetes). Es una buena práctica agrupar las clases afines en paquetes para organizar semánticamente el código. No hay una guía firme a seguir con respecto a cómo organizar nuestro código, ya que suele depender del contexto en el cual estamos trabajando, pero a medida que veas nuestros ejemplos y vayas haciendo las prácticas notarás que hay clases que se pueden agrupar en contextos similares. Te dejamos un ejemplo

      proyecto
   ├── home
   ├── registration
   │   ├── Profile.xtend
   │   └── User.xtend
   └── settings
       ├── CustomPrivacy.xtend
       ├── DefaultPrivacy.xtend
       ├── Privacy.xtend
       └── Setting.xtend

    

De esta manera, logramos mayor granularidad en la organización de nuestras clases. __

• Siguiente paso: Sobre el control de versiones
• Volver al menú principal del entorno Xtend