De tecnólogos y todólogos: Spring ROO

Hoy toca probar la última release de Spring-ROO (1.1.5.RELEASE), como ya comenté en un post anterior, sigo sin entender (del todo) el motivo por el que Springsource se ha embarcado en el crear un proyecto de desarrollo rápido tras la compra de la empresa que desarrollaba Grails.

Como no puede ser de otra forma vamos a dar los primeros pasos con Spring-ROO a través de un Mini HOWTO con el ejemplo tipo de la agenda. Para ello debemos seguir unos sencillos pasos que intento explicar a continuación.

Preparar el entorno de trabajo

Lo primero que debemos hacer es descargarnos la última versión de Spring-ROO de la página de Spring y seguir los siguientes pasos para su instalación:

Se descomprime el archivo descargado en una ruta que podamos recordar.

(en mi caso USER_HOME/java/spring-roo-1.1.5.RELEASE)
Establecemos la variable de entorno ROO_HOME apuntando a la ruta anterior.
Añadimos ROO_HOME/bin al path de nuestro sistema para que reconozca los comandos de spring-roo.
En caso de que tengáis un sistema Linux o un MAC os recomiendo que creéis un enlace simbólico a roo.sh

ln -s ${ROO_HOME}/bin/roo.sh /usr/bin/roo

Ahora comprobamos que tenemos el sistema preparado para poder empezar a trabajar. Las necesidades mínimas son:

Una instalación de JDK5 o JDK6 de Sun, JRocket o IBM y la variable de entrono $JAVA_HOME establecida.
Apache Maven 2.0.9 o superior instalado y con el PATH configurado correctamente.

Con esto ya podemos probar que tenemos instalado y listo para usar spring-roo, para ello en un terminal ejecutamos lo siguiente:

roo quit

Si obtenemos una salida parecida a la que muestro a continuación es que todo ha ido bien y podemos empezar con el howto.

Creación del proyecto

Como podéis ver en el propio shell de roo ya hay una ayuda, esto veremos que es muy útil durante la creación de la aplicación, pero ahora vamos a empezar con el ejemplo.

En un terminal, navegamos hasta donde tengamos nuestros proyectos, en mi caso ${USER_HOME}/proyectos/blog/roo-howto-series y ejecutamos lo siguiente:

~/proyectos/blog/roo-howto-series/$ mkdir agenda

~/proyectos/blog/roo-howto-series/$ cd agenda

~/proyectos/blog/roo-howto-series/$ roo

Ahora tendríamos que estar viendo el shell de roo en la carpeta de la agenda, por lo que ya podemos empezar a usar la ayuda del shell.

Para crear un proyecto nuevo roo tiene un comando que nos facilita la vida se trata del comando project, para crear el proyecto tecleamos en el shell lo siguiente:

project -topLevelPackage org.agenda

Esto producirá la siguiente salida en el shell:

roo> project -topLevelPackage org.agenda

Created ${USER_HOME}/proyectos/roo-howto-series/agenda/pom.xml

Created SRC_MAIN_JAVA

Created SRC_MAIN_RESOURCES

Created SRC_TEST_JAVA

Created SRC_TEST_RESOURCES

Created SRC_MAIN_WEBAPP

Created SRC_MAIN_RESOURCES/META-INF/spring

Created SRC_MAIN_RESOURCES/META-INF/spring/applicationContext.xml

Esto nos ha creado la estructura necesaria para poder empezar a trabajar con un proyecto maven y con la configuración spring necesaria para usar roo.

Adición de un contenedor JPA para persistencia

Para añadir la capa de persistencia roo ofrece un nuevo comando que facilita la creación de los archivos necesarios para la persistencia y que incluye las dependencias necesarias en el pom de maven.

Este comando es “persistence setup” y para nuestro proyecto deberemos ejecutar lo siguiente dentro del shell de roo:

roo>persistence setup --provider OPENJPA --database HYPERSONIC_PERSISTENT

Esto producirá la siguiente salida en el shell:

roo>persistence setup --provider OPENJPA --database HYPERSONIC_PERSISTENT

Created SRC_MAIN_RESOURCES/META-INF/persistence.xml

Created SRC_MAIN_RESOURCES/META-INF/spring/database.properties

Managed SRC_MAIN_RESOURCES/META-INF/spring/applicationContext.xml

Managed ROOT/pom.xml

Para ver la configuración creada teclearemos lo “database properties list” dentro de la shell obteniendo la salida siguiente:

roo>database properties list

database.driverClassName = org.hsqldb.jdbcDriver

database.password =

database.url = jdbc:hsqldb:file:contacts;shutdown=true

database.username = sa

Para cambiar la configuración de alguna de las propiedades roo facilita un comando, nosotros vamos a cambiar la ubicación de la url de la base de datos, ejecutamos el siguiente comando:

roo>database properties set --key database.url --value jdbc:hsqldb:${user.home}/agenda

Updated SRC_MAIN_RESOURCES/META-INF/spring/database.properties

Esto ha actualizado el archivo de propiedades de la base de datos ejecutamos de nuevo “database properties list” y vemos que los cambios se han efectuado correctamente:

roo> database properties list

database.driverClassName = org.hsqldb.jdbcDriver

database.password =

database.url = jdbc:hsqldb:${user.home}/agenda

database.username = sa

Creación de entidades

Para crear entidades en roo existe otro comando, este comando es “entity --class”.

Procedemos con la creación de la entidad Contacto.java que será la que almacenará los datos en nuestra aplicación.

Para ello ejecutamos el comando, obteniendo la siguiente salida en el shell:

roo> entity --name org.agenda.Contacto --identifierField id

Created SRC_MAIN_JAVA/org/agenda/Contacto.java

Created SRC_MAIN_JAVA/org/agenda/Contacto_Roo_Entity.aj

Created SRC_MAIN_JAVA/org/agenda/Contacto_Roo_ToString.aj

Created SRC_MAIN_JAVA/org/agenda/Contacto_Roo_Configurable.aj

Esto ha creado la entidad Contacto, ahora debemos añadir atributos a esta entidad, para esto ejecutamos los siguientes comandos:

field string nombre --notNull --sizeMin 1 --sizeMax 30

field string apellidos --sizeMax 100

field string nick --sizeMax 100

field string direccion --sizeMax 255

field number numero --type java.lang.Integer

field number piso --type java.lang.Integer

field string puerta --sizeMax 1

field string codigoPostal --sizeMax 5

field string poblacion --sizeMax 30

field string provincia --sizeMax 30

field string email --notNull --sizeMin 8 --sizeMax 100

field string telefono --sizeMax 9

field string movil --sizeMax 9

La traza completa de la ejecución de los comandos anteriores es la siguiente:

field string nombre --notNull --sizeMin 1 --sizeMax 30