Código
Basado en el problema que fui el primero en resolver en Totalplay
Recuperación de la Exception Queue de Oracle AQ
Miles de clientes atorados, sin que nadie lo supiera.
15 archivos729 líneas de código 9/9 pruebas
namespace AqRecovery;
/// <summary>Mensaje leído de la exception queue.</summary>
public sealed record QueueMessage(
string MessageId,
string? CorrelationId,
byte[] Payload,
DateTimeOffset EnqueuedAt);
public enum RecoveryActionKind
{
/// <summary>Se regresa a la cola original con un retraso para reintentar.</summary>
Requeue,
/// <summary>Se aparta para revisión humana. Nunca se descarta en silencio.</summary>
ManualReview,
}
public sealed record RecoveryAction(RecoveryActionKind Kind, TimeSpan Delay, string Reason)
{
public static RecoveryAction Requeue(TimeSpan delay, string reason) => new(RecoveryActionKind.Requeue, delay, reason);
public static RecoveryAction Review(string reason) => new(RecoveryActionKind.ManualReview, TimeSpan.Zero, reason);
}
/// <summary>
/// Unidad de trabajo transaccional: desencolar de la exception queue y reencolar (o apartar)
/// ocurre en la misma transacción. Si algo falla antes de <see cref="CommitAsync"/>,
/// el mensaje regresa a la exception queue y nada se pierde.
/// </summary>
public interface IRecoveryUnitOfWork : IAsyncDisposable
{
Task<QueueMessage?> DequeueAsync(CancellationToken cancellationToken);
Task RequeueAsync(QueueMessage message, TimeSpan delay, CancellationToken cancellationToken);
Task MoveToManualReviewAsync(QueueMessage message, string reason, CancellationToken cancellationToken);
Task RecordAuditAsync(AuditEntry entry, CancellationToken cancellationToken);
Task CommitAsync(CancellationToken cancellationToken);
}
public interface IRecoveryGateway
{
Task<IRecoveryUnitOfWork> BeginAsync(CancellationToken cancellationToken);
/// <summary>Cuántas veces ya se intentó recuperar este mensaje (según la bitácora).</summary>
Task<int> GetRecoveryAttemptsAsync(string correlationKey, CancellationToken cancellationToken);
}
/// <summary>Registro de auditoría. No incluye el contenido del mensaje: puede tener datos personales.</summary>
public sealed record AuditEntry(
string MessageId,
string? CorrelationId,
string SourceQueue,
RecoveryActionKind Action,
string Reason,
int Attempt);