PDF de programación - gvnix 1.4.1 - Documentación de referencia

gvNIX - Documentación de referencia

1.4.1.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.4.1.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.4.1.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 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 JPA .... 81

17.1. Servicios persistencia en bloque .... 81
17.2. Información adicional para búsquedas por relaciones .... 82
17.3. Auditoría y resgistro de cambios de entidades .... 83

17.3.1. Configurar detalles de usuario .... 83
17.3.2. Auditoría básica de entidades .... 83
17.3.3. Auditoría y registro de cambios de entidades .... 84
17.3.4. Proveedor de registro de cambios Hibernate Envers .... 86

17.4. Persistencia de entidades con campos de tipo geográfico .... 87

17.4.1. Configuración del proyecto para soporte geográfico .... 87
17.4.2. Añadir campos de tipo geográfico a entidades .... 87
17.4.3. Implementación de buscadores para campos GEO .... 88

18. Add-on Monitoring .... 89

18.1. Descripción .... 89
18.2. Instalación de la monitorización .... 89
18.3. Monitorizando a través de Spring .... 89
18.4. Accediendo a la monitorización .... 89

19. Add-on Web MVC .... 90

19.1. Interfaz para operaciones de persistencia en bloque .... 90

19.1.1. Métodos de creación y actualización .... 90
19.1.2. Método de eliminación .... 91
19.1.3. Carga de datos en formato JSON .... 91

19.2. Visualización con jQuery .... 92

19.2.1. Conversión de las vistas a jQuery .... 92

20. Add-on Bootstrap .... 93
20.1. Descripción .... 93
20.2. Instalación de Bootstrap 3 .... 93
20.3. Actualización de componentes .... 93
20.4. Apendice de comandos .... 93

21. Add-on Web MVC Datatables .... 94

21.1. Descripción .... 94
21.2. Instalación del soporte para Datatables .... 95
21.3. Usar datatables en la vista "list" de un controlador. .... 95

1.4.1.RELEASE

iv

gvNIX - Documentación de referencia

21.4. Ajustar la configuración del datatables de una vista. .... 96
21.5. Cambiar el modo de datos de Datatables. .... 96
21.6. El control de búsqueda y filtros por columnas. .... 96
21.7. Filtros Simples .... 97
21.8. Modo visualización de registro. .... 98
21.9. Visualización de detalles. .... 98
21.10. Eliminación múltiple. .... 99
21.11. Edición en línea. .... 99
21.12. Registro creado en primera posición .... 100
21.13. Registro editado en primera posición .... 100
21.14. Registro seleccionado siempre visible .... 100

22. Add-on Web MVC GEO .... 102

22.1. Descripción .... 102
22.2. Instalación del soporte para vista de Mapa .... 102
22.3. Generar vista de Mapa .... 103
22.4. Generar campos de mapa en vistas CRU .... 103
22.5. Añadir entidades a la vista de Mapa .... 103
22.6. Añadir Capas Base la vista de Mapa .... 104
22.7. Generar nuevas herramientas en la vista del Mapa .... 104

23. Add-on Campos Lupa .... 105

23.1. Descripción .... 105
23.2. Instalación del componente lupa .... 105
23.3. Permitiendo a una entidad utilizar el campo lupa .... 105
23.4. Utilizando componentes lupa .... 105
23.5. Actualizando componentes lupa .... 105
23.6. Apendice de comandos .... 105
24. Add-on Web Screen Patterns .... 106

24.1. Descripción .... 106
24.2. Instalación .... 106
24.3. Creación de un patrón .... 107

24.3.1. Creación de un patrón maestro .... 108
24.3.2. Creación de un patrón detalle .... 109

24.4. Tipos de patrones .... 110

24.4.1. Tabular .... 110
24.4.2. Tabular con edición registro .... 112
24.4.3. Registro .... 114

25. Add-on OCC (Optimistic Concurrency Control) .... 116

25.1. Introducción .... 116
25.2. Añadir el control en las entidades .... 116

26. Add-on Web Dialog .... 119

26.1. Descripción .... 119
26.2. Instalación .... 119
26.3. Excepciones controladas por gvNIX .... 119

26.3.1. Añadir nuevas excepciones a la gestión .... 120

26.4. Nuevos diálogos modales .... 121

26.4.1. Ejemplos de dialogos personalizados .... 122

26.5. Futuras versiones .... 125

27. Add-on CIT Security .... 126

27.1. Descripción .... 126

1.4.1.RELEASE

v

gvNIX - Documentación de referencia

28. Add-on GVA Security .... 128

28.1. Descripción .... 128

29. Add-on Web Report .... 130

29.1. Descripción .... 130
29.2. Instalación .... 130
29.3. Generación de un informe .... 132
29.4. Futuras versiones .... 134

30. Add-on Service .... 135

30.1. Descripción .... 135
30.2. Creación de servicios locales .... 135
30.3. Creación de servidores desde Java .... 136
30.4. Creación de servidores desde WSDL .... 137
30.5. Creación de clientes .... 138
30.6. Acceso a un WSDL en un servidor seguro .... 139

30.6.1. Creación de clientes con firma .... 140

30.7. Listar los servicios .... 141
31. Add-on Web MVC i18n .... 142

31.1. Descripción .... 142
31.2. Instalación de un idioma .... 142
31.3. Futu