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

gvNIX - Documentación de referencia

1.5.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.1.3. Integrar soporte ROO en STS .... 13

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

1.5.0.RELEASE

ii

gvNIX - Documentación de referencia

8.1.1. Comando entity jpa .... 38
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

1.5.0.RELEASE

iii

gvNIX - Documentación de referencia

13.3. Ejecutar los tests funcionales .... 71

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 Web Menu .... 76
15.1. Descripción .... 76
15.2. Definiciones .... 76
15.3. Instalación de la gestión del menú .... 77
15.4. Modificación del menú. .... 77
15.5. Futuras versiones .... 78

16. Add-on JPA .... 79

16.1. Servicios persistencia en bloque .... 79
16.2. Información adicional para búsquedas por relaciones .... 80
16.3. Auditoría y resgistro de cambios de entidades .... 81

16.3.1. Configurar detalles de usuario .... 81
16.3.2. Auditoría básica de entidades .... 81
16.3.3. Auditoría y registro de cambios de entidades .... 82
16.3.4. Proveedor de registro de cambios Hibernate Envers .... 84

16.4. Persistencia de entidades con campos de tipo geográfico .... 85

16.4.1. Configuración del proyecto para soporte geográfico .... 85
16.4.2. Añadir campos de tipo geográfico a entidades .... 85
16.4.3. Implementación de buscadores para campos GEO .... 86

17. Add-on Monitoring .... 87

17.1. Descripción .... 87
17.2. Instalación de la monitorización .... 87
17.3. Monitorizando a través de Spring .... 87
17.4. Accediendo a la monitorización .... 87

18. Add-on Web MVC .... 88

18.1. Interfaz para operaciones de persistencia en bloque .... 88

18.1.1. Métodos de creación y actualización .... 88
18.1.2. Método de eliminación .... 89
18.1.3. Carga de datos en formato JSON .... 89

18.2. Visualización con jQuery .... 90

18.2.1. Conversión de las vistas a jQuery .... 90

19. Add-on Bootstrap .... 91
19.1. Descripción .... 91
19.2. Instalación de Bootstrap 3 .... 91
19.3. Actualización de componentes .... 91
19.4. Apendice de comandos .... 91

20. Add-on Web MVC Datatables .... 92

20.1. Descripción .... 92
20.2. Instalación del soporte para Datatables .... 93
20.3. Usar datatables en la vista "list" de un controlador. .... 93
20.4. Ajustar la configuración del datatables de una vista. .... 94
20.5. Cambiar el modo de datos de Datatables. .... 94
20.6. El control de búsqueda y filtros por columnas. .... 94
20.7. Filtros Simples .... 95

1.5.0.RELEASE

iv

gvNIX - Documentación de referencia

20.8. Añadir Columnas Personalizadas .... 96
20.9. Modo visualización de registro. .... 96
20.10. Visualización de detalles. .... 97
20.11. Eliminación múltiple. .... 97
20.12. Edición en línea. .... 98
20.13. Registro creado en primera posición .... 98
20.14. Registro editado en primera posición .... 99
20.15. Registro seleccionado siempre visible .... 99

21. Add-on Web MVC GEO .... 100

21.1. Descripción .... 100
21.2. Instalación del soporte para vista de Mapa .... 101
21.3. Generar vista de Mapa .... 101
21.4. Generar campos de mapa en vistas CRU .... 101
21.5. Generar agrupaciones de capas sobre un mapa .... 102
21.6. Añadir entidades a la vista de Mapa .... 102
21.7. Añadir Capas Base la vista de Mapa .... 102
21.8. Generar nuevas herramientas en la vista del Mapa .... 103

21.8.1. Otras herramientas disponibles para añadir al Mapa .... 103

21.9. Añadir componente Mini Mapa en la vista del Mapa .... 104
21.10. Añadir Componentes Geográficos .... 104

21.10.1. Coordenadas .... 104
21.10.2. Escala .... 104
21.10.3. Buscador por callejero .... 105
21.10.4. Control de opacidad de capas .... 105

21.11. Desactivar/activar ordenación de capas .... 105
21.12. Mostrar filtrado de entidades .... 106
21.13. Personalizar capas generadas .... 106

21.13.1. Añadir etiquetas a capas .... 106
21.13.2. Personalizar título de capa .... 106
21.13.3. Herramientas de capa .... 107

22. Add-on Campos Lupa .... 108

22.1. Descripción .... 108
22.2. Instalación del componente lupa .... 108
22.3. Permitiendo a una entidad utilizar el campo lupa .... 108
22.4. Utilizando componentes lupa .... 108
22.5. Actualizando componentes lupa .... 108
22.6. Apendice de comandos .... 108
22.7. Configuración del widget lupa .... 108

23. Add-on OCC (Optimistic Concurrency Control) .... 110

23.1. Introducción .... 110
23.2. Añadir el control en las entidades .... 110

24. Add-on Web Dialog .... 113

24.1. Descripción .... 113
24.2. Instalación .... 113
24.3. Excepciones controladas por gvNIX .... 113

24.3.1. Añadir nuevas excepciones a la gestión .... 114

24.4. Nuevos diálogos modales .... 115

24.4.1. Ejemplos de dialogos personalizados .... 116

24.5. Futuras versiones .... 119

1.5.0.RELEASE

v

gvNIX - Documentación de referencia

25. Add-on GVA Security .... 120

25.1. Descripción .... 120

26. Add-on Web Report .... 121

26.1. Descripción .... 121
26.2. Instalación .... 121
26.3. Generación de un informe .... 123
26.4. Futuras versiones .... 125

27. Add-on Service .... 126

27.1. Descripción .... 126
27.2. Creación de servicios locales .... 126
27.3. Creación de servidores desde Java .... 127
27.4. Creación de servidores desde WSDL .... 128
27.5. Creación de clientes .... 129
27.6. Acceso a un WSDL en un servidor seguro .... 130

27.6.1. Cre