Todo sistema de pedidos tem uma classe Order com uma propriedade Status . No começo são três ou quatro status, cada ação confere o status atual com um if e está tudo certo. O problema aparece meses depois, quando chega um status novo e ninguém lembra de todos os lugares que precisavam saber dele. Neste post vou mostrar um caso bem concreto disso, um estorno pago duas vezes, e como o padrão State resolve sem cerimônia. O problema O pedido passa por Pending , Paid , Shipped e Delivered , e pode ser cancelado antes do envio. Se já estava pago, o cancelamento gera estorno. O método Cancel() da versão "antes" é o tipo de código que todo mundo já escreveu: public void Cancel() { if (Status is OrderStatus.Shipped or OrderStatus.Delivered or OrderStatus.Cancelled) throw new InvalidOperationException($"Cannot cancel an order that is {Status}."); if (Status != OrderStatus.Pending) RefundCount++; Status = Orde...
Todo mundo já passou por isso: o endpoint recebe a requisição, faz um trabalho que demora (gerar um relatório, mandar e-mail, chamar um serviço lento) e o cliente fica esperando até estourar o timeout. A saída clássica é responder logo e fazer o trabalho em segundo plano. Dá para ir direto num broker como RabbitMQ, mas muitas vezes isso é canhão para matar mosquito. No .NET 8 você já tem o necessário em casa: BackgroundService e Channel<T> . A ideia A API não processa nada. Ela registra o job, coloca numa fila e devolve 202 Accepted com um Location . Do outro lado, um BackgroundService fica em loop lendo da fila e processando um job por vez. O cliente consulta GET /jobs/{id} para saber o status: Queued , Processing , Completed ou Failed . O projeto tem três peças: ChannelJobQueue (a fila), JobStore (um dicionário concorrente com o estado de cada job) e JobWorker (o consumidor). Tudo em memória, de propósito, para deixar o mecanismo à mostra. A fila O Channel.Create...