Skip to content
CodeDesignPlus

Creación de un Agregado

Command: yo codedesignplus:microservice aggregate

Este comando se utiliza para crear un nuevo agregado dentro de un microservicio existente. En el contexto de Domain-Driven Design (DDD), los agregados son bloques de construcción clave que garantizan la consistencia de las entidades dentro de sus límites. El comando facilita la generación de la estructura necesaria para definir un nuevo agregado en tu microservicio.

Prerrequisitos

Conceptos Clave

  • Agregado (Aggregate): En DDD, un agregado es un clúster de entidades y objetos de valor que se tratan como una sola unidad. Tiene una entidad raíz que es la responsable de mantener la consistencia del agregado.
  • Entidad Raíz (Aggregate Root): La entidad principal dentro de un agregado que tiene identidad y es la única que puede ser referenciada desde fuera del agregado.
  • Consistencia: Los agregados deben mantener la consistencia de sus datos. Las operaciones que cambian el estado de un agregado se deben realizar a través de la entidad raíz.
  • DDD: Domain-Driven Design es un enfoque de desarrollo de software que modela el software alrededor del dominio del negocio. Los agregados son un concepto central en DDD.

Sintaxis del Comando

El comando yo codedesignplus:microservice aggregate tiene la siguiente sintaxis:

Terminal window
yo codedesignplus:microservice aggregate \
    --organization "<organization_name>" \
    --microservice "<microservice_name>" \
    --aggregate "<aggregate_name>"

--organization

  • Tipo: string
  • Obligatorio: Sí
  • Descripción: El nombre de la organización a la que pertenece el microservicio.

--microservice

  • Tipo: string
  • Obligatorio: Sí
  • Descripción: El nombre del microservicio donde se creará el agregado.

--aggregate

  • Tipo: string
  • Obligatorio: Sí
  • Descripción: El nombre del agregado que se creará.

Ejemplos de Uso

Este ejemplo crea un nuevo agregado llamado UserProfile en el microservicio users de la organización acme.

Terminal window
yo codedesignplus:microservice aggregate \
    --organization "Acme" \
    --microservice "User" \
    --aggregate "UserProfile"

Salida del comando en consola

Tras ejecutar el comando, se generará la estructura base del agregado UserProfile en el microservicio users, con la siguiente salida en consola:

Archetype

Directorios y Archivos Generados

Si exploramos el microservicio con VS Code, veremos la estructura de directorios y archivos generados para el nuevo agregado:

Archetype

Resultados de la Ejecución

La ejecución de este comando con los parámetros proporcionados generará la estructura base de un nuevo agregado en el microservicio especificado. Veamos los resultados de la ejecución del comando:

--organization

Flag: --organization "acme"

  1. Este parámetro establece el nombre de la organización, que se refleja en los namespaces de los archivos generados para el agregado.

    Archetype

--microservice

Flag: --microservice "users"

  1. Este parámetro establece el nombre del microservicio en el que se creará el agregado, reflejándose en los namespaces y ubicaciones de los archivos.

    Archetype

--aggregate

Flag: --aggregate "UserProfile"

  1. Este parámetro establece el nombre del nuevo agregado, reflejándose en los nombres de los archivos y clases generadas dentro de las capas de dominio, aplicación e infraestructura.

    Archetype

Consideraciones Adicionales

  • Asegúrate de tener un microservicio existente antes de utilizar este comando.
  • Define cuidadosamente los límites de tu agregado. Un agregado debe representar un concepto del dominio que tiene sentido como unidad.

Enlaces Relacionados

Conclusión

El comando yo codedesignplus:microservice aggregate facilita la creación de un nuevo agregado en un microservicio existente. Los agregados son una parte fundamental de DDD y ayudan a mantener la consistencia de los datos dentro de un límite bien definido. Al utilizar este comando, puedes generar rápidamente la estructura base de un nuevo agregado y comenzar a modelar tu dominio de manera efectiva.