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

gvNIX - Documentación de referencia

1.1.0-RELEASE

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 .... 15

3.3.1. Crear proyecto gvNIX en Eclipse IDE .... 15
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 .... 18
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.1.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 .... 52
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
8.6.7. Ingeniería inversa de vistas .... 54

9. Buscadores de entidades .... 56

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

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

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

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

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

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

11.3. Visualización de entidades en la capa web .... 68
11.4. Mejoras de renimiento .... 68

12. Buscadores en la capa web .... 69

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

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

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

1.1.0-RELEASE

iii

gvNIX - Documentación de referencia

14. Mejoras de rendimiento .... 73

14.1. Descripción .... 73
14.2. Patrones de conversión óptimos en el log .... 73
14.3. Evitar la carga de listas de valores innecesarias .... 73

III. Desarrollo avanzado con gvNIX .... 75
15. Add-on Theme Manager .... 76

15.1. Descripción .... 76
15.2. Temas disponibles por defecto. .... 76
15.3. Futuras versiones .... 77

16. Add-on Web Menu .... 78
16.1. Descripción .... 78
16.2. Definiciones .... 78
16.3. Instalación de la gestión del menú .... 79
16.4. Modificación del menú. .... 79
16.5. Futuras versiones .... 80

17. Add-on Web Screen Patterns .... 81

17.1. Descripción .... 81
17.2. Instalación .... 81
17.3. Creación de un patrón .... 82

17.3.1. Creación de un patrón maestro .... 83
17.3.2. Creación de un patrón detalle .... 84

17.4. Tipos de patrones .... 85

17.4.1. Tabular .... 85
17.4.2. Tabular con edición registro .... 87
17.4.3. Registro .... 89

18. Add-on OCC (Optimistic Concurrency Control) .... 91

18.1. Introducción .... 91
18.2. Añadir el control en las entidades .... 91

19. Add-on Web Dialog .... 94

19.1. Descripción .... 94
19.2. Instalación .... 94
19.3. Excepciones controladas por gvNIX .... 94

19.3.1. Añadir nuevas excepciones a la gestión .... 95

19.4. Nuevos diálogos modales .... 96

19.4.1. Ejemplos de dialogos personalizados .... 97

19.5. Futuras versiones .... 100

20. Add-on CIT Security .... 101

20.1. Descripción .... 101

21. Add-on Web Report .... 103

21.1. Descripción .... 103
21.2. Instalación .... 103
21.3. Generación de un informe .... 105
21.4. Futuras versiones .... 107

22. Add-on Service .... 108

22.1. Descripción .... 108
22.2. Creación de servicios locales .... 108
22.3. Creación de servidores desde Java .... 109
22.4. Creación de servidores desde WSDL .... 110
22.5. Creación de clientes .... 111

1.1.0-RELEASE

iv

gvNIX - Documentación de referencia

22.6. Acceso a un WSDL en un servidor seguro .... 112

22.6.1. Creación de clientes con firma .... 113

22.7. Listar los servicios .... 114
23. Add-on Web MVC i18n .... 115

23.1. Descripción .... 115
23.2. Instalación de un idioma .... 115
23.3. Futuras versiones .... 115

24. Add-on Dynamic Configuration .... 116

24.1. Descripción .... 116
24.2. Funcionalidad .... 116
24.3. Mejoras de renimiento .... 119
24.4. Futuras versiones .... 119

25. Add-on Web MVC Binding .... 121

25.1. Descripción .... 121
25.2. Futuras versiones .... 122

26. Working with the Flex Addon for Spring Roo .... 123

26.1. Introduction .... 123

26.1.1. Flex Addon for Spring Roo Features .... 123
26.1.2. Flex Commands .... 123
26.1.3. Building and Running a Flex Addon Project .... 126
26.1.4. Running the Sample Roo Script .... 126
26.1.5. Known Issues .... 127

27. Add-on Web MVC Datatables .... 128

27.1. Descripción .... 128
27.2. Instalación del soporte para Datatables .... 128
27.3. Usar datatables en la vista "list" de un controlador. .... 130
27.4. Ajustar la configuración del datatables de una vista. .... 130
27.5. Cambiar el modo de datos de Datatables. .... 130
27.6. Futuras versiones .... 130

IV. Recetas de desarrollo .... 132

28. Recetas .... 133

28.1. Repositorios Maven .... 133
28.2. Desarrollo de buscadores con gran cantidad de campos .... 133
28.3. Campos opcionales en los buscadores .... 134
28.4. Instalar fuentes de letra para los informes .... 136
28.5. Diseño de informes con sub informes .... 137
28.6. Operaciones durante el inicio de la aplicación .... 144
28.7. Obtener el BindStatus de un atributo dentro de un formulario .... 144

V. Apéndices .... 146

29. Apéndice de comandos de gvNIX .... 147
29.1. Comandos del add-on OCC .... 147

29.1.1. occ checksum set .... 147
29.1.2. occ checksum all .... 147

29.2. Comandos del add-on Theme Manager .... 148

29.2.1. theme install .... 148
29.2.2. theme set .... 148
29.2.3. theme list .... 149

29.3. Comandos del add-on Web Dialog .... 149

29.3.1. web mvc dialog setup .... 150

1.1.0-RELEASE

v

gvNIX - Documentación de referencia

29.3.2. web mvc dialog exception list .... 150
29.3.3. web mvc dialog exception add .... 150
29.3.4. web mvc dialog exception set language .... 151
29.3.5. web mvc dialog exception remove .... 151
29.3.6. web mvc dialog add .... 152

29.4. Comandos del add-on Web Menu .... 152

29.4.1. menu setup .... 152
29.4.2. menu entry add .... 153
29.4.3. menu entry visibility .... 153
29.4.4. menu entry roles .... 154
29.4.5. menu entry move .... 154
29.4.6. menu entry update .... 155
29.4.7. menu entry info .... 155
29.4.8. menu tree .... 156

29.5. Comandos del add-on Web Screen Patterns .... 157

29.5.1. web mvc pattern setup .... 157
29.5.2. web mvc pattern update tags .... 158
29.5.3. web mvc pattern master .... 158
29.5.4. web mvc pattern detail .... 158

29.6. Comandos del add-on CIT Security .... 160

29.6.1. cit security setup .... 160

29.7. Comandos del add-on Web Report .... 160

29.7.1. web report setup .... 161
29.7.2. web report add .... 161

29.8. Comandos del add-on Service .... 161

29.8.1. remote service class .... 162
29.8.2. remote ser