PDF de programación - gvNIX - Documentación de referencia 1.0.0

gvNIX - Documentación de referencia

1.0.0-RELEASE

Copyright © 2009, 2013

Copyright 2010 - 2013 Consejería de Infraestructuras, Transporte y Medio Ambiende - Generalidad

Valenciana Esta obra está bajo la licencia Reconocimiento-Compartir bajo la misma licencia 3.0 España
http://creativecommons.org/licenses/by-sa/3.0/es/ de Creative Commons. Puede copiarla, distribuirla y

comunicarla públicamente siempre que especifique sus autores y comparta cualquier obra derivada bajo la

misma licencia. La licencia completa se puede consultar en http://creativecommons.org/licenses/by-sa/3.0/es/

I. Primeros pasos con gvNIX .... 1

1. Introducción .... 2

1.1. ¿Qué es gvNIX? .... 2
1.2. ¿Qué es Spring Roo? .... 2
1.3. ¿Qué ofrece gvNIX? .... 3
1.4. Arquitectura .... 3
1.5. El intérprete de comandos .... 4
1.6. ¿Cómo funciona? .... 5
1.7. Generación de código .... 6

2. Instalación de gvNIX .... 7

2.1. Requisitos previos .... 7

2.1.1. Configuración del entorno .... 7
2.1.2. Acceso a través de un proxy .... 8

2.2. Descarga e instalación de gvNIX .... 9

3. Desarrollo con Eclipse .... 12

3.1. Instalación .... 12

3.1.1. STS como distribución .... 12
3.1.2. STS como plugin .... 12

3.2. Consola gvNIX / Roo integrada en Eclipse .... 13
3.3. Utilizar Eclipse como IDE .... 14

3.3.1. Crear proyecto gvNIX en Eclipse IDE .... 14
3.3.2. Importar proyecto gvNIX en Eclipse .... 16

3.4. Generación de pruebas de integración .... 17
3.5. Arrancar la aplicación con Eclipse .... 17

3.5.1. Mostrar la Vista de Servidores en Eclipse .... 17
3.5.2. Crear un nuevo Servidor .... 17
3.5.3. Ajustar la configuración del Servidor .... 18
3.5.4. Ejecución de la aplicación en el Servidor .... 19

3.6. Trabajando con el código de la aplicación en Eclipse .... 21

3.6.1. Modificación del código generado .... 22

4. Ejemplos gvNIX/Roo .... 24

II. Desarrollo de aplicaciones con gvNIX .... 26

5. Crear una nueva aplicación .... 27

5.1. Crear un nuevo proyecto .... 27

6. Gestión del acceso a datos .... 29

6.1. Persistencia de objetos .... 29
6.2. Configurar la conexión con la base de datos .... 30

6.2.1. jpa setup .... 30
6.2.2. database properties .... 32
6.2.3. Ejemplo: Conectar con PostgreSQL .... 32
6.2.4. Actualización automática del esquema .... 33
6.2.5. Múltiples fuentes de datos .... 34

7. Código generado por gvNIX/Roo .... 36

7.1. Clases Java y ficheros AJ .... 36

7.1.1. Archivos Java .... 36
7.1.2. Archivos AJ .... 36

8. Gestión de entidades .... 37

8.1. Crear una entidad con el intérprete de comandos .... 38

8.1.1. Comando entity .... 38

1.0.0-RELEASE

ii

gvNIX - Documentación de referencia

8.1.2. Comando field .... 39
8.1.3. Proyecto ejemplo .... 40

8.2. Crear una entidad con un IDE .... 42
8.3. Modificar una entidad .... 42
8.4. Identificadores compuestos .... 43
8.5. Definir características específicas para el modelo relacional .... 44

8.5.1. Definir un nombre de tabla .... 44
8.5.2. Definir un nombre de columna .... 44
8.5.3. Campos calculados .... 45
8.5.4. Clave primaria .... 46
8.5.5. Campo para el control de concurrencia optimista. .... 47
8.5.6. Regeneración de la Base de datos en cada arranque. .... 48
8.5.7. Creación de una nueva entidad sin comandos .... 48

