Padrões de projeto em Python

Padrão de projeto State em Python

Nesta lição, você vai usar o padrão State para mudar o comportamento de um objeto quando o seu estado interno muda.

  • Avançado
  • 3 min de leitura
  • 1 exemplo executável

Introdução

O problema

Um player de mídia se comporta de um jeito tocando, de outro pausado e de outro parado. Escrever um método enorme cheio de verificações if state == ... faz cada estado novo mexer em todos os métodos. O padrão State dá a cada estado o seu próprio objeto.

Pense assim

O padrão State é como o botão único de tocar/pausar de um player de música. O mesmo toque faz coisas diferentes dependendo do que o player está fazendo no momento: pausa quando está tocando e toca quando está pausado. Mudar o estado troca o que o botão faz, sem precisar montar o player de novo.

Do botão de tocar/pausar para o código
Paused(), Playing()⏯️ As duas coisas que o player pode estar fazendo
self.state💡 O que ele está fazendo agora
player.set_state(Playing())🔁 Passe para o outro estado
self.state.action()👆 O botão pergunta ao estado atual o que fazer
O objeto de estado atual decide como o player se comporta.
Em uma frase

O padrão State permite que um objeto mude de comportamento quando o seu estado interno muda, delegando para um objeto separado para cada estado.

Pontos-chave

  1. Playing e Paused têm um método action().
  2. Player começa no estado Paused.
  3. set_state troca o objeto de estado atual.
  4. Player.action() delega para self.state.action(), então o resultado muda com o estado.

Quando usar?

  • Objetos com modos claros: players de mídia, pedidos, conexões, personagens de jogo.
  • Substituir grandes cadeias de if / elif sobre um campo de status.
  • Fluxos em que cada etapa permite ações diferentes.

Quando não é preciso

  • Dois estados simples com uma pequena diferença: uma flag booleana basta.
  • Estados que compartilham quase todo o comportamento: classes separadas duplicam código.

Código de exemplo

Executar código →
main.py
class Playing:
    # State: delegate behavior to the current state object.
    def action(self): return "Playing"


class Paused:
    def action(self): return "Paused"


class Player:
    def __init__(self): self.state = Paused()
    def set_state(self, state): self.state = state

    def action(self):
        # Behavior comes from the current state object.
        return self.state.action()


player = Player()
player.set_state(Playing())
print(player.action())
player.set_state(Paused())
print(player.action())
Gerar um botão Run para este exemplo

Resultado da execução

Playing
Paused

Explicação do código

O método action() de Player não faz o trabalho sozinho: ele delega ao objeto de estado atual. Depois de set_state(Playing()), o resultado é Playing. Ao mudar para set_state(Paused()), a mesma chamada action() resulta em Paused. Para adicionar um estado novo, basta criar mais uma classe de estado.

Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.

Exercícios práticos

Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.

  1. Substitua o domínio do exemplo preservando a estrutura do padrão.
  2. Compare o padrão com uma implementação mais simples e explique as diferenças.
  3. Escreva testes para cada participante antes de adicionar outra implementação.
Executar no compilador Python →

Erros comuns

Verificar o estado com if

Cada estado novo exige editar todos os métodos.

Problema
def action(self):
    if self.state == "playing":
        return "Playing"
    return "Paused"
Correção
def action(self):
    return self.state.action()

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios