Diferencia entre revisiones de «Spring Roo»

De Dos Ideas.
Saltar a: navegación, buscar
(Problemas y soluciones)
(Ver también)
 
(No se muestran 58 ediciones intermedias de 5 usuarios)
Línea 1: Línea 1:
== Descripción ==
+
[[Spring Roo]] es una herramienta RAD extensible para [[Java]] basada en [[Spring Framework]]. Basicamente es un generador de código avanzado, que se utiliza desde la linea de comandos invocando sentencias.
Spring Roo es una herramienta RAD extensible.  
 
Basicamente un generador de código avanzado, que se utiliza desde la linea de comandos invocando sentencias.
 
La idea detrás de Roo es incrementar la productividad del desarrollador Java sin comprometer la integridad estructural o la flexibilidad de la solución.
 
No contiene un componente Runtime. Esto es muy importante, no solo pq no ata la solución al framework, sino porque no genera overhead.
 
Se puede eliminar facilmente.
 
  
Está construido con una serie de plugins (al estilo de Maven)
+
La idea detrás de [[Spring Roo]] es incrementar la productividad del desarrollador [[Java]] sin comprometer la integridad estructural o la flexibilidad de la solución. No contiene un componente Runtime. Esto es muy importante, no solo porque no ata la solución al framework, sino porque no genera overhead. Se puede eliminar facilmente.
Fue diseñado pensando en la usabilidad. Los comandos son contextuales; tiene los comandos "hint" y "help" para consultar el uso rápidamente y la tecla TAB para autocompletar.  
+
 
Está basado en scripts, por lo que en caso que se cometer un error, se puede hacer rollback.
+
Está construido con una serie de plugins (al estilo de [[Maven]]). Fue diseñado pensando en la usabilidad. Los comandos son contextuales; tiene los comandos "hint" y "help" para consultar el uso rápidamente y la tecla TAB para autocompletar.  
Todos los comandos escritos se van guardando automáticamente (log.roo)
+
 
 +
Está basado en scripts, por lo que en caso que se cometer un error, se puede hacer rollback. Todos los comandos escritos se van guardando automáticamente (log.roo).
  
 
== Características ==
 
== Características ==
* Permite desarrollar una aplicación Web en minutos.
+
* Permite desarrollar una aplicación Web en minutos. Genera un war. Construye dos capas: la de persistencia y la de presentación. Para agregar la capa de negocio, se pueden agregar las clases manualmente a los controladores generados con Roo.
 
* Permite generar un modelo de datos complejo, incluyendo validaciones.
 
* Permite generar un modelo de datos complejo, incluyendo validaciones.
 
* La aplicación Web es RESTful y tiene soporte para internacionalización en varios idiomas.
 
* La aplicación Web es RESTful y tiene soporte para internacionalización en varios idiomas.
 
* Tiene soporte de seguridad out-of-the-box.
 
* Tiene soporte de seguridad out-of-the-box.
 +
* La presentación usa [[Dojo]] (incorporar otro, por ejemplo [[JQuery]], se hace a mano y es costoso).
  
 
=== Generación de código ===
 
=== Generación de código ===
 
Es un generador de código ''hibrido'', utilizando generación activa y pasiva.
 
Es un generador de código ''hibrido'', utilizando generación activa y pasiva.
  
Utiliza generación pasiva para generación de archivos java y xml.
+
Utiliza generación pasiva para generación de archivos java y xml.  
Utiliza generación activa para la metadata con la ayuda de los tags @Roo* e modifica gradualmente .aj y los jsp.
+
Utiliza generación activa para la metadata con la ayuda de los tags @Roo* y modifica gradualmente .aj y los jsp.
  
Sincroniza los cambios entre Roo y las modificaciones realizadas al código (roundtrip)
+
Sincroniza los cambios entre Roo y las modificaciones realizadas al código (roundtrip).
 +
 
 +
[[Spring Roo]] no interviene en runtime, solo lo hace en tiempo de desarrollo. Una vez creado el proyecto con Spring Roo, podría eliminarse y seguir trabajando con un [[IDE]].
  
 
=== Librerías/Frameworks que usa ===
 
=== Librerías/Frameworks que usa ===
  
* Java
+
* [[Java]]
* Spring Framework
+
* [[AspectJ]]
* Java Persistence API (Hibernate)
+
* [[Eclipse]]
* Java Server PAges
+
* Java Persistence API:  [[Hibernate]], [[OpenJPA]], [[EclipseLink]]
* Spring Security
+
* [[Java Server Pages]]
* Spring Web Flow
+
* [[JUnit]]
* Log4j
+
* [[Log4J]]
* Maven
+
* [[Maven]]
* AspectJ
+
* [[Selenium]]
* Eclipse
+
* [[Spring Framework]]
* JUnit
+
* [[Spring MVC]]
* Selenium
+
* [[Spring Security]]
 +
* [[Spring Web Flow]]
  
 
== Requisitos ==
 
== Requisitos ==
Línea 50: Línea 50:
  
 
== Uso ==
 
== Uso ==
Para empezar a Roo, crear una carpeta e invocar a Roo
+
Para la ejecución de comandos podemos utilizar:
 +
* el shell de roo mediante linea de comando
 +
* el shell que viene embebido en el [[SpringSource Tool Suite]]
 +
* o el [[IDE]] que utilizás habitualmente, por ejemplo [[Eclipse]]. En este caso deberías instalar el plugin para trabajar con aspectos y maven.
 +
 
 +
Para empezar a usar los comandos Roo mediante el shell, crear una carpeta e invocar a [[Spring Roo]]
 
Ej.:
 
Ej.:
  
Línea 77: Línea 82:
 
La sentencia help lista todos los comandos con descripciones breves.
 
La sentencia help lista todos los comandos con descripciones breves.
  
== Ejecutar un script ==
+
== Pasos para crear una aplicación mínima ==
  
Todo lo que se va ejecutando por consola, se va grabando en un archivo de log (log.roo).
+
*Crear el proyecto
Es posible re-ejecutar las acciones, copiando el archivo con otro nombre y utilizando la sentencia 'script <nombre de archivo>'
+
*Elegir el framework de persistencia
Ej.:
+
*Crear el modelo de dominio
 +
*Generar de la capa de presentación
  
  roo>script helloworld.roo
 
  
== Pasos para crear una aplicación mínima ==
+
En detalle podés verlo en [[Roo: Pasos para crear una aplicación mínima]].
  
=== Crear un proyecto ===
+
== Manejo de propiedades ==
  
  project --topLevelPackage  com.dosideas.helloroo
+
Roo genera archivos de propiedades dentro del proyecto, por ejemplo: database.properties.  
 
+
Dichos archivos pueden ser modificados automáticamente por los comandos de roo. Se debe tener en cuenta entonces que al ejecutar un comando que impacte valores  configurados manualmente, será necesario volver a configurarlos.
=== Elegir el framework de persistencia ===
+
Las claves definidas manualmente por el usuario no son alteradas por ningún comando de roo.
  
Se puede elegir entre 3 frameworks y 8 bases de datos
+
== Maven ==
  
Frameworks:
+
Desde Roo se pueden ejecutar varias tareas de Maven sin tener que salir del entorno.
* ECLIPSELINK
+
Por ejemplo:
* HIBERNATE
+
* 'perform tests' equivale a 'mvn test'
* OPENJPA
+
* 'perform eclipse' equivale a 'mvn eclipse:eclipse'
  
Bases de datos:
+
== Seguridad ==
* DB2
 
* H2_IN_MEMORY
 
* HYPERSONIC_IN_MEMORY
 
* HYPERSONIC_PERSISTENT
 
* MSSQL
 
* MYSQL
 
* ORACLE
 
* POSTGRES
 
* SYBASE
 
  
Ej.:
+
El módulo de seguridad que viene predeterminado necesita unos pequeños cambios de configuración. De forma predeterminada viene configurado un path segurizado que no corresponde con la aplicación en desarrollo.
 +
Se invoca mediante la sentencia:
  
   persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY
+
   security setup
  
