Padrões de projeto em Python

Padrão de projeto Facade em Python

Nesta lição, você vai usar o padrão Facade para oferecer uma interface simples a um sistema com várias partes complexas.

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

Introdução

O problema

Fazer um pedido pode envolver verificar o estoque, cobrar o cartão e organizar o envio, cada um com sua classe e suas regras. Se todo mundo que chama precisa coordenar tudo na ordem certa, é fácil errar. Um facade oferece uma entrada simples.

Pense assim

Um facade é como a recepção de um hotel. Você pede uma coisa, um quarto, e a recepcionista cuida da limpeza, da cobrança e das chaves nos bastidores. Você nunca fala com cada setor diretamente.

Da recepção do hotel para o código
OrderFacade().place_order()🛎️ Peça uma coisa à recepção
Inventory().reserve()📦 Um setor atrás do balcão
Payment().charge()💳 Outro setor
"Order placed"🗝️ Você recebe o resultado, não os detalhes
Um método simples na frente de vários subsistemas.
Em uma frase

O padrão Facade oferece uma interface simples para um conjunto de subsistemas mais complexos e os coordena por trás dessa interface.

Pontos-chave

  1. Inventory e Payment são subsistemas separados, com métodos próprios.
  2. place_order() chama reserve() e charge() na ordem exigida.
  3. Quem chama só precisa de OrderFacade().place_order().
  4. Os subsistemas continuam existindo para o código que precisa deles diretamente.

Quando usar?

  • Esconder um fluxo complicado atrás de uma chamada, como finalizar compra ou cadastro.
  • Dar a uma biblioteca grande uma interface pequena, focada na tarefa.
  • Reduzir de quantas classes o resto do programa depende.

Quando não é preciso

  • Quem chama realmente precisa de controle fino sobre cada subsistema.
  • O facade começa a juntar tarefas sem relação e vira uma classe gigante.

Código de exemplo

Executar código →
main.py
class Inventory:
    # Facade: expose one simple operation over several services.
    def reserve(self): return True


class Payment:
    def charge(self): return True


class OrderFacade:
    def place_order(self):
        # Coordinate subsystem operations in the required order.
        if Inventory().reserve() and Payment().charge():
            return "Order placed"
        return "Order failed"


print(OrderFacade().place_order())
Gerar um botão Run para este exemplo

Resultado da execução

Order placed

Explicação do código

O método place_order() de OrderFacade chama Inventory().reserve() para reservar o produto no estoque e só depois chama Payment().charge() para cobrar. O código externo só precisa chamar um método, sem conhecer os detalhes internos, e recebe o resultado Order placed.

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

Deixar quem chama repetir o fluxo

Cada um coordenando os subsistemas pode errar a ordem.

Problema
Payment().charge()
Inventory().reserve()  # charged before checking stock
Correção
OrderFacade().place_order()

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