Imagina desarrollar una aplicación .NET 9.0 donde la lógica de negocio está completamente entrelazada con la lógica de acceso a datos. Cada cambio en la base de datos obliga a modificar múltiples partes del código. Esto es una receta para el caos.

 Aquí es donde entra el Patrón Repositorio, una estrategia de arquitectura que no solo organiza tu código, sino que también mejora su mantenibilidad, escalabilidad y testabilidad. En este artículo, aprenderás qué es, cómo implementarlo en .NET 9.0 y por qué puede ser clave en tus proyectos empresariales.

¿Qué es el Patrón Repositorio?

El Patrón Repositorio actúa como una capa intermedia entre la lógica de negocio y la fuente de datos. Su función principal es abstraer el acceso a datos, permitiendo que el código de negocio se mantenga limpio y enfocado en su responsabilidad principal.

Beneficios Clave:

• Desacoplamiento entre lógica de negocio y persistencia.
• Fácil de testear mediante mocks o fakes.
• Reutilización de código de acceso a datos.
• Cambio de proveedor de datos sin modificar la capa de negocio.

Ventajas de un Repositorio Genérico

  Un repositorio genérico permite definir una sola implementación reutilizable para cualquier entidad de tu modelo de dominio, lo que ofrece beneficios adicionales:

• Reducción de código duplicado: No necesitas escribir el mismo CRUD básico para cada entidad.
• Consistencia: Todas las operaciones siguen una estructura unificada, facilitando mantenimiento y refactorizaciones.
• Flexibilidad: Puedes extenderlo o sobrescribirlo en repositorios específicos cuando sea necesario.
• Escalabilidad: Ideal para proyectos grandes con muchas entidades similares.

Arquitectura por Capas: Quién Llama a Quién

Una petición fluye a través de la aplicación de esta manera:

1. Cliente (ej. frontend Angular o Postman)
2. Controlador (Controller): recibe la solicitud HTTP.
3. Servicio (Service): contiene la lógica de negocio.
4. Repositorio (Repository): se comunica con la base de datos.
5. Base de datos: almacena o recupera los datos.

  Cada capa solo interactúa con la capa inmediatamente inferior, promoviendo una arquitectura limpia y mantenible.

Implementación del patrón repositorio en NET 9.0

1. Modelo de Dominio

public class Producto
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public decimal Precio { get; set; }
}

2. Interfaz Genérica del Repositorio

public interface IRepositorio<T> where T : class
{
    Task<IEnumerable<T>> ObtenerTodosAsync();
    Task<T?> ObtenerPorIdAsync(int id);
    Task AgregarAsync(T entidad);
    Task ActualizarAsync(T entidad);
    Task EliminarAsync(int id);
}

3. Implementación Genérica del Repositorio

public class Repositorio<T> : IRepositorio<T> where T : class
{
    private readonly DbContext _context;
    private readonly DbSet<T> _dbSet;

    public Repository(DbContext context)
    {
        _context = context;
        _dbSet = context.Set<T>();
    }

    public async Task<IEnumerable<T>> ObtenerTodosAsync() => await _dbSet.ToListAsync();

    public async Task<T?> ObtenerPorIdAsync(int id) => await _dbSet.FindAsync(id);

    public async Task AgregarAsync(T entity)
    {
        await _dbSet AddAsync(entity);
        await _context.SaveChangesAsync();
    }

    public async Task ActualizarAsync(T entity)
    {
        _dbSet.Update(entity);
        await _context.SaveChangesAsync();
    }

    public async Task EliminarAsync(int id)
    {
        var entity = await GetByIdAsync(id);
        if (entity != null)
        {
            _dbSet.Remove(entity);
            await _context.SaveChangesAsync();
        }
    }
}

4. Servicio de Negocio

public class ProductoService
{
    private readonly IRepositorio<Producto> _repositorio;

    public ProductService(IRepositorio<Producto> repositorio)
    {
        _repositorio = repositorio;
    }

    public async Task CrearProductoAsync(Producto producto)
    {
        if (producto.Precio <= 0)
            throw new ArgumentException("El precio debe ser mayor que cero");

        await _repository.AddAsync(producto);
    }
}

5. Inyección de Dependencias en Program.cs

builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("Default")));

builder.Services.AddScoped(typeof(IRepositorio<>), typeof(Repositorio<>));
builder.Services.AddScoped<ProductoService>();

Comparativa: Repositorio Genérico vs Repositorio Específico

Recomendación: Usa un repositorio genérico para operaciones CRUD comunes y complementa con repositorios específicos cuando necesites consultas especializadas o lógica de negocio dependiente de la entidad.

Buenas Prácticas

• No coloques lógica de negocio en el repositorio. Manténla en los servicios.
• Utiliza interfaces para facilitar pruebas. Puedes usar librerías como Moq para simular la capa de datos.
• Agrega repositorios específicos solo si la entidad tiene queries complejas.

Conclusión

  El Patrón Repositorio en .NET 9.0 es mucho más que una técnica de organización: es una estrategia de arquitectura que permite construir soluciones más profesionales, escalables y mantenibles.

Ya sea que estés creando un módulo pequeño o una plataforma empresarial, este patrón puede ayudarte a entregar soluciones más robustas y preparadas para el futuro.

¿Quieres implementar este patrón en tu próximo proyecto? Contáctanos y te ayudamos a diseñar una arquitectura limpia y eficaz desde el inicio.