=== Creación del modelo de datos ===
+
== Ejecutar un script ==
  
Junto con la creación de la clase se puede elegir de crear los tests de componentes correspondientes.
+
Todo lo que se va ejecutando por consola, se va grabando en un archivo de log (log.roo).
 +
Es posible re-ejecutar las acciones, copiando el archivo con otro nombre y utilizando la sentencia 'script <nombre de archivo>'
 +
Ej.:
  
   entity --class ~.domain.Client --testAutomatically
+
   roo>script helloworld.roo
  
Por cada campo a agregar a la clase es necesario definir el tipo, el nombre y las restricciones que pueda tener.
+
== Ejemplos ==
  
  field string --fieldName name --notNull --sizeMax 24 --sizeMin 3
+
Necesitamos tener correctamente instaladas las siguientes versiones (verificar la configuración de las variables de entorno PATH y JAVA_HOME):
  field string --fieldName surname --notNull --sizeMin 3 --sizeMax 24
 
  field date --fieldName birthDate --type java.util.Date --notNull
 
  field boolean --fieldName active
 
  field number --fieldName numberOfKids --type java.lang.Integer --notNull  --max 99
 
  
==== Expresiones regulares ====
+
* JDK 1.6 UPDATE 21
 +
* Spring Roo 1.0.2
 +
* Apache Maven 2.2.1
  
Existe un bug reportado que impide el uso de expresiones regulares, si bien teoricamente son soportadas por Roo.
 
  
=== Interfaz gráfica ===
+
Para poder ejecutar los siguientes ejemplos:
  
Roo permite la creación de la interfaz gráfica web, que comprende de una alta, baja, modificación y listado.
+
* [[Ejemplo de script con Spring Roo]]
Se puede especificar de que objeto de negocio se requiere o bien crearla para todos.
+
* [[Ejemplo de proyecto web ABM con Spring Roo]]
 +
* [[Ejemplo de proyecto web ABM con SpringSource Tool Suite]]
  
  controller all --package ~.web
+
== Personalizacion de la capa de persistencia ==
  
=== Maven ===
+
En [[Capa de Persistencia de Spring Roo]] veremos algunas características de uso con [[Oracle]].
  
Desde Roo se pueden ejecutar varias tareas de Maven sin tener que salir del entorno.
+
== Personalizacion de la capa de presentación ==
Por ejemplo:
 
* 'perform tests' equivale a 'mvn test'
 
* 'perform eclipse' equivale a 'mvn eclipse:eclipse'
 
  
=== Seguridad ===
+
En [[Capa de Presentación de Spring Roo]] veremos como cambiar la apariencia de las pantallas web.
  
El módulo de seguridad que viene out-of-the-box necesita unos pequeños cambios de configuración.
+
== Uso de mensajeria ==
De forma predeterminada viene configurado un path segurizado que no corresponde con la aplicación en desarrollo.
 
Se invoca mediante la sentencia:
 
  
  security setup
+
En [[JMS con Spring Roo]] veremos como incorporar tareas asincrónicas a la aplicación.
  
== Ejemplos ==
+
== Uso de servicios web con Rest ==
  
