Dos Ideas. - Contribuciones del usuario [es]

Archivo:Roo css estandar.gif

2010-07-22T20:45:07Z

Ale holman:

Capa de Presentación de Spring Roo

2010-07-22T20:44:46Z

Ale holman:

[[Spring Roo]] genera la interfaz gráfica de usuario que puede personalizarse, teniendo en cuenta los siguientes componentes:

{| border="0" style="background:#ffffff" align="top"
! width="200 px" style="background:Lavender; color:Black" |Directorio
! width="500 px" style="background:Lavender; color:Black"|Propósito
|-
|/styles||para las hojas de estilo del proyecto (*.css), puede haber más de una
|-
|/images||para las imágenes del proyecto
|-
|/WEB-INF/classes/*.properties||para la configuración de las páginas de estilo
|-
|/WEB-INF/Spring/*.xml||para la configuración de los controladores
|-
|/WEB-INF/i18n/*.properties||para la internacionalizacion de los mensajes
|-
|/WEB-INF/layauts/layouts.xml||para la configuración de las páginas maestras de la aplicación (home, menu, default)
|-
|/WEB-INF/tags/*.tagx||para los tags de declaración de paginado, lenguajes y estilos
|-
|/WEB-INF/views/**/*||para las vistas
|-
|/WEB-INF/web.xml||para configurar el contexto web de la aplicacion
|-
|/WEB-INF/urlrewrite.xml||para configurar la re-escritura de urls de la aplicación
|}

Con la generación de una aplicación web con [[Spring Roo]] y algunos de los siguientes cambios podemos lograr una personalización de su apariencia, sin necesidad de modificar cada una de las pantallas.

Tomando el [[Ejemplo de proyecto web ABM con Spring Roo]] el look & feel original es:

[[Archivo:roo_css_estandar.gif | 700px]]

Luego si hacemos los siguientes cambios:

* el archivo '''/images/banner-graphic.png''' => el banner de la aplicación tendrá el aspecto que nosotros le demos
* el archivo '''/styles/alt.css''' => cambiamos el estilo alternativo de la aplicación. La aplicación generada tiene dos estilos, uno estandar y otro alternativo.
* en el archivo '''/WEB-INF/layouts/default.jspx''' podemos conservar o no el uso de los estilos y/o lenguajes, para nuestro ejemplo dejamos de utilizar la internacionalización. La utilizaremos solo en español.
* en el archivo '''/WEB-INF/i18n/messages-es.properties''' modificamos los mensajes configurados para la pantalla de inicio. En el mismo lugar se pueden modificar el resto de los mensajes de la aplicación.
* en el archivo '''/WEB-INF/i18n/application.properties''' corregimos la pluralización de las etiquetas de menú.
* en el archivo '''/WEB-INF/views/index.jspx''' re-estructuramos los títulos.

Obtenemos:

[[Archivo:roo_css_alternativo.gif | 700px]]

El mayor desafío de esta parte es [[CSS]] en sí, más abajo compartimos algunos tutoriales básicos que encontramos.

