Pular para o conteúdo principal

Status de pedido sem if espalhado: o padrão State

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 = OrderStatus.Cancelled;
    }

Repare na primeira condição: ela é uma lista do que não pode. E a segunda assume que tudo que não é Pending foi pago. Enquanto o enum tinha só esses status, as duas suposições eram verdadeiras.

Aí o negócio pediu devolução. Alguém criou o status Returned e o método novo, com estorno:

    // Added later, when returns became a requirement.
    // Nobody remembered to update Cancel().
    public void Return()
    {
        if (Status != OrderStatus.Delivered)
            throw new InvalidOperationException($"Cannot return an order that is {Status}.");

        RefundCount++;
        Status = OrderStatus.Returned;
    }

O Return() está correto. O bug está no Cancel(), que ninguém abriu: Returned não está na lista de proibidos e não é Pending, então um pedido devolvido pode ser cancelado e o cliente recebe o estorno pela segunda vez. Nenhum teste quebrou, porque os testes existentes não sabiam que Returned existia. No projeto deixei um teste, Cancelling_a_returned_order_refunds_twice, que documenta exatamente esse comportamento na versão antiga.

Essa é a dor real do if por status: a regra de cada status fica espalhada por todos os métodos. Para adicionar um status você precisa revisar cada ação, e o compilador não te avisa de nenhuma.

A solução: padrão State

A ideia é inverter a pergunta. Em vez de cada ação perguntar "em que status estou?", cada status vira uma classe que sabe quais ações aceita. O pedido só guarda o estado atual e delega para ele. A classe base proíbe tudo por padrão:

// Base state: every action is forbidden unless a state allows it.
public abstract class OrderState
{
    public abstract OrderStatus Status { get; }

    public virtual OrderState Pay(Order order) => throw NotAllowed("pay");
    public virtual OrderState Ship(Order order) => throw NotAllowed("ship");
    public virtual OrderState Deliver(Order order) => throw NotAllowed("deliver");
    public virtual OrderState Cancel(Order order) => throw NotAllowed("cancel");
    public virtual OrderState Return(Order order) => throw NotAllowed("return");

    private InvalidOperationException NotAllowed(string action) =>
        new($"Cannot {action} an order that is {Status}.");

Esse "proibido por padrão" é o ponto mais importante do design. Um estado novo nasce sem permissão nenhuma, e você libera explicitamente o que faz sentido. É o oposto da lista de proibidos do Cancel() antigo.

Cada estado sobrescreve só o que permite e devolve o próximo estado. O estorno do cancelamento fica onde ele faz sentido, no estado PaidState:

public sealed class PaidState : OrderState
{
    public override OrderStatus Status => OrderStatus.Paid;

    public override OrderState Ship(Order order) => new ShippedState();

