Duende CG - Documentación

Creación del Proyecto de la Aplicación

Duende Code Generator v1.0.0 genera aplicaciones Java Web realizadas con Spring Boot versión 2.7.x.

Para ejecutar, modificar, compilar el código de la aplicación, es necesario crear un Proyecto Spring Boot que integre el código generado por Duende GC.

Características del Proyecto Spring Boot

Las características que debe tener este proyecto son las siguientes:

  • Proyecto Spring Boot versión 2.7.x
  • Gestión de Proyecto Maven
  • Lenguaje Java versión 17
  • Packaging jar
  • Paquete: debe coincidir con el paquete indicado en la especificación JSON (appMainPackage)

Dependencias del proyecto

El proyecto que integrará el código generado usará las siguientes dependencias:

  • Spring Web: uso de aplicaciones web con arquitectura MVC (modelo-vista-controlador)
  • Thymeleaf: motor de plantillas para la creación de las vistas de la aplicación
  • Spring Security: capa de protección de la aplicación, control de acceso y autenticación
  • Spring Data JPA: API de persistencia para la implementación del ORM (mapeo de objetos en base de datos)
  • H2 Database: base de datos H2 para pruebas con datos en memoria
  • MySQL Driver: base de datos MySQL
  • PostgreSQL Driver: base de datos PosgreSQL
  • Validation: validaciones sobre campos de entidades
  • Spring Boot DevTools: arranque automático del servidor de pruebas al realizar modificaciones

Creando el proyecto Spring Boot con Spring Initializr

La forma más sencilla de crear el proyecto para el código generado por Duende es a través de la herramienta Spring Initializr. Puede acceder a ella desde el enlace start.spring.io, o pulsando el siguiente botón:

Spring Initializr

En la página web que se abre, introduzca las características anteriores y pulse el botón Generate para que se descargue la carpeta del proyecto vacío (ZIP)

...
Creación del Proyecto con Spring Initializr.

Una vez descomprima la carpeta del proyecto, podrá acceder a su contenido. Dentro de ella verá una carpeta src que contendrá el código fuente de la aplicación. Dentro de la carpeta src verá dos carpetas: main y test, la primera contendrá los archivos generados por Duende, mientras que la segunda se usa para programar tests sobre la aplicación.

En el caso de que la aplicación generada por Duende maneje campos de imágenes, necesitará crear una carpeta en la carpeta raíz del proyecto para almacenar estas imágenes. Esta carpeta se llamará upload, a no ser que en las especificaciones JSON haya indicado otro nombre con el elemento appFilesUploadFolder.

Carpeta del Proyecto
        |
        --------- src
        |          |
        |          ---- main (archivos fuente generados)
        |          |
        |          ---- test
        |
        --------- upload (carpeta para la subida de imágenes)
        |

Puede obtener más información sobre la integración de los archivos fuente generados en el proyecto en el apartado Añadiendo el Código Generado al Proyecto. También puede encontrar videos de demostración en el apartado Demostraciones.