Necesitamos tener correctamente instaladas las siguientes versiones (verificar la configuración de las variables de entorno PATH y JAVA_HOME):
+
En [[Restful con Spring Roo]] veremos como incorporar servicios web sencillos a la aplicación, con la tecnología [http://www.dosideas.com/noticias/java/314-introduccion-a-los-servicios-web-restful.html Rest].
  
* JDK 1.6 UPDATE 21
+
== Creación de Add On ==
* Spring Roo 1.0.2
 
* Apache Maven 2.2.1
 
  
para poder ejecutar los siguientes ejemplos:
+
Podemos incorporar nuevos comandos de Spring Roo, creando un Add On nuevo.
  
* [[Ejemplo de uso de script de Roo]]
+
* [https://fisheye.springsource.org/browse/spring-roo Listado de addons existentes]
* [[Ejemplo de proyecto web para ABMs creado con Roo]]
+
* [http://www.slideshare.net/desmax74/spring-roo-internals-javaday-iv Arquitectura de Spring Roo]
* [[Uso de Roo desde SpringSource Tool Suite]]
+
* [http://abaddon-gtz.blogspot.com/2010/04/un-sencillo-add-on-de-spring-roo.html Un sencillo Add On de Spring Roo]
  
 
== Problemas y soluciones ==
 
== Problemas y soluciones ==
* [[Error durante la ejecución de Roo]]
+
* [[Problemas frecuentes con Spring Roo]]
* [[Error: archivo con una sección asignada a usuario abierta]]
 
* [[No se encuentran las clases de la libreria Jaxb ]]
 
* [[No logro descargar los jars del repositorio Maven]]
 
* [[SurefireExecutionException: Bad version number in .class file]]
 
  
 
== Para que es ideal ==
 
== Para que es ideal ==
Línea 185: Línea 171:
  
 
== Ver también ==
 
== Ver también ==
 +
* [[SpringSource Tool Suite]]
 +
* [[REST con Spring Roo]]
 
* [http://www.springsource.org/roo/ Web oficial de Spring Roo]
 
* [http://www.springsource.org/roo/ Web oficial de Spring Roo]
 +
* [http://static.springsource.org/spring-roo/reference/html-single/index.html Manual de referencia]
 +
* [http://www.infoq.com/presentations/Introducing-Spring-Roo Presentación hecha por el creador]
 +
* [https://admin.na3.acrobat.com/_a204547676/p38684494/?launcher=false&fcsContent=true&pbMode=normal Curso de Spring Roo on-line]
 +
* [http://blog.springsource.com/2009/05/27/roo-part-2/ Ejemplo con buscador dinámico]
 +
* [http://stsmedia.net/introducing-spring-roo-part-2-security-jms-email-support/ Ejemplo con Jms y envío de mails]
  
 
[[Category: Spring Framework]]
 
[[Category: Spring Framework]]

Revisión actual del 18:17 28 mar 2012

Spring Roo es una herramienta RAD extensible para Java basada en Spring Framework. Basicamente es un generador de código avanzado, que se utiliza desde la linea de comandos invocando sentencias.

La idea detrás de Spring Roo es incrementar la productividad del desarrollador Java sin comprometer la integridad estructural o la flexibilidad de la solución. No contiene un componente Runtime. Esto es muy importante, no solo porque no ata la solución al framework, sino porque no genera overhead. Se puede eliminar facilmente.

Está construido con una serie de plugins (al estilo de Maven). Fue diseñado pensando en la usabilidad. Los comandos son contextuales; tiene los comandos "hint" y "help" para consultar el uso rápidamente y la tecla TAB para autocompletar.

Está basado en scripts, por lo que en caso que se cometer un error, se puede hacer rollback. Todos los comandos escritos se van guardando automáticamente (log.roo).

Características

  • Permite desarrollar una aplicación Web en minutos. Genera un war. Construye dos capas: la de persistencia y la de presentación. Para agregar la capa de negocio, se pueden agregar las clases manualmente a los controladores generados con Roo.
  • Permite generar un modelo de datos complejo, incluyendo validaciones.
  • La aplicación Web es RESTful y tiene soporte para internacionalización en varios idiomas.
  • Tiene soporte de seguridad out-of-the-box.
  • La presentación usa Dojo (incorporar otro, por ejemplo JQuery, se hace a mano y es costoso).

Generación de código

Es un generador de código hibrido, utilizando generación activa y pasiva.

Utiliza generación pasiva para generación de archivos java y xml. Utiliza generación activa para la metadata con la ayuda de los tags @Roo* y modifica gradualmente .aj y los jsp.

Sincroniza los cambios entre Roo y las modificaciones realizadas al código (roundtrip).

Spring Roo no interviene en runtime, solo lo hace en tiempo de desarrollo. Una vez creado el proyecto con Spring Roo, podría eliminarse y seguir trabajando con un IDE.

Librerías/Frameworks que usa

Requisitos

Tener instalado Java y Maven, las últimas versiones estables.

Configuración

Descargar la última versión de Roo del sitio oficial. Descomprimir en una carpeta en el disco local. Ej: c:\roo-1.2 Incluir la carpeta con los ejecutables dentro de la variable de entorno PATH. Ej.: c:\roo-1.2\bin

Uso

Para la ejecución de comandos podemos utilizar:

  • el shell de roo mediante linea de comando
  • el shell que viene embebido en el SpringSource Tool Suite
  • o el IDE que utilizás habitualmente, por ejemplo Eclipse. En este caso deberías instalar el plugin para trabajar con aspectos y maven.

Para empezar a usar los comandos Roo mediante el shell, crear una carpeta e invocar a Spring Roo Ej.:

 mkdir helloworld
 cd helloworld
 roo

Al hacer eso se iniciará la interfaz y desplegará el siguiente mensaje:

    / __ \/ __ \/ __ \
   / /_/ / / / / / / /
  / _, _/ /_/ / /_/ /
 /_/ |_|\____/\____/    1.0.2.RELEASE [rev 638]
 
 
 Welcome to Spring Roo. For assistance press TAB or type "hint" then hit ENTER.
 roo>

La tecla TAB despliega las opciones:

 */            /*            //            ;             addon         date          development   exit          help          hint
 metadata      poll          project       quit          reference     script        system        version
 roo>
 

La sentencia help lista todos los comandos con descripciones breves.

Pasos para crear una aplicación mínima

  • Crear el proyecto
  • Elegir el framework de persistencia
  • Crear el modelo de dominio
  • Generar de la capa de presentación


En detalle podés verlo en Roo: Pasos para crear una aplicación mínima.

Manejo de propiedades

Roo genera archivos de propiedades dentro del proyecto, por ejemplo: database.properties. Dichos archivos pueden ser modificados automáticamente por los comandos de roo. Se debe tener en cuenta entonces que al ejecutar un comando que impacte valores configurados manualmente, será necesario volver a configurarlos. Las claves definidas manualmente por el usuario no son alteradas por ningún comando de roo.

Maven

Desde Roo se pueden ejecutar varias tareas de Maven sin tener que salir del entorno. Por ejemplo:

  • 'perform tests' equivale a 'mvn test'
  • 'perform eclipse' equivale a 'mvn eclipse:eclipse'

Seguridad

El módulo de seguridad que viene predeterminado necesita unos pequeños cambios de configuración. De forma predeterminada viene configurado un path segurizado que no corresponde con la aplicación en desarrollo. Se invoca mediante la sentencia:

 security setup

Ejecutar un script

Todo lo que se va ejecutando por consola, se va grabando en un archivo de log (log.roo). Es posible re-ejecutar las acciones, copiando el archivo con otro nombre y utilizando la sentencia 'script <nombre de archivo>' Ej.:

 roo>script helloworld.roo

Ejemplos

Necesitamos tener correctamente instaladas las siguientes versiones (verificar la configuración de las variables de entorno PATH y JAVA_HOME):

  • JDK 1.6 UPDATE 21
  • Spring Roo 1.0.2
  • Apache Maven 2.2.1


Para poder ejecutar los siguientes ejemplos:

Personalizacion de la capa de persistencia

En Capa de Persistencia de Spring Roo veremos algunas características de uso con Oracle.

Personalizacion de la capa de presentación

En Capa de Presentación de Spring Roo veremos como cambiar la apariencia de las pantallas web.

Uso de mensajeria

En JMS con Spring Roo veremos como incorporar tareas asincrónicas a la aplicación.

Uso de servicios web con Rest

En Restful con Spring Roo veremos como incorporar servicios web sencillos a la aplicación, con la tecnología Rest.

Creación de Add On

Podemos incorporar nuevos comandos de Spring Roo, creando un Add On nuevo.

Problemas y soluciones

Para que es ideal

  • Hacer backends de Administración (ABMs/CRUDs con interfaz Web)

Lo que le falta

  • La posibilidad de importar modelos de datos,ya sea desde la base de datos o bien de un archivo de configuración Hibernate. (próximamente disponible en la versión 1.1.0)

Ver también