Ir al contenido principal

Patr贸n CQRS en C#: El arte de separar comandos y consultas 馃幁


Patr贸n CQRS en C#: El arte de separar comandos y consultas 馃幁

¡Imagina una biblioteca donde tienes libros que puedes leer y otros que puedes sacar y llevarte a casa! As铆 es como funciona el patr贸n CQRS en C#. Separa las operaciones de lectura (consultas) de las operaciones de escritura (comandos) para una arquitectura de software m谩s eficiente.



馃殌 Introducci贸n

El patr贸n CQRS (Command Query Responsibility Segregation) es un patr贸n de dise帽o que separa las responsabilidades de lectura y escritura en tu aplicaci贸n C#. Es como tener dos puertas separadas en tu casa: una para los invitados (consultas) y otra para el repartidor de pizzas (comandos).

馃挕 Conceptos B谩sicos

Comandos (Commands)

Estos son los que modifican el estado de tu sistema, como crear un nuevo usuario o actualizar un producto. Suelen representarse como m茅todos en tus controladores o servicios.

Consultas (Queries)

Las consultas recuperan datos sin modificar el estado del sistema. Pueden ser operaciones de solo lectura como obtener la lista de usuarios o recuperar detalles de un producto.

Controladores y Repositorios

Los controladores generalmente manejan comandos, mientras que los repositorios manejan consultas. Esto mantiene las responsabilidades separadas y hace que tu c贸digo sea m谩s f谩cil de mantener.

馃懆‍馃捇 Manos al C贸digo

Ejemplo 1: Crear un nuevo usuario (comando)


public async Task CreateUser([FromBody] CreateUserDto userDto)
{
    // ... Validaci贸n y mapeo del modelo
    var user = await _userService.CreateUserAsync(userDto);
    return Ok(user);
}
        

Este controlador maneja el comando de creaci贸n de usuario y llama al servicio de usuario para crear el usuario.

Ejemplo 2: Obtener la lista de usuarios (consulta)


public async Task GetUsers()
{
    // ...
    var users = await _userRepository.GetUsersAsync();
    return Ok(users);
}
        

Este controlador maneja la consulta para obtener la lista de usuarios y llama al repositorio de usuarios para recuperar los datos.

馃拵 Tips y Mejores Pr谩cticas

Tip #1: Mant茅n los comandos y consultas separados

Esto ayuda a evitar conflictos y hace que tu c贸digo sea m谩s f谩cil de entender y mantener.


// Controlador de comandos
public class UserController : ApiController
{
    // ...
}

// Controlador de consultas
public class UserQueryController : ApiController
{
    // ...
}
            

Tip #2: Usa nombres descriptivos

Nombra tus comandos y consultas de forma que describan claramente su prop贸sito. Esto mejora la legibilidad de tu c贸digo.

⚠️ Errores Comunes y Soluciones

Error #1: Mezclar comandos y consultas

Esto puede provocar conflictos y dificultar el mantenimiento de tu c贸digo.

Soluci贸n:

Mant茅n los comandos y consultas separados en diferentes m茅todos o incluso en diferentes clases.

馃幆 Conclusi贸n

El patr贸n CQRS en C# es una herramienta valiosa para dise帽ar aplicaciones escalables y mantenibles. Al separar las operaciones de lectura y escritura, puedes mejorar el rendimiento, reducir los conflictos y hacer que tu c贸digo sea m谩s f谩cil de entender.



Comentarios

Entradas populares de este blog

Formatos con String.Format en C#

Todas las aplicaciones que desarrollamos en alg煤n momento necesitan formatear alg煤n tipo de datos, y no se a ustedes pero a mi siempre se me olvidan los formatos y como obtener los resultados de una u otra forma, es por eso que decid铆 hacer este post, y recopilar la mayor cantidad de formatos posibles, para buscarlos cuando necesite y ustedes puedan copiarlos ;=). Para formatear cadenas existe una clase especializada en el manejo de cadenas, esta clase se llama String, su nombre completo es System.String, ya que se encuentra en el namespace System. En esta clase vamos a encontrar una funci贸n llamada Format que se encargar谩 de reemplazar el valor de un dato (entero, real, una cadena, un car谩cter, hasta de un objeto), por el formato que se especifique en el par谩metro. En forma general, y aunque tiene varias sobrecargas, String.Format tiene la siguiente sintaxis: Formatos para n煤meros:   Tipo ...

Gu铆a completa de .NET MAUI para el desarrollo de aplicaciones m贸viles multiplataforma

Gu铆a completa de .NET MAUI para el desarrollo de aplicaciones m贸viles multiplataforma ⏱️ Tiempo de lectura: 30 minutos 馃幆 Nivel: Intermedio ¡Prep谩rate para revolucionar el desarrollo m贸vil! Descubre .NET MAUI, el marco multiplataforma que te permite crear aplicaciones nativas para iOS, Android y escritorio con una sola base de c贸digo. Ad茅ntrate en los fundamentos, implementaciones pr谩cticas, ejemplos avanzados y mejores pr谩cticas para dominar .NET MAUI y llevar tus habilidades de desarrollo m贸vil al siguiente nivel. 馃搼 Contenido del Art铆culo Introducci贸n a .NET MAUI para m贸viles Fundamentos y Conceptos Clave Arquitectura de .NET MAUI ...

Hora Militar o Formato 24 Horas en SQL SERVER

Es curioso los problemas que nos encontramos a diario al desarrollar, siempre resulta que hay algo nuevo y algo que no sabemos, aprendemos d铆a a d铆a con cada cosa que hacemos, y cada c贸digo que escribimos. El d铆a de hoy les traigo una instrucci贸n que si bien es muy sencilla, puede ahorrarnos varias horas de b煤squeda infructuosa en san google. Se trata de convertir una hora en sql server al formato militar o formato de 24 horas. Para esto tenemos varias formas: SELECT CONVERT(VARCHAR(8), dateadd(HOUR,12, cast('2017-01-01 10:15:00' as datetime)), 108) AS HoraMilitar Veamos lo que se hace en la instrucci贸n anterior: Tenemos la fecha y hora: 2017-01-01 10:15:00 la cual convertimos a datetime cast('2017-01-01 10:15:00' as datetime) luego le sumamos 12 horas para ejemplificar el ejercicio "dateadd(HOUR,12," y por ultimo pasamos a varchar para darle formato militar CONVERT(VARCHAR(8), "Aqu铆 la fecha",108) Notese que uso el c贸digo 108 de con...