Contents |
En general una aplicación arena consta de dos componentes o partes:
Si bien podemos tener todas las clases de ambas partes en un único proyecto, lo más prolijo es plasmar esa separación en dos proyectos. Porque por ejemplo, para el TP podrán reutilizar el dominio entre las diferentes tecnologías.
Entonces en ese esquema si seguimos con la idea de que el dominio no debe estar acoplado a la tecnología de la vista directamente, nuestro proyecto “dominio” no dependerá del artefacto arena, pero sí de otro artefacto más abstracto que establece contratos de los objetos de negocio: uqbar-domain.
Por otro lado, nuestro proyecto que tendrá la vista en arena sí, lógicamente dependerá del artefacto “arena”.
La siguiente figura resume esto:
Nota: si hacemos un único proyecto con dominio + ui arena, podemos sólo depender de “arena” y transitivamente veríamos a “uqbar-domain”.
Si vas a definir tus objetos de dominio en un proyecto aparte (cosa que recomendamos) tenés que definir esta dependencia
Home
Artículos
<dependency>
<groupId>org.uqbar-project</groupId>
<artifactId>uqbar-domain</artifactId>
<version>3.6.3</version>
</dependency>
Si estás trabajando Arena-UI desde xtend, esta configuración contiene todas las dependencias que necesitás (JUnit, el compilador Xtend, Arena UI, Uqbar Domain, etc.):
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<artifactId>****ACA PONES EL NOMBRE DE TU PROYECTO****</artifactId>
<version>1.0-SNAPSHOT</version>
<name>****UNA VEZ MAS EL NOMBRE DE TU PROYECTO****</name>
<description>****DESCRIPCION DE TU PROYECTO****</description>
<parent>
<groupId>org.uqbar-project</groupId>
<artifactId>arena-xtend-parent</artifactId>
<version>3.6.3</version>
</parent>
<!-- Si tenés dependencias con tu proyecto de dominio -->
<dependencies>
<dependency>
<groupId>GRUPO-PROYECTO-DE-DOMINIO</groupId>
<artifactId>NOMBRE-PROYECTO-DE-DOMINIO</artifactId>
<version>VERSION-ACTUAL-PROYECTO-DE-DOMINIO</version>
</dependency>
</dependencies>
<!-- fin de dependencias con proyecto de dominio -->
<repositories>
<repository>
<id>uqbar-wiki.org-releases</id>
<name>uqbar-wiki.org-releases</name>
<url>http://maven.uqbar.org/releases</url>
</repository>
<repository>
<snapshots />
<id>uqbar-wiki.org-snapshots</id>
<name>uqbar-wiki.org-snapshots</name>
<url>http://maven.uqbar.org/snapshots</url>
</repository>
</repositories>
<build>
<plugins>
<plugin>
<groupId>org.eclipse.xtend</groupId>
<artifactId>xtend-maven-plugin</artifactId>
<version>2.19.0.M1</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.5.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
Agregar dos referencias en el pom
Por ejemplo, las dependencias en nuestro pom podrían quedar así:
<dependencies>
<dependency>
<groupId>org.uqbar-project</groupId>
<artifactId>arena-jface</artifactId>
<version>3.6.3</version>
</dependency>
<dependency>
<groupId>uqbar-project.org</groupId>
<artifactId>videoclub-domain</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
</dependencies>
Las otras dependencias como JUnit se toman de la definición del parent project, en caso de ser necesario se debe agregar a mano:
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
Si no querés tocar el pom.xml a mano, podés agregarlo a través del plugin M2clipse: botón derecho sobre el proyecto, Maven > Add Dependency > buscás “arena” y tiene que aparecer “arena-jface”, buscás la versión que querés (o si tenés dudas la última) y aceptás. Entonces el plugin va a descargarlo (si no lo tiene en tu repositorio local). Lo mismo con las demás dependencias que necesites.
En Run > Run Configurations… > Java Application > New launch configuration (buscá el botón de la toolbar que está a la izquierda) y en la solapa Arguments, tenés que indicarle en VM Arguments que use el Launcher propio de Arena:
-Djava.system.class.loader=org.uqbar.apo.APOClassLoader
de lo contrario te va a aparecer un mensaje de error:
Exception in thread "main" java.lang.RuntimeException: Esta aplicación no está corriendo con el ClassLoader necesario. Corra la aplicación con el siguiente parámetro para la VM: -Djava.system.class.loader=org.uqbar.apo.APOClassLoader. El ClassLoader actual es: sun.misc.Launcher$AppClassLoader@6fd3633c
at org.uqbar.arena.Application.validateClassLoader(Application.java:32)
at org.uqbar.arena.Application.`<init>`(Application.java:24)
En muchos ejemplos tenemos un archivo .launch que tiene esta configuración ya cargada.
¿Qué hacer cuando nos bajamos ejemplos (o desarrollamos uno nuevo) y no nos andan? Chequear esta lista…
Revisá que Maven esté correctamente instalado en tu máquina y que tenés el settings.xml correctamente configurado. Cualquier duda fijate en el tutorial de instalación de Maven.
También asegurate que la versión de Maven sea 3.0.x o posterior, o vas a tener un mensaje de error similar a éste:
[INFO] Unable to initialise extensions
Component descriptor role: 'com.jcraft.jsch.UIKeyboardInteractive', implementation: 'org.apache.maven.wagon.providers.ssh.jsch.interactive.PrompterUIKeyboardInteractive', role hint: 'default' has a hint, but there are other implementations that don't
Maven tiene un solo gran inconveniente: si al tratar de descargar una dependencia tenés un problema de conexión, después de una cierta cantidad de reintentos queda el archivo de la dependencia corrupto y tu entorno no va a funcionar. Las palabras que hay que buscar en la solapa Problems es resolution will not be reattempted until the update interval of central has elapsed or updates are forced.
La solución es ir a tu carpeta C:\users\tuUsuario\.m2 (o ~/.m2 de Linux/Mac), verificar la carpeta del componente que te dice que no puede bajar, verificar que no hay un archivo .jar y borrar la carpeta padre. Por ejemplo, nos aparece este mensaje:
CoreException: Could not get the value for parameter compilerId for plugin execution default-testCompile: PluginResolutionException:
Plugin org.apache.maven.plugins:maven-compiler-plugin:3.5.1 or one of its dependencies could not be resolved:
Failure to transfer org.codehaus.plexus:plexus-component-annotations:jar:1.5.5 from https://repo.maven.apache.org/maven2 was cached in the local repository,
resolution will not be reattempted until the update interval of central has elapsed or updates are forced.
Original error: Could not transfer artifact org.codehaus.plexus:plexus-component-annotations:jar:1.5.5 from/to central (https://repo.maven.apache.org/maven2): The operation was cancelled.
pom.xml /2 line 46 Maven Project Build Lifecycle Mapping Problem
Eso está en la carpeta
C:\users\tuUsuario\.m2\
org\
codehaus\
plexus\
plexus-component-annotations
Y adentro seguro que falta un jar, debe haber un archivo con extension .lastUpdated que indica el momento en el que intentó bajarse la dependencia y falló. Lo mismo hay que hacer con cada uno de los componentes que marque el error.
Borrar todos los hijos de .m2 es lo más fácil, pero también les va a llevar infinito tiempo y si la conexión de Internet es mala, les puede volver a pasar el mismo error con distintos componentes.
Moraleja: cuando uno se baja dependencias (con Maven o cualquier otra herramienta), hay que asegurarse de tener buena conexión de Internet.
Los source folders de los proyectos (que tienen maven como estructura central del proyecto) deben ser
src/main/java y src/test/java (para proyectos Xtend o Java)
Si te aparece como source folder sólo el src, o bien si no tenés source folders:
corré el plugin de maven: botón derecho sobre el proyecto > Configure > Maven project (o mvn compile)
si el proyecto tiene la naturaleza Maven (aparece una M sobre el nodo del proyecto en el Project Explorer), probá hacer un Maven > Update project
revisá si efectivamente tenés una estructura de directorio src/main/lenguaje, en base al lenguaje que estás utilizando. Esa estructura debe respetarse.
Revisá que tengas instalada una JDK (no JRE, tiene que ser JDK con las herramientas para desarrollar en Java como el compilador, debug, etc.) y que la versión de ese JDK sea 1.8 ó superior. Si querés usar una JDK 1.7 ó inferior te va a aparecer el siguiente mensaje de error
java.lang.UnsupportedClassVersionError: ---aplicación de Arena--- : Unsupported major.minor version 51.0
porque Arena está compilado con una JDK 1.8
Si te aparece un error similar a éste al correr un “launcher”:
Error: no se ha encontrado o cargado la clase principal org.uqbar.arena.examples.conversor.xtend.ConversorWindow
Revisá
Otro problema que puede aparecer es:
Error occurred during initialization of VM
java.lang.Error: java.lang.ClassNotFoundException: ....APOClassLoader
entonces el problema puede darse porque no te descargó las dependencias de Maven correctamente. Revisá los directorios de tu usuario/.m2/repository porque seguramente te falte bajar dependencias, podés probar haciendo Maven > Update project (forzando el check Update snapshots), es poco probable que eso lo solucione pero al menos te puede ayudar a encontrar el origen de la dependencia errónea.
Otro problema que te puede ocurrir cuando corras un launcher que te descargaste de nuestros ejemplos es que te aparezca un error de este tipo:
Launch configuration references non-existing project celulares-ui-arena-scala
En este caso el problema es que te descargaste el proyecto del repositorio utilizando otro nombre que el que originalmente definimos. Entonces fijate cuál es el nombre del proyecto que está esperando y renombralo a ese, o bien entrá por el menú Run Configuration y apuntá el launcher al proyecto que vos definiste. Otra opción puede ser que no hayas ejecutado el comando mvn compile (Run As > Maven build… Goal compile)