== Ver tambien ==
* [[Spring Roo]]
* [http://www.cssya.com.ar Tutorial de css]
* [http://www.cristalab.com/tutoriales/crear-menus-de-navegacion-en-css-usando-listas-c130l/ Tutorial de creación de menu con css]

[[Category: Spring Framework]]

Capa de Presentación de Spring Roo

2010-07-22T20:43:15Z

Ale holman:

[[Spring Roo]] genera la interfaz gráfica de usuario que puede personalizarse, teniendo en cuenta los siguientes componentes:

{| border="0" style="background:#ffffff" align="top"
! width="200 px" style="background:Lavender; color:Black" |Directorio
! width="500 px" style="background:Lavender; color:Black"|Propósito
|-
|/styles||para las hojas de estilo del proyecto (*.css), puede haber más de una
|-
|/images||para las imágenes del proyecto
|-
|/WEB-INF/classes/*.properties||para la configuración de las páginas de estilo
|-
|/WEB-INF/Spring/*.xml||para la configuración de los controladores
|-
|/WEB-INF/i18n/*.properties||para la internacionalizacion de los mensajes
|-
|/WEB-INF/layauts/layouts.xml||para la configuración de las páginas maestras de la aplicación (home, menu, default)
|-
|/WEB-INF/tags/*.tagx||para los tags de declaración de paginado, lenguajes y estilos
|-
|/WEB-INF/views/**/*||para las vistas
|-
|/WEB-INF/web.xml||para configurar el contexto web de la aplicacion
|-
|/WEB-INF/urlrewrite.xml||para configurar la re-escritura de urls de la aplicación
|}

Con la generación de una aplicación web con [[Spring Roo]] y algunos de los siguientes cambios podemos lograr una personalización de su apariencia, sin necesidad de modificar cada una de las pantallas.

Tomando el [[Ejemplo de proyecto web ABM con Spring Roo]] el look & feel original es:

Luego si hacemos los siguientes cambios:

* el archivo '''/images/banner-graphic.png''' => el banner de la aplicación tendrá el aspecto que nosotros le demos
* el archivo '''/styles/alt.css''' => cambiamos el estilo alternativo de la aplicación. La aplicación generada tiene dos estilos, uno estandar y otro alternativo.
* en el archivo '''/WEB-INF/layouts/default.jspx''' podemos conservar o no el uso de los estilos y/o lenguajes, para nuestro ejemplo dejamos de utilizar la internacionalización. La utilizaremos solo en español.
* en el archivo '''/WEB-INF/i18n/messages-es.properties''' modificamos los mensajes configurados para la pantalla de inicio. En el mismo lugar se pueden modificar el resto de los mensajes de la aplicación.
* en el archivo '''/WEB-INF/i18n/application.properties''' corregimos la pluralización de las etiquetas de menú.
* en el archivo '''/WEB-INF/views/index.jspx''' re-estructuramos los títulos.

Obtenemos:

[[Archivo:roo_css_alternativo.gif | 700px]]

El mayor desafío de esta parte es [[CSS]] en sí, más abajo compartimos algunos tutoriales básicos que encontramos.

== Ver tambien ==
* [[Spring Roo]]
* [http://www.cssya.com.ar Tutorial de css]
* [http://www.cristalab.com/tutoriales/crear-menus-de-navegacion-en-css-usando-listas-c130l/ Tutorial de creación de menu con css]

[[Category: Spring Framework]]

Capa de Presentación de Spring Roo

2010-07-22T20:42:52Z

Ale holman:

[[Spring Roo]] genera la interfaz gráfica de usuario que puede personalizarse, teniendo en cuenta los siguientes componentes:

{| border="0" style="background:#ffffff" align="top"
! width="200 px" style="background:Lavender; color:Black" |Directorio
! width="500 px" style="background:Lavender; color:Black"|Propósito
|-
|/styles||para las hojas de estilo del proyecto (*.css), puede haber más de una
|-
|/images||para las imágenes del proyecto
|-
|/WEB-INF/classes/*.properties||para la configuración de las páginas de estilo
|-
|/WEB-INF/Spring/*.xml||para la configuración de los controladores
|-
|/WEB-INF/i18n/*.properties||para la internacionalizacion de los mensajes
|-
|/WEB-INF/layauts/layouts.xml||para la configuración de las páginas maestras de la aplicación (home, menu, default)
|-
|/WEB-INF/tags/*.tagx||para los tags de declaración de paginado, lenguajes y estilos
|-
|/WEB-INF/views/**/*||para las vistas
|-
|/WEB-INF/web.xml||para configurar el contexto web de la aplicacion
|-
|/WEB-INF/urlrewrite.xml||para configurar la re-escritura de urls de la aplicación
|}

Con la generación de una aplicación web con [[Spring Roo]] y algunos de los siguientes cambios podemos lograr una personalización de su apariencia, sin necesidad de modificar cada una de las pantallas.

Tomando el [[Ejemplo de proyecto web ABM con Spring Roo]] el look & feel original es:

Luego si hacemos los siguientes cambios:

* el archivo '''/images/banner-graphic.png''' => el banner de la aplicación tendrá el aspecto que nosotros le demos
* el archivo '''/styles/alt.css''' => cambiamos el estilo alternativo de la aplicación. La aplicación generada tiene dos estilos, uno estandar y otro alternativo.
* en el archivo '''/WEB-INF/layouts/default.jspx''' podemos conservar o no el uso de los estilos y/o lenguajes, para nuestro ejemplo dejamos de utilizar la internacionalización. La utilizaremos solo en español.
* en el archivo '''/WEB-INF/i18n/messages-es.properties''' modificamos los mensajes configurados para la pantalla de inicio. En el mismo lugar se pueden modificar el resto de los mensajes de la aplicación.
* en el archivo '''/WEB-INF/i18n/application.properties''' corregimos la pluralización de las etiquetas de menú.
* en el archivo '''/WEB-INF/views/index.jspx''' re-estructuramos los títulos.

Obtenemos:

[[Archivo:roo_css_alternativo.gif | 800px]]

El mayor desafío de esta parte es [[CSS]] en sí, más abajo compartimos algunos tutoriales básicos que encontramos.

== Ver tambien ==
* [[Spring Roo]]
* [http://www.cssya.com.ar Tutorial de css]
* [http://www.cristalab.com/tutoriales/crear-menus-de-navegacion-en-css-usando-listas-c130l/ Tutorial de creación de menu con css]

[[Category: Spring Framework]]

Capa de Presentación de Spring Roo

2010-07-22T20:42:30Z

Ale holman:

[[Spring Roo]] genera la interfaz gráfica de usuario que puede personalizarse, teniendo en cuenta los siguientes componentes:

{| border="0" style="background:#ffffff" align="top"
! width="200 px" style="background:Lavender; color:Black" |Directorio
! width="500 px" style="background:Lavender; color:Black"|Propósito
|-
|/styles||para las hojas de estilo del proyecto (*.css), puede haber más de una
|-
|/images||para las imágenes del proyecto
|-
|/WEB-INF/classes/*.properties||para la configuración de las páginas de estilo
|-
|/WEB-INF/Spring/*.xml||para la configuración de los controladores
|-
|/WEB-INF/i18n/*.properties||para la internacionalizacion de los mensajes
|-
|/WEB-INF/layauts/layouts.xml||para la configuración de las páginas maestras de la aplicación (home, menu, default)
|-
|/WEB-INF/tags/*.tagx||para los tags de declaración de paginado, lenguajes y estilos
|-
|/WEB-INF/views/**/*||para las vistas
|-
|/WEB-INF/web.xml||para configurar el contexto web de la aplicacion
|-
|/WEB-INF/urlrewrite.xml||para configurar la re-escritura de urls de la aplicación
|}

Con la generación de una aplicación web con [[Spring Roo]] y algunos de los siguientes cambios podemos lograr una personalización de su apariencia, sin necesidad de modificar cada una de las pantallas.

Tomando el [[Ejemplo de proyecto web ABM con Spring Roo]] el look & feel original es:

Luego si hacemos los siguientes cambios:

* el archivo '''/images/banner-graphic.png''' => el banner de la aplicación tendrá el aspecto que nosotros le demos
* el archivo '''/styles/alt.css''' => cambiamos el estilo alternativo de la aplicación. La aplicación generada tiene dos estilos, uno estandar y otro alternativo.
* en el archivo '''/WEB-INF/layouts/default.jspx''' podemos conservar o no el uso de los estilos y/o lenguajes, para nuestro ejemplo dejamos de utilizar la internacionalización. La utilizaremos solo en español.
* en el archivo '''/WEB-INF/i18n/messages-es.properties''' modificamos los mensajes configurados para la pantalla de inicio. En el mismo lugar se pueden modificar el resto de los mensajes de la aplicación.
* en el archivo '''/WEB-INF/i18n/application.properties''' corregimos la pluralización de las etiquetas de menú.
* en el archivo '''/WEB-INF/views/index.jspx''' re-estructuramos los títulos.

Obtenemos:

[[Archivo:roo_css_alternativo.gif | 500px]]

El mayor desafío de esta parte es [[CSS]] en sí, más abajo compartimos algunos tutoriales básicos que encontramos.

== Ver tambien ==
* [[Spring Roo]]
* [http://www.cssya.com.ar Tutorial de css]
* [http://www.cristalab.com/tutoriales/crear-menus-de-navegacion-en-css-usando-listas-c130l/ Tutorial de creación de menu con css]

[[Category: Spring Framework]]

Archivo:Roo css alternativo.gif

2010-07-22T20:41:40Z

Ale holman:

Capa de Presentación de Spring Roo

2010-07-22T20:41:20Z

Ale holman:

[[Spring Roo]] genera la interfaz gráfica de usuario que puede personalizarse, teniendo en cuenta los siguientes componentes:

{| border="0" style="background:#ffffff" align="top"
! width="200 px" style="background:Lavender; color:Black" |Directorio
! width="500 px" style="background:Lavender; color:Black"|Propósito
|-
|/styles||para las hojas de estilo del proyecto (*.css), puede haber más de una
|-
|/images||para las imágenes del proyecto
|-
|/WEB-INF/classes/*.properties||para la configuración de las páginas de estilo
|-
|/WEB-INF/Spring/*.xml||para la configuración de los controladores
|-
|/WEB-INF/i18n/*.properties||para la internacionalizacion de los mensajes
|-
|/WEB-INF/layauts/layouts.xml||para la configuración de las páginas maestras de la aplicación (home, menu, default)
|-
|/WEB-INF/tags/*.tagx||para los tags de declaración de paginado, lenguajes y estilos
|-
|/WEB-INF/views/**/*||para las vistas
|-
|/WEB-INF/web.xml||para configurar el contexto web de la aplicacion
|-
|/WEB-INF/urlrewrite.xml||para configurar la re-escritura de urls de la aplicación
|}

Con la generación de una aplicación web con [[Spring Roo]] y algunos de los siguientes cambios podemos lograr una personalización de su apariencia, sin necesidad de modificar cada una de las pantallas.

Tomando el [[Ejemplo de proyecto web ABM con Spring Roo]] el look & feel original es:

Luego si hacemos los siguientes cambios:

* el archivo '''/images/banner-graphic.png''' => el banner de la aplicación tendrá el aspecto que nosotros le demos
* el archivo '''/styles/alt.css''' => cambiamos el estilo alternativo de la aplicación. La aplicación generada tiene dos estilos, uno estandar y otro alternativo.
* en el archivo '''/WEB-INF/layouts/default.jspx''' podemos conservar o no el uso de los estilos y/o lenguajes, para nuestro ejemplo dejamos de utilizar la internacionalización. La utilizaremos solo en español.
* en el archivo '''/WEB-INF/i18n/messages-es.properties''' modificamos los mensajes configurados para la pantalla de inicio. En el mismo lugar se pueden modificar el resto de los mensajes de la aplicación.
* en el archivo '''/WEB-INF/i18n/application.properties''' corregimos la pluralización de las etiquetas de menú.
* en el archivo '''/WEB-INF/views/index.jspx''' re-estructuramos los títulos.

Obtenemos:

[[Archivo:roo_css_alternativo.gif]]

El mayor desafío de esta parte es [[CSS]] en sí, más abajo compartimos algunos tutoriales básicos que encontramos.

== Ver tambien ==
* [[Spring Roo]]
* [http://www.cssya.com.ar Tutorial de css]
* [http://www.cristalab.com/tutoriales/crear-menus-de-navegacion-en-css-usando-listas-c130l/ Tutorial de creación de menu con css]

[[Category: Spring Framework]]

Capa de Presentación de Spring Roo

2010-07-22T20:40:54Z

Ale holman:

[[Spring Roo]] genera la interfaz gráfica de usuario que puede personalizarse, teniendo en cuenta los siguientes componentes:

{| border="0" style="background:#ffffff" align="top"
! width="200 px" style="background:Lavender; color:Black" |Directorio
! width="500 px" style="background:Lavender; color:Black"|Propósito
|-
|/styles||para las hojas de estilo del proyecto (*.css), puede haber más de una
|-
|/images||para las imágenes del proyecto
|-
|/WEB-INF/classes/*.properties||para la configuración de las páginas de estilo
|-
|/WEB-INF/Spring/*.xml||para la configuración de los controladores
|-
|/WEB-INF/i18n/*.properties||para la internacionalizacion de los mensajes
|-
|/WEB-INF/layauts/layouts.xml||para la configuración de las páginas maestras de la aplicación (home, menu, default)
|-
|/WEB-INF/tags/*.tagx||para los tags de declaración de paginado, lenguajes y estilos
|-
|/WEB-INF/views/**/*||para las vistas
|-
|/WEB-INF/web.xml||para configurar el contexto web de la aplicacion
|-
|/WEB-INF/urlrewrite.xml||para configurar la re-escritura de urls de la aplicación
|}

Con la generación de una aplicación web con [[Spring Roo]] y algunos de los siguientes cambios podemos lograr una personalización de su apariencia, sin necesidad de modificar cada una de las pantallas.

Tomando el [[Ejemplo de proyecto web ABM con Spring Roo]] el look & feel original es:

Luego si hacemos los siguientes cambios:

* el archivo '''/images/banner-graphic.png''' => el banner de la aplicación tendrá el aspecto que nosotros le demos
* el archivo '''/styles/alt.css''' => cambiamos el estilo alternativo de la aplicación. La aplicación generada tiene dos estilos, uno estandar y otro alternativo.
* en el archivo '''/WEB-INF/layouts/default.jspx''' podemos conservar o no el uso de los estilos y/o lenguajes, para nuestro ejemplo dejamos de utilizar la internacionalización. La utilizaremos solo en español.
* en el archivo '''/WEB-INF/i18n/messages-es.properties''' modificamos los mensajes configurados para la pantalla de inicio. En el mismo lugar se pueden modificar el resto de los mensajes de la aplicación.
* en el archivo '''/WEB-INF/i18n/application.properties''' corregimos la pluralización de las etiquetas de menú.
* en el archivo '''/WEB-INF/views/index.jspx''' re-estructuramos los títulos.

Obtenemos:

[Archivo:roo_css_alternativo.gif]

El mayor desafío de esta parte es [[CSS]] en sí, más abajo compartimos algunos tutoriales básicos que encontramos.

== Ver tambien ==
* [[Spring Roo]]
* [http://www.cssya.com.ar Tutorial de css]
* [http://www.cristalab.com/tutoriales/crear-menus-de-navegacion-en-css-usando-listas-c130l/ Tutorial de creación de menu con css]

[[Category: Spring Framework]]

Ejemplo de integracion Roo y Oracle

2010-07-19T15:51:38Z

Ale holman: /* Definición del modelo de datos */

Haremos el [[Ejemplo de proyecto web ABM con Spring Roo]] accediendo a una base de datos Oracle en lugar de una base en memoria.

== Comando de persistencia ==

Habiendo generado el proyecto, el comando

<code>
persistence setup --database ORACLE --provider HIBERNATE
</code>

nos permite trabajar con un esquema en una base de datos oracle utilizando Hibernate como ORM.

[[Archivo: roo_database_properties.gif | 650 px]]

Como vemos, genera un archivo database.properties donde está la información de conexión.

Por la versión de [[Spring Roo]] hay un error en el pom.xml por dependencias. Ver [[Problemas_frecuentes_con_Spring_Roo#Missing_artifact_com.oracle:ojdbc14:jar:10.2.0.2:compile]]

== Configurando las propiedades de acceso a la base de datos ==

Podemos cambiar la configuración editando el archivo database.properties o mediante los comandos que provee roo, lo cual nos permitiría dejar un script listo para correrlo en otra ocasión.

El comando para ver todas las propiedades del archivo es:
<code>
database properties list
</code>

Para cambiar los valores:
<code>
database properties set --key database.password --value unaPassword
database properties set --key database.username --value unUsuario
database properties set --key database.url --value jdbc:oracle:thin:@unHost:unPuerto:unEsquema
</code>

== Definición del modelo de datos ==

Como hicimos anteriormente, creamos las entidades y sus atributos:

<code>
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza
</code>

Para probar el funciomiento ejecutar
<code>
controller all --package ~.web
perform package
</code>
y deployar. En este punto se puede verificar el modelo de datos accediendo a la base de datos. Los nombres de las tablas y columnas se corresponden con los nombres de las entidades y sus atributos, separando los nombres compuestos con "_". Ejemplo: fecha_entrega.

== Características de la creación del modelo ==
* En el archivo persistence.xml el valor defecto de la propiedad "hibernate.hbm2ddl.auto" es "create", por lo cual se generara el esquema de bd al correr la aplicación. Para no perder los datos en el siguiente deploy deberá actualizarse dicho valor a "validate".
* El agregado de atributos en la aplicación provoca un alter en la tabla correspondiente.
* La eliminación de atributos en la aplicación no se refleja en la base de datos.
* Crea los objetos de base de datos y sus relaciones al ejecutar la aplicación por primera vez.
* Provee un campo "version" para el control de cambios que autoincrementa con cada update del registro.
* Provee un campo "id" usando una única secuencia para todo el modelo de datos.

== Ver tambien ==
* [[Spring Roo]]

Ejemplo de integracion Roo y Oracle

2010-07-19T15:41:41Z

Ale holman: /* Características de la creación del modelo */

Haremos el [[Ejemplo de proyecto web ABM con Spring Roo]] accediendo a una base de datos Oracle en lugar de una base en memoria.

== Comando de persistencia ==

Habiendo generado el proyecto, el comando

<code>
persistence setup --database ORACLE --provider HIBERNATE
</code>

nos permite trabajar con un esquema en una base de datos oracle utilizando Hibernate como ORM.

[[Archivo: roo_database_properties.gif | 650 px]]

Como vemos, genera un archivo database.properties donde está la información de conexión.

Por la versión de [[Spring Roo]] hay un error en el pom.xml por dependencias. Ver [[Problemas_frecuentes_con_Spring_Roo#Missing_artifact_com.oracle:ojdbc14:jar:10.2.0.2:compile]]

== Configurando las propiedades de acceso a la base de datos ==

Podemos cambiar la configuración editando el archivo database.properties o mediante los comandos que provee roo, lo cual nos permitiría dejar un script listo para correrlo en otra ocasión.

El comando para ver todas las propiedades del archivo es:
<code>
database properties list
</code>

Para cambiar los valores:
<code>
database properties set --key database.password --value unaPassword
database properties set --key database.username --value unUsuario
database properties set --key database.url --value jdbc:oracle:thin:@unHost:unPuerto:unEsquema
</code>

== Definición del modelo de datos ==

Como hicimos anteriormente, creamos las entidades y sus atributos:

<code>
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza
</code>

Para probar el funciomiento ejecutar
<code>
controller all --package ~.web
perform package
</code>
y deployar. En este punto se puede verificar el modelo de datos accediendo a la base de datos.

== Características de la creación del modelo ==
* En el archivo persistence.xml el valor defecto de la propiedad "hibernate.hbm2ddl.auto" es "create", por lo cual se generara el esquema de bd al correr la aplicación. Para no perder los datos en el siguiente deploy deberá actualizarse dicho valor a "validate".
* El agregado de atributos en la aplicación provoca un alter en la tabla correspondiente.
* La eliminación de atributos en la aplicación no se refleja en la base de datos.
* Crea los objetos de base de datos y sus relaciones al ejecutar la aplicación por primera vez.
* Provee un campo "version" para el control de cambios que autoincrementa con cada update del registro.
* Provee un campo "id" usando una única secuencia para todo el modelo de datos.

== Ver tambien ==
* [[Spring Roo]]

Spring Roo

2010-07-19T15:36:48Z

Ale holman:

[[Spring Roo]] es una herramienta RAD extensible para [[Java]]. 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 ===

* [[Java]]
* [[AspectJ]]
* [[Eclipse]]
* Java Persistence API: [[Hibernate]], [[OpenJPA]], [[EclipseLink]]
* [[Java Server Pages]]
* [[JUnit]]
* [[Log4J]]
* [[Maven]]
* [[Selenium]]
* [[Spring Framework]]
* [[Spring MVC]]
* [[Spring Security]]
* [[Spring Web Flow]]

== 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 ==

En [[Roo: Pasos para crear una aplicación mínima]] vemos como:

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

== 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:

* [[Ejemplo de script con Spring Roo]]
* [[Ejemplo de proyecto web ABM con Spring Roo]]
* [[Ejemplo de proyecto web ABM con SpringSource Tool Suite]]
* [[Ejemplo de integracion Roo y Oracle]]

== Problemas y soluciones ==
* [[Problemas frecuentes con Spring Roo]]

== 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 ==
* [[SpringSource Tool Suite]]
* [http://www.springsource.org/roo/ Web oficial de Spring Roo]
* [http://static.springsource.org/spring-roo/reference/html-single/index.html#usage-recommendations Reference Spring roo]
* [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]]

Spring Roo

2010-07-19T15:26:51Z

Ale holman: /* Pasos para crear una aplicación mínima */

[[Spring Roo]] es una herramienta RAD extensible para [[Java]]. 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 ===

* [[Java]]
* [[AspectJ]]
* [[Eclipse]]
* Java Persistence API: [[Hibernate]], [[OpenJPA]], [[EclipseLink]]
* [[Java Server Pages]]
* [[JUnit]]
* [[Log4J]]
* [[Maven]]
* [[Selenium]]
* [[Spring Framework]]
* [[Spring MVC]]
* [[Spring Security]]
* [[Spring Web Flow]]

== 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 ==

En [[Roo: Pasos para crear una aplicación mínima]] vemos como:

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

== 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:

* [[Ejemplo de script con Spring Roo]]
* [[Ejemplo de proyecto web ABM con Spring Roo]]
* [[Ejemplo de proyecto web ABM con SpringSource Tool Suite]]
* [[Ejemplo de integracion Roo y Oracle]]

== Problemas y soluciones ==
* [[Problemas frecuentes con Spring Roo]]

== 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 ==
* [[SpringSource Tool Suite]]
* [http://www.springsource.org/roo/ Web oficial de Spring Roo]
* [http://static.springsource.org/spring-roo/reference/html-single/index.html#usage-recommendations Reference Spring roo]
* [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]]

Ejemplo de integracion Roo y Oracle

2010-07-19T15:24:28Z

Ale holman:

Haremos el [[Ejemplo de proyecto web ABM con Spring Roo]] accediendo a una base de datos Oracle en lugar de una base en memoria.

== Comando de persistencia ==

Habiendo generado el proyecto, el comando

<code>
persistence setup --database ORACLE --provider HIBERNATE
</code>

nos permite trabajar con un esquema en una base de datos oracle utilizando Hibernate como ORM.

[[Archivo: roo_database_properties.gif | 650 px]]

Como vemos, genera un archivo database.properties donde está la información de conexión.

Por la versión de [[Spring Roo]] hay un error en el pom.xml por dependencias. Ver [[Problemas_frecuentes_con_Spring_Roo#Missing_artifact_com.oracle:ojdbc14:jar:10.2.0.2:compile]]

== Configurando las propiedades de acceso a la base de datos ==

Podemos cambiar la configuración editando el archivo database.properties o mediante los comandos que provee roo, lo cual nos permitiría dejar un script listo para correrlo en otra ocasión.

El comando para ver todas las propiedades del archivo es:
<code>
database properties list
</code>

Para cambiar los valores:
<code>
database properties set --key database.password --value unaPassword
database properties set --key database.username --value unUsuario
database properties set --key database.url --value jdbc:oracle:thin:@unHost:unPuerto:unEsquema
</code>

== Definición del modelo de datos ==

Como hicimos anteriormente, creamos las entidades y sus atributos:

<code>
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza
</code>

Para probar el funciomiento ejecutar
<code>
controller all --package ~.web
perform package
</code>
y deployar. En este punto se puede verificar el modelo de datos accediendo a la base de datos.

== Características de la creación del modelo ==
* En el archivo persistence.xml el valor defecto de la propiedad "hibernate.hbm2ddl.auto" es "create", por lo cual se generara el esquema de bd al correr la aplicación. Para no perder los datos en el siguiente deploy deberá actualizarse dicho valor a "validate".
* Crea los objetos de base de datos y sus relaciones al ejecutar la aplicación por primera vez.
* Provee un campo "version" para el control de cambios que autoincrementa con cada update del registro.
* Provee un campo "id" usando una única secuencia para todo el modelo de datos.

== Ver tambien ==
* [[Spring Roo]]

Ejemplo de integracion Roo y Oracle

2010-07-19T15:20:10Z

Ale holman:

Ejemplo de integracion Roo y Oracle

2010-07-19T14:41:00Z

Ale holman: /* Comando de persistencia */

Ejemplo de integracion Roo y Oracle

2010-07-19T14:40:45Z

Ale holman: /* Comando de persistencia */

Ejemplo de integracion Roo y Oracle

2010-07-19T14:40:34Z

Ale holman: /* Comando de persistencia */

Ejemplo de integracion Roo y Oracle

2010-07-19T14:40:22Z

Ale holman: /* Comando de persistencia */

Archivo:Roo database properties.gif

2010-07-19T14:39:08Z

Ale holman:

Uso de Roo desde SpringSource Tool Suite

2010-07-15T00:58:25Z

Ale holman: /* Desarrollo y sincronizacion */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

<code>
mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".
</code>

[[Archivo:crearProyectoRoo.jpg|600px]]

[[Archivo:crearProyectoRoo2.jpg|400px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|600px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Desarrollo y sincronizacion ==

Como vemos, el editor de STS es similar a Eclipse. Si tenemos el shell de roo corriendo y realizamos modificaciones, por ejemplo el agregado de un atributo en una entidad de dominio, veremos que en la consola de roo que se actualizan todos los archivos de aspectos, los controllers y los jsp para agregar el nuevo atributo. Esta sincronización se da automáticamente al guardar los cambios.

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|400px]]

[[Archivo:runOnServer2.jpg|400px]]

con eso se levanta el server y se instala la aplicación, que puede verse en: http://localhost:8080/Pizza

== Volver a abrir el shell de roo ==

[[Archivo:abrirRooShell.jpg|400px]]

Archivo:AbrirRooShell.jpg

2010-07-14T18:37:07Z

Ale holman:

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:36:53Z

Ale holman: /* Volver a abrir el shell de roo */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

<code>
mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".
</code>

[[Archivo:crearProyectoRoo.jpg|600px]]

[[Archivo:crearProyectoRoo2.jpg|400px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|600px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Desarrollo y sincronizacion ==

Como vemos, el editor de STS es similar a Eclipse. Si tenemos el shell de roo corriendo y realizamos modificaciones, por ejemplo el agregado de un atributo en una entidad de dominio, veremos que en la consola de roo que se actualizan todos los archivos de aspectos, los controllers y los jsp para agregar el nuevo atributo. Esta sincronización se da automáticamente al realizar el cambio.

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|400px]]

[[Archivo:runOnServer2.jpg|400px]]

con eso se levanta el server y se instala la aplicación, que puede verse en: http://localhost:8080/Pizza

== Volver a abrir el shell de roo ==

[[Archivo:abrirRooShell.jpg|400px]]

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:36:35Z

Ale holman:

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

<code>
mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".
</code>

[[Archivo:crearProyectoRoo.jpg|600px]]

[[Archivo:crearProyectoRoo2.jpg|400px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|600px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Desarrollo y sincronizacion ==

Como vemos, el editor de STS es similar a Eclipse. Si tenemos el shell de roo corriendo y realizamos modificaciones, por ejemplo el agregado de un atributo en una entidad de dominio, veremos que en la consola de roo que se actualizan todos los archivos de aspectos, los controllers y los jsp para agregar el nuevo atributo. Esta sincronización se da automáticamente al realizar el cambio.

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|400px]]

[[Archivo:runOnServer2.jpg|400px]]

con eso se levanta el server y se instala la aplicación, que puede verse en: http://localhost:8080/Pizza

== Volver a abrir el shell de roo ==

[[Archivo:abrirRooShell.jpg]]

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:33:59Z

Ale holman:

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

<code>
mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".
</code>

[[Archivo:crearProyectoRoo.jpg|600px]]

[[Archivo:crearProyectoRoo2.jpg|400px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|600px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Desarrollo y sincronizacion ==

Como vemos, el editor de STS es similar a Eclipse. Si tenemos el shell de roo corriendo y realizamos modificaciones, por ejemplo el agregado de un atributo en una entidad de dominio, veremos que en la consola de roo que se actualizan todos los archivos de aspectos, los controllers y los jsp para agregar el nuevo atributo. Esta sincronización se da automáticamente al realizar el cambio.

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|400px]]

[[Archivo:runOnServer2.jpg|400px]]

con eso se levanta el server y se instala la aplicación, que puede verse en: http://localhost:8080/Pizza

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:30:44Z

Ale holman: /* Creacion del proyecto */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

<code>
mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".
</code>

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|500px]]

[[Archivo:runOnServer2.jpg|500px]]

con eso se levanta el server y se instala la aplicación, que puede verse en: http://localhost:8080/Pizza

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:30:26Z

Ale holman: /* Ejecucion del proyecto */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|500px]]

[[Archivo:runOnServer2.jpg|500px]]

con eso se levanta el server y se instala la aplicación, que puede verse en: http://localhost:8080/Pizza

Archivo:RunOnServer2.jpg

2010-07-14T18:24:41Z

Ale holman:

Archivo:RunOnServer.jpg

2010-07-14T18:24:22Z

Ale holman:

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:23:53Z

Ale holman: /* Ejecucion del proyecto */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:runOnServer.jpg|500px]]

[[Archivo:runOnServer2.jpg|500px]]

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:22:34Z

Ale holman: /* Ejecucion del proyecto */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:ruOnServer.jpg|500px]]

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:22:11Z

Ale holman:

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Creacion del proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingreso de comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

== Ejecucion del proyecto ==

Ahora podemos ejecutar el proyecto en el servidor, que también está embebido en el STS:

[[Archivo:ruOnServer.jpg]]

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:15:48Z

Ale holman: /* Ingresando comandos */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Crear proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingresando comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar el war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:15:31Z

Ale holman: /* Ingresando comandos */

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Crear proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingresando comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo y para generar wl war.
Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

// Tests
perform tests

// Generacion de interfaz de usuario
controller all --package ~.web

// Genera el war de la aplicacion
perform package

</code>

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:13:48Z

Ale holman:

== Introduccion ==

SpringSource Tool Suite (STS) es un IDE basado en Eclipse con algunas características que facilitan trabajar con Roo, como por ejemplo el shell de roo embebido, la posibilidad de autocompletar comandos mediante Ctrl+Space y la posibilidad de acceder mediante links a los recursos que va modificando roo.

Vamos a realizar el [http://www.dosideas.com/wiki/Ejemplo_de_proyecto_web_para_ABMs_creado_con_Roo Ejemplo de proyecto web para ABMs creado con Roo] utilizando STS.

== Instalacion ==

Sólo se debe [http://www.springsource.com/products/springsource-tool-suite-download descargar STS] y descomprimirlo. En esta wiki estaremos utilizando el release 2.3.2.
La primera vez que se cargue el IDE solicitará se define un directorio workspace donde estarán los proyectos.

== Crear proyecto ==

Creamos un Roo Project y especificamos un nombre y un package base. Esto equivale a las sentencias

mkdir Pizza
cd Pizza
roo
roo> project "--topLevelPackage com.springsource.roo.pizzaDosIdeas".

[[Archivo:crearProyectoRoo.jpg|700px]]

[[Archivo:crearProyectoRoo2.jpg|500px]]

Como resultado podemos ver la estructura de directorios generada (sigue las convenciones de maven) y el shell de roo embebido.

[[Archivo:rooShell.jpg|700px]]

== Ingresando comandos ==

Ahora iremos ingresando comandos en el shell embebido de roo.
Notemos:
* que podremos usar Ctrl+Space para ir autocompletando tanto los comandos como los packages.
* "~" es el shortcut para indicar el paquete base.

Ingresaremos en el shell los comandos para definir la persistencia de datos y definir el modelo de dominio tal como hicimos en el ejemplo. Los comandos a ingresar son:

<code>

// Definir persistencia de datos
persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

// Definir modelo de datos
entity --class ~.domain.Cubierta --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Base --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
entity --class ~.domain.Pizza --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field number --fieldName precio --type java.lang.Float
field set --fieldName coberturas --element ~.domain.Cubierta
field reference --fieldName base --type ~.domain.Base
entity --class ~.domain.Pedido --testAutomatically
field string --fieldName nombre --notNull --sizeMin 2
field string --fieldName direccion --sizeMax 30
field number --fieldName importe --type java.lang.Float
field date --fieldName fechaEntrega --type java.util.Date
field set --fieldName pizzas --element ~.domain.Pizza

</code>

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:08:13Z

Ale holman: /* Crear proyecto */

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:07:42Z

Ale holman: /* Crear proyecto */

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:07:25Z

Ale holman: /* Crear proyecto */

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:07:04Z

Ale holman: /* Crear proyecto */

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:06:47Z

Ale holman: /* Crear proyecto */

Archivo:RooShell.jpg

2010-07-14T18:06:08Z

Ale holman: Shell de roo embebido en STS

Shell de roo embebido en STS

Uso de Roo desde SpringSource Tool Suite

2010-07-14T18:05:46Z

Ale holman: /* Crear proyecto */

Uso de Roo desde SpringSource Tool Suite

2010-07-14T17:30:41Z

Ale holman: /* Crear proyecto */

Archivo:CrearProyectoRoo2.jpg

2010-07-14T17:28:17Z

Ale holman:

Uso de Roo desde SpringSource Tool Suite

2010-07-14T17:27:53Z

Ale holman: /* Crear proyecto */

Spring Roo

2010-07-14T17:16:27Z

Ale holman: /* Problemas y soluciones */

== Descripción ==
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)
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.
* 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.

=== 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* e modifica gradualmente .aj y los jsp.

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

=== Librerías/Frameworks que usa ===

* Java
* Spring Framework
* Java Persistence API (Hibernate)
* Java Server PAges
* Spring Security
* Spring Web Flow
* Log4j
* Maven
* AspectJ
* Eclipse
* JUnit
* Selenium

== 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 empezar a Roo, crear una carpeta e invocar a 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.

== 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

== Pasos para crear una aplicación mínima ==

=== Crear un proyecto ===

project --topLevelPackage com.dosideas.helloroo

=== Elegir el framework de persistencia ===

Se puede elegir entre 3 frameworks y 8 bases de datos

Frameworks:
* ECLIPSELINK
* HIBERNATE
* OPENJPA

Bases de datos:
* DB2
* H2_IN_MEMORY
* HYPERSONIC_IN_MEMORY
* HYPERSONIC_PERSISTENT
* MSSQL
* MYSQL
* ORACLE
* POSTGRES
* SYBASE

Ej.:

persistence setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY

=== Creación del modelo de datos ===

Junto con la creación de la clase se puede elegir de crear los tests de componentes correspondientes.

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.

field string --fieldName name --notNull --sizeMax 24 --sizeMin 3
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 ====

Existe un bug reportado que impide el uso de expresiones regulares, si bien teoricamente son soportadas por Roo.

=== Interfaz gráfica ===

Roo permite la creación de la interfaz gráfica web, que comprende de una alta, baja, modificación y listado.
Se puede especificar de que objeto de negocio se requiere o bien crearla para todos.

controller all --package ~.web

=== 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 out-of-the-box 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

== 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:

* [[Ejemplo de uso de script de Roo]]
* [[Ejemplo de proyecto web para ABMs creado con Roo]]
* [[Uso de Roo desde SpringSource Tool Suite]]

== Problemas y soluciones ==
* [[Error durante la ejecución de 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 ==

* 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 ==
* [http://www.springsource.org/roo/ Web oficial de Spring Roo]

[[Category: Spring Framework]]

Archivo:CrearProyectoRoo.jpg

2010-07-14T14:29:06Z

Ale holman: Creacion de un proyecto roo con STS.

Creacion de un proyecto roo con STS.

Apache CXF

2009-07-28T15:04:11Z

Ale holman: Página creada con '=== Construcción de un servicio y su cliente con cxf === La noticia [http://www.dosideas.com/java/396-servicios-web-con-apache-cxf.html Servicios web con Apache CXF] da una int...'

=== Construcción de un servicio y su cliente con cxf ===
La noticia [http://www.dosideas.com/java/396-servicios-web-con-apache-cxf.html Servicios web con Apache CXF] da una introducción a cxf, explica cómo crear un servicio web con cxf y también la creación de un cliente que lo consuma.

=== CXF y Weblogic 9.2 ===
Deployar una aplicación que utiliza cxf en weblogic 9.2 provoca un conflicto de versiones de las librerías de jax-ws. Para solucionarlo, el archivo weblogic-application.xml debe contener lo siguiente:

<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<weblogic-application xmlns="http://www.bea.com/ns/weblogic/90">


<prefer-application-packages>
<package-name>org.apache.xerces.*</package-name>
<package-name>javax.jws.*</package-name>
</prefer-application-packages>

</weblogic-application>
</code>

De esta manera indicamos a weblogic que debe dar prioridad a las clases contenidas en el jar de jax-ws provisto por la aplicación, por sobre la versión de esas mismas clases q están contenidas en el weblogic.jar.

Colas De Mensajes Con AquaLogic

2009-07-21T14:54:27Z

Ale holman: /* Agregamos otras validaciones */

Vamos a exponer con [[AquaLogic]] un [[Web Service]] que nos permita enviar un mensaje a una cola de mensajería. Partimos de un [[WSDL]] en donde definimos una operación “enviarFactura” que recibe como parámetro un elemento de tipo factura. Los elementos y tipos de dato de una factura se encuentran definidos en el esquema xml asociado al [[WSDL]].

==La definición del servicio==
===Wsdl===
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<definitions name="facturaWsdl" targetNamespace="http://j2ee.netbeans.org/wsdl/facturaWsdl"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://j2ee.netbeans.org/wsdl/facturaWsdl"
xmlns:ns="http://xml.netbeans.org/schema/facturaXmlSchema"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<types>
<xsd:schema targetNamespace="http://j2ee.netbeans.org/wsdl/facturaWsdl">
<xsd:import namespace="http://xml.netbeans.org/schema/facturaXmlSchema"
schemaLocation="../schema/facturaXmlSchema.xsd"/>
</xsd:schema>
</types>
<message name="enviarFacturaRequest">
<part name="part1" element="ns:factura"/>
</message>
<message name="enviarFacturaResponse"/>
<portType name="facturaWsdlPortType">
<operation name="enviarFactura">
<input name="input1" message="tns:enviarFacturaRequest"/>
<output name="output1" message="tns:enviarFacturaResponse"/>
</operation>
</portType>
<binding name="facturaWsdlBinding" type="tns:facturaWsdlPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="enviarFactura">
<soap:operation/>
<input name="input1">
<soap:body use="literal"/>
</input>
<output name="output1">
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="facturaWsdlService">
<port name="facturaWsdlPort" binding="tns:facturaWsdlBinding">
<soap:address
location="http://localhost:${HttpDefaultPort}/facturaWsdlService/facturaWsdlPort"/>
</port>
</service>
</definitions>
</code>

===El Esquema XML (XSD)===
<code xml>
<?xml version="1.0" encoding="UTF-8"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://xml.netbeans.org/schema/facturaXmlSchema"
xmlns:tns="http://xml.netbeans.org/schema/facturaXmlSchema"
elementFormDefault="qualified">

<xsd:element name="factura">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="numeroFactura" type="xsd:string"/>
<xsd:element name="fecha" type="xsd:string"/>
<xsd:element name="items" type="tns:listaItemsFactura"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>

<xsd:complexType name="itemFactura">
<xsd:all>
<xsd:element name="codigoArticulo" type="xsd:string"/>
<xsd:element name="descripcion" minOccurs="0" type="xsd:string"/>
<xsd:element name="cantidad" type="xsd:int"/>
<xsd:element name="precio" type="xsd:double"/>
</xsd:all>
</xsd:complexType>

<xsd:complexType name="listaItemsFactura">
<xsd:sequence>
<xsd:element name="item" maxOccurs="unbounded" type="tns:itemFactura"/>
</xsd:sequence>
</xsd:complexType>

</xsd:schema>
</code>

==Creación del proyecto==
Recordemos que para crear objetos y/o modificarlos en [[AquaLogic]] se debe crear una sesión y luego activar la misma para que los cambios tengan efecto.

Desde la consola de aqualogic, en el Project Explorer creamos un proyecto llamado
"demoFactura":

[[Image:Aqualogic_demoFactura_1.jpg | 750px ]]

Para ser ordenados, dentro del proyecto demoFactura creamos una carpeta “envío de facturas”, donde crearemos todos los recursos de esta demo.

[[Image:Aqualogic_demoFactura_2.jpg | 750px ]]

== Agregamos el Esquema XML (XSD) ==

Para subir el esquema XML al AquaLogic, dentro de nuestra carpeta elegimos la opción XML Schema en el combo “Create Resource:”

[[Image:Aqualogic_demoFactura_3.jpg ]]

Le ponemos un nombre al recurso que estamos creando y cargamos el archivo de definición de una factura.

[[Image:Aqualogic_demoFactura_4.jpg | 750px ]]

Después de hacer click en Save vemos que tenemos el archivo xsd cargado correctamente:

[[Image:Aqualogic_demoFactura_5.jpg | 750px ]]

== Agregamos el WSDL ==
Para cargar el wsdl seguimos los mismos pasos que en el apartado anterior, eligiendo en el combo “Create Resource:” la opción WSDL.

Después de dar un nombre al recurso, cargar el archivo .wsdl y guardar los cambios tendremos:

[[Image:Aqualogic_demoFactura_6.jpg | 750px ]]

== Creamos un Business Service ==
El business service será el responsable de enviar el mensaje a la queue. Si elegimos la opción “Business Service” del combo “Create Resource” ingresamos al wizard para configurar este servicio.
En el primer paso damos un nombre al servicio e indicamos que es de tipo “Messaging Service”.

[[Image:Aqualogic_demoFactura_7.jpg | 750px ]]

Seteamos request y response como texto:

[[Image:Aqualogic_demoFactura_8.jpg | 750px ]]

Marcamos que se utilizará el protocolo jms y agregamos con el botón Add los destinos del mensaje. El formato de las uri es jms://<host>:<puerto>/<jndi-connection-factory>/<jndi-queue> (Si nuestros jndi contienen “/”, las escapeamos con “.”)

[[Image:Aqualogic_demoFactura_9.jpg | 750px ]]

Indicamos que el destinatario es una queue y que se enviará un text message.

[[Image:Aqualogic_demoFactura_10.jpg | 750px ]]

En el último paso del wizard verificamos toda la información ingresada y guardamos los cambios. Entonces ya podemos probar el bussinessService mediante el ícono de “Launch Test Console”:

[[Image:Aqualogic_demoFactura_11.jpg | 750px ]]

Escribimos el texto que viajará en el mensaje y presionamos el botón Execute:

[[Image:Aqualogic_demoFactura_12.jpg | 750px ]]

El servicio termina correctamente y podemos ver que nuestra queue ha recibido un mensaje con el texto ingresado.

== Creamos un Proxy Service ==
El Proxy service nos permitirá exponer el servicio para ser invocado vía http. Ingresamos al wizard de configuración eligiendo la opción “Proxy Service” en el combo “Create Resource”.
Ponemos un nombre al servicio e indicamos que lo vamos a crear a partir de nuestro wsdl, el cual elegimos mediante el botón Browse:

[[Image:Aqualogic_demoFactura_13.jpg | 750px ]]

Marcamos que podrá ser consumido mediante el protocolo http y definimos la url de invocación:

[[Image:Aqualogic_demoFactura_14.jpg | 750px ]]

Dejamos todas las opciones por defecto hasta que termina el wizard y activamos los cambios.

Ahora hay que asociar el Proxy a nuestro business service. Para eso editamos el flujo del mensaje:

[[Image:Aqualogic_demoFactura_15.jpg | 750px ]]

Y definimos un ruteo:

[[Image:Aqualogic_demoFactura_16.jpg | 750px ]]
[[Image:Aqualogic_demoFactura_17.jpg | 750px ]]
[[Image:Aqualogic_demoFactura_18.jpg | 750px ]]

Click en el link <service> para buscar nuestro business service y que nos quede así:

[[Image:Aqualogic_demoFactura_19.jpg | 750px ]]

Guardamos los cambios y probamos nuestro Proxy con el ícono de “Launch Test Console”, como hicimos antes con el business service.

[[Image:Aqualogic_demoFactura_20.jpg | 750px ]]

Ejecutado ese request podemos ver que el mensaje completo llegó a la queue correctamente.

== Agregamos el JMSType al mensaje ==

Vamos a editar el routeo entre el proxy y el business service para agregar el JMSType del mensaje que se encola:

[[Image:Aqualogic_demoFactura_21.jpg | 750px ]]

Presionamos Add header y seleccionamos en el combo la opción JMSType:

[[Image:Aqualogic_demoFactura_22.jpg | 750px ]]

Editamos el link <Expression> con el jmsType deseado, en este caso ‘facturaType’. Activamos los cambios y si probamos de nuevo el Proxy vemos que el mensaje se encola con el type indicado.

[[Image:Aqualogic_demoFactura_23.jpg | 750px ]]

== Validamos el mensaje contra el esquema xml ==

Si probamos sacando del request el tag numeroFactura, que es requerido según el .xsd, vemos que la petición no falla. Esto se debe a que debemos indicar a aqualogic explícitamente que valide la petición contra el esquema XML.
Para eso editamos el routeo de nuevo y en primer lugar, creamos una variable:

[[Image:Aqualogic_demoFactura_24.JPG | 750px ]]

A la variable le ponemos como nombre facturaSoapRequest. En la edición del link <expression> podemos navegar en “Variable Structures” buscando la parte del mensaje que se quiere asignar a la variable, en este caso la factura dentro del apartado body del request.

[[Image:Aqualogic_demoFactura_25.JPG | 550px ]]

Y (como no se puede hacer drag and drop) copiamos la expresión desde el property inspector:

[[Image:Aqualogic_demoFactura_26.JPG | 550px ]]

Ahora agregamos la acción de validación propiamente dicha. Lo que hacemos es indicar que verifique el contenido de la variable que definimos recién contra el esquema xml.

[[Image:Aqualogic_demoFactura_27.JPG | 750px ]]

En variable ponemos la que definimos recién, facturaSoapRequest, y en <resource> buscamos nuestro xsd.
Además, elegimos la opción de que lance un fault en caso de que el mensaje no se corresponda con el esquema y nos queda así:

[[Image:Aqualogic_demoFactura_28.JPG | 750px ]]

Guardamos los cambios y probando el Proxy verificamos que si no le pasamos el tag numeroFactura la respuesta es:
<code xml>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server</faultcode>
<faultstring>
BEA-382505: ALSB Validate action failed validation
</faultstring>
<detail>
<con:fault xmlns:con="http://www.bea.com/wli/sb/context">
<con:errorCode>BEA-382505</con:errorCode>
<con:reason>ALSB Validate action failed validation</con:reason>
<con:details>
<con1:ValidationFailureDetail
xmlns:con1="http://www.bea.com/wli/sb/stages/transform/config">
<con1:message>
Expected element
'numeroFactura@http://xml.netbeans.org/schema/facturaXmlSchema'
instead of
'fecha@http://xml.netbeans.org/schema/facturaXmlSchema'
here in element factura@http://xml.netbeans.org/schema/facturaXmlSchema
</con1:message>
…
…
</code>

== Agregamos otras validaciones ==

Vamos a agregar como ejemplo, que el Proxy verifique que el número de la factura no supere los 8 caracteres. Para ello editamos el ruteo nuevamente y si creamos una acción

[[Image:Aqualogic_demoFactura_29.JPG | 750px ]]

Nos agrega:

[[Image:Aqualogic_demoFactura_30.JPG | 250px ]]

Editamos el link <condition> buscando variables y funciones de x-query (y siempre copiando del property inspector) hasta que tengamos la siguiente expresión:

[[Image:Aqualogic_demoFactura_31.JPG | 550px ]]

Y en Add action agregamos un fault:

[[Image:Aqualogic_demoFactura_32.JPG | 750px ]]

Completamos el código y mensaje para el error:

[[Image:Aqualogic_demoFactura_33.JPG | 550px ]]

Activamos los cambios y verificamos el fault cuando invocamos al servicio con un número de factura mayor a 8 caracteres:

[[Image:Aqualogic_demoFactura_34.JPG | 550px ]]

Colas De Mensajes Con AquaLogic

2009-07-21T14:52:45Z

Ale holman: /* Validamos el mensaje contra el esquema xml */

Vamos a exponer con [[AquaLogic]] un [[Web Service]] que nos permita enviar un mensaje a una cola de mensajería. Partimos de un [[WSDL]] en donde definimos una operación “enviarFactura” que recibe como parámetro un elemento de tipo factura. Los elementos y tipos de dato de una factura se encuentran definidos en el esquema xml asociado al [[WSDL]].

==La definición del servicio==
===Wsdl===
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<definitions name="facturaWsdl" targetNamespace="http://j2ee.netbeans.org/wsdl/facturaWsdl"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://j2ee.netbeans.org/wsdl/facturaWsdl"
xmlns:ns="http://xml.netbeans.org/schema/facturaXmlSchema"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<types>
<xsd:schema targetNamespace="http://j2ee.netbeans.org/wsdl/facturaWsdl">
<xsd:import namespace="http://xml.netbeans.org/schema/facturaXmlSchema"
schemaLocation="../schema/facturaXmlSchema.xsd"/>
</xsd:schema>
</types>
<message name="enviarFacturaRequest">
<part name="part1" element="ns:factura"/>
</message>
<message name="enviarFacturaResponse"/>
<portType name="facturaWsdlPortType">
<operation name="enviarFactura">
<input name="input1" message="tns:enviarFacturaRequest"/>
<output name="output1" message="tns:enviarFacturaResponse"/>
</operation>
</portType>
<binding name="facturaWsdlBinding" type="tns:facturaWsdlPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="enviarFactura">
<soap:operation/>
<input name="input1">
<soap:body use="literal"/>
</input>
<output name="output1">
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="facturaWsdlService">
<port name="facturaWsdlPort" binding="tns:facturaWsdlBinding">
<soap:address
location="http://localhost:${HttpDefaultPort}/facturaWsdlService/facturaWsdlPort"/>
</port>
</service>
</definitions>
</code>

===El Esquema XML (XSD)===
<code xml>
<?xml version="1.0" encoding="UTF-8"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://xml.netbeans.org/schema/facturaXmlSchema"
xmlns:tns="http://xml.netbeans.org/schema/facturaXmlSchema"
elementFormDefault="qualified">

<xsd:element name="factura">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="numeroFactura" type="xsd:string"/>
<xsd:element name="fecha" type="xsd:string"/>
<xsd:element name="items" type="tns:listaItemsFactura"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>

<xsd:complexType name="itemFactura">
<xsd:all>
<xsd:element name="codigoArticulo" type="xsd:string"/>
<xsd:element name="descripcion" minOccurs="0" type="xsd:string"/>
<xsd:element name="cantidad" type="xsd:int"/>
<xsd:element name="precio" type="xsd:double"/>
</xsd:all>
</xsd:complexType>

<xsd:complexType name="listaItemsFactura">
<xsd:sequence>
<xsd:element name="item" maxOccurs="unbounded" type="tns:itemFactura"/>
</xsd:sequence>
</xsd:complexType>

</xsd:schema>
</code>

==Creación del proyecto==
Recordemos que para crear objetos y/o modificarlos en [[AquaLogic]] se debe crear una sesión y luego activar la misma para que los cambios tengan efecto.

Desde la consola de aqualogic, en el Project Explorer creamos un proyecto llamado
"demoFactura":

[[Image:Aqualogic_demoFactura_1.jpg | 750px ]]

Para ser ordenados, dentro del proyecto demoFactura creamos una carpeta “envío de facturas”, donde crearemos todos los recursos de esta demo.

[[Image:Aqualogic_demoFactura_2.jpg | 750px ]]

== Agregamos el Esquema XML (XSD) ==

Para subir el esquema XML al AquaLogic, dentro de nuestra carpeta elegimos la opción XML Schema en el combo “Create Resource:”

[[Image:Aqualogic_demoFactura_3.jpg ]]

Le ponemos un nombre al recurso que estamos creando y cargamos el archivo de definición de una factura.

[[Image:Aqualogic_demoFactura_4.jpg | 750px ]]

Después de hacer click en Save vemos que tenemos el archivo xsd cargado correctamente:

[[Image:Aqualogic_demoFactura_5.jpg | 750px ]]

== Agregamos el WSDL ==
Para cargar el wsdl seguimos los mismos pasos que en el apartado anterior, eligiendo en el combo “Create Resource:” la opción WSDL.

Después de dar un nombre al recurso, cargar el archivo .wsdl y guardar los cambios tendremos:

[[Image:Aqualogic_demoFactura_6.jpg | 750px ]]

== Creamos un Business Service ==
El business service será el responsable de enviar el mensaje a la queue. Si elegimos la opción “Business Service” del combo “Create Resource” ingresamos al wizard para configurar este servicio.
En el primer paso damos un nombre al servicio e indicamos que es de tipo “Messaging Service”.

[[Image:Aqualogic_demoFactura_7.jpg | 750px ]]

Seteamos request y response como texto:

[[Image:Aqualogic_demoFactura_8.jpg | 750px ]]

Marcamos que se utilizará el protocolo jms y agregamos con el botón Add los destinos del mensaje. El formato de las uri es jms://<host>:<puerto>/<jndi-connection-factory>/<jndi-queue> (Si nuestros jndi contienen “/”, las escapeamos con “.”)

[[Image:Aqualogic_demoFactura_9.jpg | 750px ]]

Indicamos que el destinatario es una queue y que se enviará un text message.

[[Image:Aqualogic_demoFactura_10.jpg | 750px ]]

En el último paso del wizard verificamos toda la información ingresada y guardamos los cambios. Entonces ya podemos probar el bussinessService mediante el ícono de “Launch Test Console”:

[[Image:Aqualogic_demoFactura_11.jpg | 750px ]]

Escribimos el texto que viajará en el mensaje y presionamos el botón Execute:

[[Image:Aqualogic_demoFactura_12.jpg | 750px ]]

El servicio termina correctamente y podemos ver que nuestra queue ha recibido un mensaje con el texto ingresado.

== Creamos un Proxy Service ==
El Proxy service nos permitirá exponer el servicio para ser invocado vía http. Ingresamos al wizard de configuración eligiendo la opción “Proxy Service” en el combo “Create Resource”.
Ponemos un nombre al servicio e indicamos que lo vamos a crear a partir de nuestro wsdl, el cual elegimos mediante el botón Browse:

[[Image:Aqualogic_demoFactura_13.jpg | 750px ]]

Marcamos que podrá ser consumido mediante el protocolo http y definimos la url de invocación:

[[Image:Aqualogic_demoFactura_14.jpg | 750px ]]

Dejamos todas las opciones por defecto hasta que termina el wizard y activamos los cambios.

Ahora hay que asociar el Proxy a nuestro business service. Para eso editamos el flujo del mensaje:

[[Image:Aqualogic_demoFactura_15.jpg | 750px ]]

Y definimos un ruteo:

[[Image:Aqualogic_demoFactura_16.jpg | 750px ]]
[[Image:Aqualogic_demoFactura_17.jpg | 750px ]]
[[Image:Aqualogic_demoFactura_18.jpg | 750px ]]

Click en el link <service> para buscar nuestro business service y que nos quede así:

[[Image:Aqualogic_demoFactura_19.jpg | 750px ]]

Guardamos los cambios y probamos nuestro Proxy con el ícono de “Launch Test Console”, como hicimos antes con el business service.

[[Image:Aqualogic_demoFactura_20.jpg | 750px ]]

Ejecutado ese request podemos ver que el mensaje completo llegó a la queue correctamente.

== Agregamos el JMSType al mensaje ==

Vamos a editar el routeo entre el proxy y el business service para agregar el JMSType del mensaje que se encola:

[[Image:Aqualogic_demoFactura_21.jpg | 750px ]]

Presionamos Add header y seleccionamos en el combo la opción JMSType:

[[Image:Aqualogic_demoFactura_22.jpg | 750px ]]

Editamos el link <Expression> con el jmsType deseado, en este caso ‘facturaType’. Activamos los cambios y si probamos de nuevo el Proxy vemos que el mensaje se encola con el type indicado.

[[Image:Aqualogic_demoFactura_23.jpg | 750px ]]

== Validamos el mensaje contra el esquema xml ==

Si probamos sacando del request el tag numeroFactura, que es requerido según el .xsd, vemos que la petición no falla. Esto se debe a que debemos indicar a aqualogic explícitamente que valide la petición contra el esquema XML.
Para eso editamos el routeo de nuevo y en primer lugar, creamos una variable:

[[Image:Aqualogic_demoFactura_24.JPG | 750px ]]

A la variable le ponemos como nombre facturaSoapRequest. En la edición del link <expression> podemos navegar en “Variable Structures” buscando la parte del mensaje que se quiere asignar a la variable, en este caso la factura dentro del apartado body del request.

[[Image:Aqualogic_demoFactura_25.JPG | 550px ]]

Y (como no se puede hacer drag and drop) copiamos la expresión desde el property inspector:

[[Image:Aqualogic_demoFactura_26.JPG | 550px ]]

Ahora agregamos la acción de validación propiamente dicha. Lo que hacemos es indicar que verifique el contenido de la variable que definimos recién contra el esquema xml.

[[Image:Aqualogic_demoFactura_27.JPG | 750px ]]

En variable ponemos la que definimos recién, facturaSoapRequest, y en <resource> buscamos nuestro xsd.
Además, elegimos la opción de que lance un fault en caso de que el mensaje no se corresponda con el esquema y nos queda así:

[[Image:Aqualogic_demoFactura_28.JPG | 750px ]]

Guardamos los cambios y probando el Proxy verificamos que si no le pasamos el tag numeroFactura la respuesta es:
<code xml>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server</faultcode>
<faultstring>
BEA-382505: ALSB Validate action failed validation
</faultstring>
<detail>
<con:fault xmlns:con="http://www.bea.com/wli/sb/context">
<con:errorCode>BEA-382505</con:errorCode>
<con:reason>ALSB Validate action failed validation</con:reason>
<con:details>
<con1:ValidationFailureDetail
xmlns:con1="http://www.bea.com/wli/sb/stages/transform/config">
<con1:message>
Expected element
'numeroFactura@http://xml.netbeans.org/schema/facturaXmlSchema'
instead of
'fecha@http://xml.netbeans.org/schema/facturaXmlSchema'
here in element factura@http://xml.netbeans.org/schema/facturaXmlSchema
</con1:message>
…
…
</code>

== Agregamos otras validaciones ==

Vamos a agregar como ejemplo, que el Proxy verifique que el número de la factura no supere los 8 caracteres. Para ello editamos el ruteo nuevamente y si creamos una acción

[[Image:Aqualogic_demoFactura_29.JPG | 750px ]]

Nos agrega:

[[Image:Aqualogic_demoFactura_30.JPG | 750px ]]

Editamos el link <condition> buscando variables y funciones de x-query (y siempre copiando del property inspector) hasta que tengamos la siguiente expresión:

[[Image:Aqualogic_demoFactura_31.JPG | 750px ]]

Y en Add action agregamos un fault:

[[Image:Aqualogic_demoFactura_32.JPG | 750px ]]

Completamos el código y mensaje para el error:

[[Image:Aqualogic_demoFactura_33.JPG | 750px ]]

Activamos los cambios y verificamos el fault cuando invocamos al servicio con un número de factura mayor a 8 caracteres:

[[Image:Aqualogic_demoFactura_34.JPG | 750px ]]

Colas De Mensajes Con AquaLogic

2009-07-21T14:51:18Z

Ale holman: /* Validamos el mensaje contra el esquema xml */

Vamos a exponer con [[AquaLogic]] un [[Web Service]] que nos permita enviar un mensaje a una cola de mensajería. Partimos de un [[WSDL]] en donde definimos una operación “enviarFactura” que recibe como parámetro un elemento de tipo factura. Los elementos y tipos de dato de una factura se encuentran definidos en el esquema xml asociado al [[WSDL]].

==La definición del servicio==
===Wsdl===
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<definitions name="facturaWsdl" targetNamespace="http://j2ee.netbeans.org/wsdl/facturaWsdl"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://j2ee.netbeans.org/wsdl/facturaWsdl"
xmlns:ns="http://xml.netbeans.org/schema/facturaXmlSchema"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<types>
<xsd:schema targetNamespace="http://j2ee.netbeans.org/wsdl/facturaWsdl">
<xsd:import namespace="http://xml.netbeans.org/schema/facturaXmlSchema"
schemaLocation="../schema/facturaXmlSchema.xsd"/>
</xsd:schema>
</types>
<message name="enviarFacturaRequest">
<part name="part1" element="ns:factura"/>
</message>
<message name="enviarFacturaResponse"/>
<portType name="facturaWsdlPortType">
<operation name="enviarFactura">
<input name="input1" message="tns:enviarFacturaRequest"/>
<output name="output1" message="tns:enviarFacturaResponse"/>
</operation>
</portType>
<binding name="facturaWsdlBinding" type="tns:facturaWsdlPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="enviarFactura">
<soap:operation/>
<input name="input1">
<soap:body use="literal"/>
</input>
<output name="output1">
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="facturaWsdlService">
<port name="facturaWsdlPort" binding="tns:facturaWsdlBinding">
<soap:address
location="http://localhost:${HttpDefaultPort}/facturaWsdlService/facturaWsdlPort"/>
</port>
</service>
</definitions>
</code>

===El Esquema XML (XSD)===
<code xml>
<?xml version="1.0" encoding="UTF-8"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://xml.netbeans.org/schema/facturaXmlSchema"
xmlns:tns="http://xml.netbeans.org/schema/facturaXmlSchema"
elementFormDefault="qualified">

<xsd:element name="factura">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="numeroFactura" type="xsd:string"/>
<xsd:element name="fecha" type="xsd:string"/>
<xsd:element name="items" type="tns:listaItemsFactura"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>

<xsd:complexType name="itemFactura">
<xsd:all>
<xsd:element name="codigoArticulo" type="xsd:string"/>
<xsd:element name="descripcion" minOccurs="0" type="xsd:string"/>
<xsd:element name="cantidad" type="xsd:int"/>
<xsd:element name="precio" type="xsd:double"/>
</xsd:all>
</xsd:complexType>

<xsd:complexType name="listaItemsFactura">
<xsd:sequence>
<xsd:element name="item" maxOccurs="unbounded" type="tns:itemFactura"/>
</xsd:sequence>
</xsd:complexType>

</xsd:schema>
</code>

==Creación del proyecto==
Recordemos que para crear objetos y/o modificarlos en [[AquaLogic]] se debe crear una sesión y luego activar la misma para que los cambios tengan efecto.

Desde la consola de aqualogic, en el Project Explorer creamos un proyecto llamado
"demoFactura":

[[Image:Aqualogic_demoFactura_1.jpg | 750px ]]

Para ser ordenados, dentro del proyecto demoFactura creamos una carpeta “envío de facturas”, donde crearemos todos los recursos de esta demo.

[[Image:Aqualogic_demoFactura_2.jpg | 750px ]]

== Agregamos el Esquema XML (XSD) ==

Para subir el esquema XML al AquaLogic, dentro de nuestra carpeta elegimos la opción XML Schema en el combo “Create Resource:”

[[Image:Aqualogic_demoFactura_3.jpg ]]

Le ponemos un nombre al recurso que estamos creando y cargamos el archivo de definición de una factura.

[[Image:Aqualogic_demoFactura_4.jpg | 750px ]]

Después de hacer click en Save vemos que tenemos el archivo xsd cargado correctamente:

[[Image:Aqualogic_demoFactura_5.jpg | 750px ]]

== Agregamos el WSDL ==
Para cargar el wsdl seguimos los mismos pasos que en el apartado anterior, eligiendo en el combo “Create Resource:” la opción WSDL.

Después de dar un nombre al recurso, cargar el archivo .wsdl y guardar los cambios tendremos:

[[Image:Aqualogic_demoFactura_6.jpg | 750px ]]

== Creamos un Business Service ==
El business service será el responsable de enviar el mensaje a la queue. Si elegimos la opción “Business Service” del combo “Create Resource” ingresamos al wizard para configurar este servicio.
En el primer paso damos un nombre al servicio e indicamos que es de tipo “Messaging Service”.

[[Image:Aqualogic_demoFactura_7.jpg | 750px ]]

Seteamos request y response como texto:

[[Image:Aqualogic_demoFactura_8.jpg | 750px ]]

Marcamos que se utilizará el protocolo jms y agregamos con el botón Add los destinos del mensaje. El formato de las uri es jms://<host>:<puerto>/<jndi-connection-factory>/<jndi-queue> (Si nuestros jndi contienen “/”, las escapeamos con “.”)

[[Image:Aqualogic_demoFactura_9.jpg | 750px ]]

Indicamos que el destinatario es una queue y que se enviará un text message.

[[Image:Aqualogic_demoFactura_10.jpg | 750px ]]

En el último paso del wizard verificamos toda la información ingresada y guardamos los cambios. Entonces ya podemos probar el bussinessService mediante el ícono de “Launch Test Console”:

[[Image:Aqualogic_demoFactura_11.jpg | 750px ]]

Escribimos el texto que viajará en el mensaje y presionamos el botón Execute:

[[Image:Aqualogic_demoFactura_12.jpg | 750px ]]

El servicio termina correctamente y podemos ver que nuestra queue ha recibido un mensaje con el texto ingresado.

== Creamos un Proxy Service ==
El Proxy service nos permitirá exponer el servicio para ser invocado vía http. Ingresamos al wizard de configuración eligiendo la opción “Proxy Service” en el combo “Create Resource”.
Ponemos un nombre al servicio e indicamos que lo vamos a crear a partir de nuestro wsdl, el cual elegimos mediante el botón Browse:

[[Image:Aqualogic_demoFactura_13.jpg | 750px ]]

Marcamos que podrá ser consumido mediante el protocolo http y definimos la url de invocación:

[[Image:Aqualogic_demoFactura_14.jpg | 750px ]]

Dejamos todas las opciones por defecto hasta que termina el wizard y activamos los cambios.

Ahora hay que asociar el Proxy a nuestro business service. Para eso editamos el flujo del mensaje:

[[Image:Aqualogic_demoFactura_15.jpg | 750px ]]

Y definimos un ruteo:

[[Image:Aqualogic_demoFactura_16.jpg | 750px ]]
[[Image:Aqualogic_demoFactura_17.jpg | 750px ]]
[[Image:Aqualogic_demoFactura_18.jpg | 750px ]]

Click en el link <service> para buscar nuestro business service y que nos quede así:

[[Image:Aqualogic_demoFactura_19.jpg | 750px ]]

Guardamos los cambios y probamos nuestro Proxy con el ícono de “Launch Test Console”, como hicimos antes con el business service.

[[Image:Aqualogic_demoFactura_20.jpg | 750px ]]

Ejecutado ese request podemos ver que el mensaje completo llegó a la queue correctamente.

== Agregamos el JMSType al mensaje ==

Vamos a editar el routeo entre el proxy y el business service para agregar el JMSType del mensaje que se encola:

[[Image:Aqualogic_demoFactura_21.jpg | 750px ]]

Presionamos Add header y seleccionamos en el combo la opción JMSType:

[[Image:Aqualogic_demoFactura_22.jpg | 750px ]]

Editamos el link <Expression> con el jmsType deseado, en este caso ‘facturaType’. Activamos los cambios y si probamos de nuevo el Proxy vemos que el mensaje se encola con el type indicado.

[[Image:Aqualogic_demoFactura_23.jpg | 750px ]]

== Validamos el mensaje contra el esquema xml ==

Si probamos sacando del request el tag numeroFactura, que es requerido según el .xsd, vemos que la petición no falla. Esto se debe a que debemos indicar a aqualogic explícitamente que valide la petición contra el esquema XML.
Para eso editamos el routeo de nuevo y en primer lugar, creamos una variable:

[[Image:Aqualogic_demoFactura_24.JPG | 750px ]]

A la variable le ponemos como nombre facturaSoapRequest. En la edición del link <expression> podemos navegar en “Variable Structures” buscando la parte del mensaje que se quiere asignar a la variable, en este caso la factura dentro del apartado body del request.

[[Image:Aqualogic_demoFactura_25.JPG | 750px ]]

Y (como no se puede hacer drag and drop) copiamos la expresión desde el property inspector:

[[Image:Aqualogic_demoFactura_26.JPG | 750px ]]

Ahora agregamos la acción de validación propiamente dicha. Lo que hacemos es indicar que verifique el contenido de la variable que definimos recién contra el esquema xml.

[[Image:Aqualogic_demoFactura_27.JPG | 750px ]]

En variable ponemos la que definimos recién, facturaSoapRequest, y en <resource> buscamos nuestro xsd.
Además, elegimos la opción de que lance un fault en caso de que el mensaje no se corresponda con el esquema y nos queda así:

[[Image:Aqualogic_demoFactura_28.JPG | 750px ]]

Guardamos los cambios y probando el Proxy verificamos que si no le pasamos el tag numeroFactura la respuesta es:
<code xml>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server</faultcode>
<faultstring>
BEA-382505: ALSB Validate action failed validation
</faultstring>
<detail>
<con:fault xmlns:con="http://www.bea.com/wli/sb/context">
<con:errorCode>BEA-382505</con:errorCode>
<con:reason>ALSB Validate action failed validation</con:reason>
<con:details>
<con1:ValidationFailureDetail
xmlns:con1="http://www.bea.com/wli/sb/stages/transform/config">
<con1:message>
Expected element
'numeroFactura@http://xml.netbeans.org/schema/facturaXmlSchema'
instead of
'fecha@http://xml.netbeans.org/schema/facturaXmlSchema'
here in element factura@http://xml.netbeans.org/schema/facturaXmlSchema
</con1:message>
…
…
</code>

== Agregamos otras validaciones ==

Vamos a agregar como ejemplo, que el Proxy verifique que el número de la factura no supere los 8 caracteres. Para ello editamos el ruteo nuevamente y si creamos una acción

[[Image:Aqualogic_demoFactura_29.JPG | 750px ]]

Nos agrega:

[[Image:Aqualogic_demoFactura_30.JPG | 750px ]]

Editamos el link <condition> buscando variables y funciones de x-query (y siempre copiando del property inspector) hasta que tengamos la siguiente expresión:

[[Image:Aqualogic_demoFactura_31.JPG | 750px ]]

Y en Add action agregamos un fault:

[[Image:Aqualogic_demoFactura_32.JPG | 750px ]]

Completamos el código y mensaje para el error:

[[Image:Aqualogic_demoFactura_33.JPG | 750px ]]

Activamos los cambios y verificamos el fault cuando invocamos al servicio con un número de factura mayor a 8 caracteres:

[[Image:Aqualogic_demoFactura_34.JPG | 750px ]]