8.6. Ingeniería inversa de entidades .... 49

8.6.1. Instalación del driver JDBC .... 49
8.6.2. Comandos de la ingeniería inversa .... 50
8.6.3. Anotación @RooDbManaged .... 51
8.6.4. Soporte de funcionalidades JPA 2.0 .... 52
8.6.5. Ingeniería inversa multi esquema .... 53
8.6.6. Ingeniería inversa incremental .... 53

9. Buscadores de entidades .... 55

9.1. Descripción .... 55
9.2. Listar buscadores .... 55
9.3. Creación de un buscador .... 55
9.4. Código generado .... 56
10. Pruebas de integración .... 58

10.1. Creación de pruebas de integración .... 58

11. Gestión de la capa web .... 59

11.1. Crear la capa web con el intérprete de comandos .... 59

11.1.1. web mvc setup .... 59
11.1.2. web mvc scaffold .... 59
11.1.3. web mvc all .... 60
11.1.4. web mvc controller .... 60
11.1.5. Proyecto ejemplo .... 61

11.2. Crear la capa web con un IDE .... 61
11.2.1. Controlador a medida .... 62
11.2.2. Controlador CRUD .... 62
11.2.3. Código generado en las vistas de la capa web .... 63

11.3. Visualización de entidades en la capa web .... 67

12. Buscadores en la capa web .... 68

12.1. Descripción .... 68
12.2. Creación de buscadores .... 68
12.3. Código generado .... 68

13. Arranque y pruebas de la aplicación web .... 70

13.1. Pruebas funcionales .... 70
13.2. Arrancar la aplicación web .... 70
13.3. Ejecutar los tests funcionales .... 70

III. Desarrollo avanzado con gvNIX .... 72
14. Add-on Theme Manager .... 73

1.0.0-RELEASE

iii

gvNIX - Documentación de referencia

14.1. Descripción .... 73
14.2. Temas disponibles por defecto. .... 73
14.3. Futuras versiones .... 74

15. Add-on Web Menu .... 75
15.1. Descripción .... 75
15.2. Definiciones .... 75
15.3. Instalación de la gestión del menú .... 76
15.4. Modificación del menú. .... 76
15.5. Futuras versiones .... 77

16. Add-on Web Screen Patterns .... 78

16.1. Descripción .... 78
16.2. Instalación .... 78
16.3. Creación de un patrón .... 79

16.3.1. Creación de un patrón maestro .... 80
16.3.2. Creación de un patrón detalle .... 80

16.4. Tipos de patrones .... 81

16.4.1. Tabular .... 81
16.4.2. Registro .... 81

17. Add-on OCC (Optimistic Concurrency Control) .... 83

17.1. Introducción .... 83
17.2. Añadir el control en las entidades .... 83

18. Add-on Web Dialog .... 86

18.1. Descripción .... 86
18.2. Instalación .... 86
18.3. Excepciones controladas por gvNIX .... 86

18.3.1. Añadir nuevas excepciones a la gestión .... 87

18.4. Nuevos diálogos modales .... 88

18.4.1. Ejemplos de dialogos personalizados .... 89

18.5. Futuras versiones .... 92

19. Add-on CIT Security .... 93

19.1. Descripción .... 93

20. Add-on Web Report .... 95

20.1. Descripción .... 95
20.2. Instalación .... 95
20.3. Generación de un informe .... 97
20.4. Futuras versiones .... 99

21. Add-on Service .... 100

21.1. Descripción .... 100
21.2. Creación de servicios locales .... 100
21.3. Creación de servidores desde Java .... 101
21.4. Creación de servidores desde WSDL .... 102
21.5. Creación de clientes .... 103
21.6. Acceso a un WSDL en un servidor seguro .... 104

21.6.1. Creación de clientes con firma .... 105

