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 ...

Subir archivos al servidor

 Muchas veces necesitamos que nuestros usuarios puedan subir archivos al servidor  ya sean imágenes,pdf, rar,zip,etc, y es común que quieran encontrar métodos fáciles y agiles para realizar esto. Es por eso que hoy les traigo un post donde les enseñare a crear una aplicación en ASP.NEET Y C# para que puedan subir archivos a una carpeta del servidor. Es muy simple, pero vaya que nos es útil, y más cuando es para satisfacer las necesidades de nuestro cliente. Sin hablar más aquí vamos: Lo primero que haremos es crear una aplicación en Visual Studio - ASP.NET y escogeremos como lenguaje C#, luego agregaremos una nueva WebPage y agregaremos los siguientes controles: FileUpload – Label - Boton Le cambiaremos los id de los controles  y les pondremos nombres descriptivos por aquello de las Buenas practicas de programación. La propiedad Text del botón le pondremos “Enviar”. Crearemos una carpeta en el server que se llame “Archivos” para esto daremos Click derecho en el e...

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...