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

gvNIX - Documentación de referencia

1.3.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 .... 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.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.3.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 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.0-RELEASE

iv

gvNIX - Documentación de referencia

20.14. Registro seleccionado siempre visible .... 98

21. Add-on Campos Lupa .... 99

21.1. Descripción .... 99
21.2. Instalación del componente lupa .... 99
21.3. Permitiendo a una entidad utilizar el campo lupa .... 99
21.4. Utilizando componentes lupa .... 99
21.5. Actualizando componentes lupa .... 99
21.6. Apendice de comandos .... 99

22. Add-on Web Screen Patterns .... 100

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

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

22.4. Tipos de patrones .... 104

22.4.1. Tabular .... 104
22.4.2. Tabular con edición registro .... 106
22.4.3. Registro .... 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

25. Add-on CIT Security .... 120

25.1. Descripción .... 120

26. Add-on GVA Security .... 122

26.1. Descripción .... 122

27. Add-on Web Report .... 123

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

28. Add-on Service .... 128

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

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

28.7. Listar los servicios .... 134
29. Add-on Web MVC i18n .... 135

29.1. Descripción .... 135

1.3.0-RELEASE

v

gvNIX - Documentación de referencia

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

30. Add-on Dynamic Configuration .... 136

30.1. Descripción .... 136
30.2. Funcionalidad .... 136
30.3. Mejoras de renimiento .... 139
30.4. Futuras versiones .... 139

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

31.1. Descripción .... 141
31.2. Futuras versiones .... 142

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

32.1. Introduction .... 143

32.1.1. Flex Addon for Spring Roo Features .... 143
32.1.2. Flex Commands .... 143
32.1.3. Building and Running a Flex Addon Project .... 146
32.1.4. Running the Sample Roo Script .... 146
32.1.5. Known Issues .... 147

IV. Recetas de desarrollo .... 148

33. Recetas .... 149

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