    public override OrderState Cancel(Order order)
    {
        order.IssueRefund();
        return new CancelledState();
    }
}

A classe Order da versão "depois" ficou trivial: um campo _state que começa em PendingState, e cada ação vira uma linha do tipo public void Cancel() => _state = _state.Cancel(this);. O estorno é feito por IssueRefund(), marcado como internal para que só os estados, no mesmo assembly, possam chamá-lo.

E o ReturnedState? Ele só declara o próprio Status. Não sobrescreve Cancel, então cancelar um pedido devolvido lança InvalidOperationException com "Cannot cancel an order that is Returned." sem que ninguém tenha precisado lembrar disso.

O que mudou na prática

Primeiro, o bug some por construção, não por disciplina. O teste Cancelling_a_returned_order_is_rejected confere que o cancelamento é recusado, que o status continua Returned e que o RefundCount segue em 1.

Segundo, a leitura muda. Para saber o que um pedido pago pode fazer, você abre PaidState e está tudo ali, em poucas linhas. Na versão antiga você precisava ler os cinco métodos de Order e montar a máquina de estados de cabeça.

Terceiro, a extensão fica localizada. Um status novo, como "em separação" ou "aguardando retirada", é uma classe nova mais um ajuste no estado que leva até ele. Os outros estados não são tocados. Os testes também ficam mais diretos: cada transição tem um teste curto, e as recusas são testadas pela mensagem da exceção.

Quando NÃO usar

O State tem custo, e não é pequeno. Você troca um arquivo por vários, e quem chega no código precisa entender o padrão antes de achar onde está cada regra. Para um fluxo de três status que nunca muda, um switch bem escrito é mais honesto e mais fácil de ler.

Também não compensa quando as transições são basicamente dados, sem comportamento: se a única coisa que você precisa é "de A pode ir para B ou C", uma tabela de transições (um dicionário ou até uma tabela no banco) resolve com menos código e permite mudar sem deploy. O State brilha quando cada transição carrega comportamento próprio, como o estorno aqui, envio de e-mail ou reserva de estoque.

Outro ponto de atenção é a persistência. No banco você continua gravando o enum Status, e ao carregar o pedido precisa reconstruir o objeto de estado a partir dele. É um mapeamento simples, mas é mais uma peça para manter. E se os estados começarem a acumular dependências (repositórios, gateways de pagamento), pare e pense: talvez a regra pertença a um serviço de aplicação, e o estado deva só dizer se a transição é permitida.

Minha regra prática: se você já corrigiu um bug por causa de um status esquecido em algum if, ou se o enum de status ganhou o quinto valor, vale a pena considerar o State.

Como rodar

O projeto tem as duas versões lado a lado, nas pastas Before e After, e os testes de cada uma. Basta ter o Docker instalado:

cd 2026-11-order-status-state-pattern
docker compose run --rm tests

O código completo está no GitHub: programero-csharp/2026-11-order-status-state-pattern.

Exibindo 2026-11-18-order-status-state-pattern.html…

Comentários

Mais visitadas

Como pegar valor de coluna invisível do GridView

Em determinado momento nos deparamos com a seguinte situação, nossa tabela do banco de dados possui como campo chave, um ID por exemplo, incrementado por uma rotina da aplicação, do banco ou algum outro mecanismo de incremento (sequences, increment, etc), logo não há porque mostrar essa coluna para o usuário porque o mesmo não sabe de sua existência, e seu valor não tem qualquer relevância para ele, sendo assim o mais lógico a se fazer é não mostra-lá na aplicação. Seu valor é necessário já que por se tratar de uma chave primária precisaremos dela para atualizar, inserir ou excluir os dados, então o que fazer? A resposta seria simples, deixemos ele invisível, buscaremos seu valor e o usuário não perceberá, porém a partir da versão 2005 do visual Studio as colunas setadas com "visible = false" não são renderizadas, com isso ao se tentar acessar seu valor o que recebemos é nada. Para contornarmos essa situação podemos codificar o seguinte: protected void GridView1_R...

Lista de políticos com ficha suja

ATUALIZAÇÃO (08/03/2012 ano de eleição) Representantes de duas pessoas da lista (Eliseu Padilha e Alex Canziani) entraram em contato e pediram que esses fossem removidos, alegando que não houve condenação. É justo essa requisição, porém vale lembrar que escândalos nacionalmente reconhecidos de corrupção não deram em nada, por isso o que realmente conta nesse ano de eleição é uma pesquisa minuciosa sobre os candidatos escolhidos, eu particularmente, por não estar nem um pouco satisfeito, não irei votar em ninguém que já tenha sido eleito. Estou voltando a postar por um motivo nobre, meu tempo continua apertado mas esse post é rápido, na verdade nem meu ele é (visitem o espaço de nosso amigo Lord ), estou apenas repassando essa valiosa informação. Teremos eleição esse ano, e é importante não repetirmos erros passados, vamos ficar atentos em relação a esses nomes e exclui-los de vez do cenário politico nacional. Façamos nossa parte, publicando em nossos blog...

Iniciar e Parar Serviços do Windows (Delphi)

Em certas ocasiões nos deparamos com a necessidade de manipular determinadas atividades do SO, como iniciar ou parar um banco de dados, ou qualquer outro serviço que esteja funcionando no momento. Segue abaixo um código que encontrei na Internet para tal finalidade (não me recordo à fonte, assim que eu a encontrar colocarei). Iniciar Serviço: uses WinSvc; // // start service // // return TRUE if successful // // sMachine: //   machine name, ie: \SERVER //   empty = local machine // // sService //   service name, ie: Alerter // function ServiceStart(   sMachine,   sService : string ) : boolean; var   //   // service control   // manager handle   schm,   //   // service handle   schs   : SC_Handle;   //   // service status   ss     : TServiceStatus;   //   // te...