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