Diferencia entre revisiones de «Spring Roo»

De Dos Ideas.
Saltar a: navegación, buscar
(Problemas y soluciones)
(Ver también)
 
(No se muestran 64 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 ==
 +
 
 +
*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]].
  
Todo lo que se va ejecutando por consola, se va grabando en un archivo de log (log.roo).
+
== Manejo de propiedades ==
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
+
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.
  
== Pasos para crear una aplicación mínima ==
+
== Maven ==
  
=== Crear un proyecto ===
+
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'
  
  project --topLevelPackage  com.dosideas.helloroo
+
== Seguridad ==
 
 
=== Elegir el framework de persistencia ===
 
  
Se puede elegir entre 3 frameworks y 8 bases de datos
+
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:
  
Frameworks:
+
  security setup
* ECLIPSELINK
 
* HIBERNATE
 
* OPENJPA
 
  
Bases de datos:
+
== Ejecutar un script ==
* DB2
 
* H2_IN_MEMORY
 
* HYPERSONIC_IN_MEMORY
 
* HYPERSONIC_PERSISTENT
 
* MSSQL
 
* MYSQL
 
* ORACLE
 
* POSTGRES
 
* SYBASE
 
  
 +
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.:
 
Ej.:
  
   persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY
+
   roo>script helloworld.roo
 +
 
 +
== Ejemplos ==
  
=== Creación del modelo de datos ===
+
Necesitamos tener correctamente instaladas las siguientes versiones (verificar la configuración de las variables de entorno PATH y JAVA_HOME):
  
Junto con la creación de la clase se puede elegir de crear los tests de componentes correspondientes.
+
* JDK 1.6 UPDATE 21
 +
* Spring Roo 1.0.2
 +
* Apache Maven 2.2.1
  
  entity --class ~.domain.Client --testAutomatically
 
  
Por cada campo a agregar a la clase es necesario definir el tipo, el nombre y las restricciones que pueda tener.
+
Para poder ejecutar los siguientes ejemplos:
  
  field string --fieldName name --notNull --sizeMax 24 --sizeMin 3
+
* [[Ejemplo de script con Spring Roo]]
  field string --fieldName surname --notNull --sizeMin 3 --sizeMax 24
+
* [[Ejemplo de proyecto web ABM con Spring Roo]]
  field date --fieldName birthDate --type java.util.Date --notNull
+
* [[Ejemplo de proyecto web ABM con SpringSource Tool Suite]]
  field boolean --fieldName active
 
  field number --fieldName numberOfKids --type java.lang.Integer --notNull  --max 99
 
  
==== Expresiones regulares ====
+
== Personalizacion de la capa de persistencia ==
  
Existe un bug reportado que impide el uso de expresiones regulares, si bien teoricamente son soportadas por Roo.
+
En [[Capa de Persistencia de Spring Roo]] veremos algunas características de uso con [[Oracle]].
  
=== Interfaz gráfica ===
+
== Personalizacion de la capa de presentación ==
  
Roo permite la creación de la interfaz gráfica web, que comprende de una alta, baja, modificación y listado.
+
En [[Capa de Presentación de Spring Roo]] veremos como cambiar la apariencia de las pantallas web.
Se puede especificar de que objeto de negocio se requiere o bien crearla para todos.
 
  
  controller all --package ~.web
+
== Uso de mensajeria ==
  
=== Maven ===
+
En [[JMS con Spring Roo]] veremos como incorporar tareas asincrónicas a la aplicación.
  
Desde Roo se pueden ejecutar varias tareas de Maven sin tener que salir del entorno.
+
== Uso de servicios web con Rest ==
Por ejemplo:
 
* 'perform tests' equivale a 'mvn test'
 
* 'perform eclipse' equivale a 'mvn eclipse:eclipse'
 
  
=== Seguridad ===
+
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].
  
El módulo de seguridad que viene out-of-the-box necesita unos pequeños cambios de configuración.
+
== Creación de Add On ==
De forma predeterminada viene configurado un path segurizado que no corresponde con la aplicación en desarrollo.
 
Se invoca mediante la sentencia:
 
  
  security setup
+
Podemos incorporar nuevos comandos de Spring Roo, creando un Add On nuevo.
  
 +
* [https://fisheye.springsource.org/browse/spring-roo Listado de addons existentes]
 +
* [http://www.slideshare.net/desmax74/spring-roo-internals-javaday-iv Arquitectura de Spring Roo]
 +
* [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]]
 
  
 
== Para que es ideal ==
 
== Para que es ideal ==
Línea 171: Línea 171:
  
 
== Ver también ==
 
== Ver también ==
* [[Ejemplo de uso de script de Roo]]
+
* [[SpringSource Tool Suite]]
* [[Ejemplo de proyecto web para ABMs creado con Roo]]
+
* [[REST con Spring Roo]]
* [[Uso de Roo desde SpringSource Tool Suite]]
 
 
* [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