Name: Interceptor.AOP
Author: Julio Cesar Bautista Monsalvo

Interceptor.AOP — nugetz

dotnet add package Interceptor.AOP

services.AddSingleton(provider =>
{
    var logger = provider.GetRequiredService<ILogger<ProcesarDatosService>>();
    var memoryCache = provider.GetRequiredService<IMemoryCache>();

    // Instancia real del servicio
    var real = new ProcesarDatosService(logger);

    // Proxy con interceptor
    return ProxyFactory.Create<IProcesarDatosService>(
        real,
        logger,
        memoryCache,
        new InterceptorOptions
        {
            EnableRetries = true,
            EnableValidation = true,
            EnableTiming = true
        });
});

public interface IProcesarDatosService
{
    [Audit("ProcesarArchivo", LogInput = true)]
    [Retry(3, 200)]
    [Fallback("FallbackProcesarArchivo")]
    [MeasureTime]
    [Validate]
    [Cache(60)]
    int ProcesarArchivo(int number);

    // El método fallback puede opcionalmente recibir la excepción lanzada
    int FallbackProcesarArchivo(int number, Exception? ex = null);
}

public class ProcesarDatosService : IProcesarDatosService
{
    private readonly ILogger<ProcesarDatosService> _logger;

    public ProcesarDatosService(ILogger<ProcesarDatosService> logger)
    {
        _logger = logger;
    }

    public int ProcesarArchivo(int number)
    {
        _logger.LogInformation("📊 Calculando algo con {number}", number);
        if (number < 0) throw new Exception("Valor negativo no permitido");
        return number * 10;
    }

    public int FallbackProcesarArchivo(int number, Exception? ex = null)
    {
        _logger.LogWarning("⚠️ Fallback ejecutado para {number}. Excepcion: {ex}", number, ex?.Message);
        return -1;
    }
}

	Decorador	Description
📝	`[Audit]`	Auditoría flexible: entrada, salida y manejo de excepciones con contexto
🔁	`[Retry(n, delayMs)]`	Reintenta el método n veces (opcional espera entre intentos en milisegundos y filtrado por tipos de excepción)
🛡️	`[Fallback("...")]`	Llama a otro método si el actual falla
⏱️	`[MeasureTime]`	Logea cuánto tarda la ejecución del método
🧪	`[Validate]`	Validaciones automáticas con DataAnnotations
🔐	`[Cache(n)]`	Cachea el resultado por n segundos (solo para Task<T> y métodos síncronos)

[Audit]
public Task<string> ObtenerClientesAsync() { ... }

[Audit("ProcesarArchivo")]
public void ProcesarArchivo(string path) { ... }

[Audit(LogInput = false, LogOutput = false, LogError = true)] // Solo errores

[Audit(Contexto = "Importación", LogOutput = false)] // Entrada + error

[Audit(LogInput = false, LogOutput = true, LogError = false)] // Solo salida

[Retry(3, 200)]
public void ProcesarArchivo() { ... }

[Retry(3, ExceptionTypes = new[] { typeof(HttpRequestException) })]
public void LlamarApi() { ... }

[Fallback("ProcesarArchivoFallback")]
public void ProcesarArchivo() { ... }

public void ProcesarArchivoFallback(Exception ex) { ... }

[MeasureTime]
public void CalcularEstadisticas() { ... }

⏱️ CalcularEstadisticas ejecutado en 215ms

[Validate]
public void GuardarCliente(ClienteModel cliente) { ... }

public class ClienteModel
{
    [Required]
    public string Nombre { get; set; }
}

[Cache(60)]
public async Task<string> ObtenerDatos() => "Desde API";

JCBautistaM/Interceptor.AOPv1.3.12

Get Started

Readme

📦 Interceptor.AOP

Descripción general

🎯 Propósito

Centralizar y estandarizar:

🚀 Características

📥 Instalación

Desde NuGet:

🧩 Configuración manual (ProxyFactory)

Ejemplo de uconfiguración en Program.cs o Startup.cs

Ejemplo de uso de decoradores

Ejemplo de implementacion

📚 Atributos disponibles

📝[Audit] - Auditoría flexible

Auditoría avanzada

Por defecto

Con contexto funcional

Auditoría selectiva

🔁 [Retry(n, delayMs)] - Reintentos automáticos

🛑 [Fallback("MetodoAlternativo")] - Método alternativo en caso de error

⏱️ [MeasureTime] - Medición de rendimiento

🧪 [Validate] - Validación automática

🧠 [Cache(segundos)] - Cache automático en memoria

Author