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

gvNIX - Documentación de referencia

1.3.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.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 jpa .... 38

1.3.1-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.3.1-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 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

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
20.8. Modo visualización de registro. .... 96
20.9. Visualización de detalles. .... 96
20.10. Eliminación múltiple. .... 97
20.11. Edición en línea. .... 97
20.12. Registro creado en primera posición .... 98
20.13. Registro editado en primera posición .... 98

1.3.1-RELEASE

iv

gvNIX - Documentación de referencia

20.14. Registro seleccionado siempre visible .... 98

21. Add-on Campos Lupa .... 100

21.1. Descripción .... 100
21.2. Instalación del componente lupa .... 100
21.3. Permitiendo a una entidad utilizar el campo lupa .... 100
21.4. Utilizando componentes lupa .... 100
21.5. Actualizando componentes lupa .... 100
21.6. Apendice de comandos .... 100
22. Add-on Web Screen Patterns .... 101

22.1. Descripción .... 101
22.2. Instalación .... 101
22.3. Creación de un patrón .... 102

22.3.1. Creación de un patrón maestro .... 103
22.3.2. Creación de un patrón detalle .... 104

22.4. Tipos de patrones .... 105

22.4.1. Tabular .... 105
22.4.2. Tabular con edición registro .... 107
22.4.3. Registro .... 109

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

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

24. Add-on Web Dialog .... 114

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

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

24.4. Nuevos diálogos modales .... 116

24.4.1. Ejemplos de dialogos personalizados .... 117

24.5. Futuras versiones .... 120

25. Add-on CIT Security .... 121

25.1. Descripción .... 121

26. Add-on GVA Security .... 123

26.1. Descripción .... 123

27. Add-on Web Report .... 125

27.1. Descripción .... 125
27.2. Instalación .... 125
27.3. Generación de un informe .... 127
27.4. Futuras versiones .... 129

28. Add-on Service .... 130

28.1. Descripción .... 130
28.2. Creación de servicios locales .... 130
28.3. Creación de servidores desde Java .... 131
28.4. Creación de servidores desde WSDL .... 132
28.5. Creación de clientes .... 133
28.6. Acceso a un WSDL en un servidor seguro .... 134

28.6.1. Creación de clientes con firma .... 135

28.7. Listar los servicios .... 136
29. Add-on Web MVC i18n .... 137

29.1. Descripción .... 137

1.3.1-RELEASE

v

gvNIX - Documentación de referencia

29.2. Instalación de un idioma .... 137
29.3. Futuras versiones .... 137

30. Add-on Dynamic Configuration .... 138

30.1. Descripción .... 138
30.2. Funcionalidad .... 138
30.3. Mejoras de renimiento .... 141
30.4. Futuras versiones .... 141

31. Add-on Web MVC Binding .... 143

31.1. Descripción .... 143
31.2. Futuras versiones .... 144

32. Working with the Flex Addon for Spring Roo .... 145

32.1. Introduction .... 145

32.1.1. Flex Addon for Spring Roo Features .... 145
32.1.2. Flex Commands .... 145
32.1.3. Building and Running a Flex Addon Project .... 148
32.1.4. Running the Sample Roo Script .... 148
32.1.5. Known Issues .... 149

IV. Recetas de desarrollo .... 150

33. Recetas .... 151

33.1. Repositorios Maven .... 151
33.2. Desarrollo de buscadores con gran cantidad de campos .... 151
33.3. Campos opcionales en los buscadores .... 152
33.4. Instalar fuentes de letra para los informes .... 154
33.5.