21.7. Listar los servicios .... 106
22. Add-on Web MVC i18n .... 107

22.1. Descripción .... 107
22.2. Instalación de un idioma .... 107
22.3. Futuras versiones .... 107

1.0.0-RELEASE

iv

gvNIX - Documentación de referencia

23. Add-on Dynamic Configuration .... 108

23.1. Descripción .... 108
23.2. Funcionalidad .... 108
23.3. Futuras versiones .... 111

24. Add-on Web MVC Binding .... 112

24.1. Descripción .... 112
24.2. Futuras versiones .... 113

IV. Recetas de desarrollo .... 114

25. Recetas .... 115

25.1. Repositorios Maven .... 115
25.2. Desarrollo de buscadores con gran cantidad de campos .... 115
25.3. Campos opcionales en los buscadores .... 116
25.4. Instalar fuentes de letra para los informes .... 118
25.5. Diseño de informes con sub informes .... 119

V. Apéndices .... 127

26. Apéndice de comandos de gvNIX .... 128
26.1. Comandos del add-on OCC .... 128

26.1.1. occ checksum set .... 128
26.1.2. occ checksum all .... 128

26.2. Comandos del add-on Theme Manager .... 129

26.2.1. theme install .... 129
26.2.2. theme set .... 129
26.2.3. theme list .... 130

26.3. Comandos del add-on Web Dialog .... 130

26.3.1. web mvc dialog setup .... 131
26.3.2. web mvc dialog exception list .... 131
26.3.3. web mvc dialog exception add .... 132
26.3.4. web mvc dialog exception set language .... 132
26.3.5. web mvc dialog exception remove .... 133
26.3.6. web mvc dialog add .... 133

26.4. Comandos del add-on Web Menu .... 133

26.4.1. menu setup .... 134
26.4.2. menu entry add .... 134
26.4.3. menu entry visibility .... 135
26.4.4. menu entry roles .... 135
26.4.5. menu entry move .... 136
26.4.6. menu entry update .... 136
26.4.7. menu entry info .... 137
26.4.8. menu tree .... 138

26.5. Comandos del add-on Web Screen Patterns .... 139

26.5.1. web mvc pattern install .... 139
26.5.2. web mvc pattern master .... 139
26.5.3. web mvc pattern detail .... 140

26.6. Comandos del add-on CIT Security .... 141

26.6.1. cit security setup .... 141

26.7. Comandos del add-on Web Report .... 142

26.7.1. web report setup .... 142
26.7.2. web report add .... 142

26.8. Comandos del add-on Service .... 143

1.0.0-RELEASE

v

gvNIX - Documentación de referencia

26.8.1. remote service class .... 143
26.8.2. remote service operation .... 144
26.8.3. remote service define ws .... 144
26.8.4. remote service export operation .... 145
26.8.5. remote service list operation .... 147
26.8.6. remote service export ws .... 147
26.8.7. remote service import ws .... 147
26.8.8. remote service ws list .... 148
26.8.9. remote service security ws .... 148

26.9. Comandos del add-on Web MVC i18n .... 148

26.9.1. web mvc install language .... 149

26.10. Comandos del add-on Dynamic Configuration .... 149

26.10.1. configuration create .... 149
26.10.2. configuration property add .... 150
26.10.3. configuration property value .... 150
26.10.4. configuration property undefined .... 150
26.10.5. configuration list .... 151
26.10.6. configuration export .... 151

26.11. Comandos del add-on Web MVC Binding .... 151

26.11.1. web mvc binding stringTrimmer .... 151

VI. Recursos .... 152

27. Recursos .... 153

27.1. Proyectos relacionados con gvNIX .... 153
27.2. Recursos de Spring Roo .... 153
27.3. Recursos de librerías relacionadas .... 153

1.0.0-RELEASE

vi

Parte I. Primeros pasos con gvNIX

Esta parte de la documentación contiene la información necesaria para entender qué es g