Skip to main content

Estructura de proyectos

El generar un proyecto de referencia para Alpura basado en una arquitectura orientada a Microservicios, le permitirá iniciar con una base estructurada para la generación de estos para los proyectos futuros, de forma fácil y sencilla, siguiendo las buenas prácticas, topologías y lineamientos o criterios para su definición.

Basándose en la estructura gradle de generación de proyectos, anteriormente comentada, el proyecto de referencia se conforma de la siguiente forma:

Carpeta Descripción o contenido

Microservices-generator-application Carpeta principal del módulo base.

Microservices-generator-application/build.grandle Archivo de configuración del módulo base, es el que contiene la configuración global del proyecto.

Microservices-generator-application/src/main/java Es aquí donde se guarda las clases java fuente situándolos en diferentes paquetes.

Microservices-generator-application/src/main/resources Esta carpeta almacena los recursos que necesiten las clases java del proyecto (ficheros XML, ficheros de propiedades, imágenes, etc.).

Microservices-generator-application/src/main/resources/templates Contiene la estructura de las diferentes capas del proyecto (Business, System, Experience).

Microservices-generator-application/JRE System Library Es la carpeta en donde se encuentra la configuración mínima de java necesaria para que el proyecto pueda ejecutarse

Microservices-generator-application/Maven Dependencies Carpeta en donde se encuentras las dependencias o artefactos exclusivos de Maven a utilizar en el proyecto

Microservices-generator-application/src Carpeta que contiene todos los ficheros necesarios para la generación automática del sitio web con la información del proyecto

Microservices-generator-application/target Es el directorio destino de todo build en Maven, es decir, todo el código compilado el proyecto, de las pruebas, los ficheros .jar .war etc.

Microservices-generator-application/README.md Fichero readme de introducción o guía del proyecto.​

Definición del build.gradle​

El archivo build.gradle es el archivo de configuración principal en un proyecto que utiliza Gradle como herramienta de automatización de compilación. En este archivo, se definen todas las configuraciones relacionadas con la construcción del proyecto, como las dependencias, los plugins utilizados, las tareas personalizadas, y las instrucciones para empaquetar y distribuir el software.

Durante la ejecución de una tarea (task) o meta (goal), gradle busca el archivo build.grandle, lo lee y obtiene los datos de configuración, para finalmente ejecutar la meta.

Las configuraciones que pueden especificarse en el archivo, son los siguientes:

  • Dependencias del proyecto

  • Plugins

  • Repositorios

  • Tareas

  • Configuraciones

Antes de crear un build.grandle, primero se debe decidir el grupo del proyecto (group), su nombre y su versión. Los anteriores atributos definen de forma única al proyecto en el repositorio.

Para el actual Proyecto de referencia, el proyecto Microservices-generator-application consta de las siguientes configuraciones:

GroupId ArtifactId Version Name Description Packaging

mx.com.alpura.api Microservices-generator-application 1.00 Aplicación Aplicación jar generadora de generadora de
Microservicios Microservicios