Padrões de projeto em Python

Padrão de projeto Composite em Python

Nesta lição, você vai usar o padrão Composite para tratar objetos individuais e grupos de objetos da mesma forma.

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

Introdução

O problema

Pastas contêm arquivos e outras pastas; um menu contém itens e submenus; uma expressão contém números e expressões menores. Código que precisa perguntar o tempo todo "isto é um item só ou um grupo?" vira bagunça. O Composite deixa os dois responderem à mesma chamada.

Pense assim

O padrão Composite é como perguntar o peso total de um pacote. Um item sozinho sabe o próprio peso. Uma caixa pergunta a cada item dentro dela, inclusive a caixas menores, e soma as respostas. Você faz à caixa de fora a mesma pergunta que faria a um item sozinho.

De caixas dentro de caixas para o código
Number(1)📦 Um item sozinho: sabe o próprio peso
Sum(...)🗃️ Uma caixa com itens e caixas menores
sum(child.total() for child in self.children)➕ A caixa pergunta a cada filho e soma
expression.total()⚖️ Uma pergunta para o pacote inteiro: 6
Folhas e grupos respondem à mesma chamada.
Em uma frase

O padrão Composite trata objetos isolados e grupos de objetos pela mesma interface, assim uma árvore deles pode ser usada como um único objeto.

Pontos-chave

  1. Number.total() devolve o próprio valor: é uma folha.
  2. Sum.total() chama total() em cada filho e soma os resultados.
  3. Um filho de Sum pode ser outro Sum, o que faz da estrutura uma árvore.
  4. expression.total() devolve 6 sem que quem chama verifique o tipo de cada parte.

Quando usar?

  • Estruturas em árvore: pastas e arquivos, menus e submenus, organogramas.
  • Expressões e documentos feitos de partes aninhadas.
  • Aplicar uma operação a uma hierarquia inteira.

Quando não é preciso

  • Coleções planas, sem aninhamento: uma lista simples basta.
  • Folhas e grupos precisam de operações muito diferentes: forçar uma interface única cria métodos estranhos.

Código de exemplo

Executar código →
main.py
class Number:
    # Composite: leaves and containers expose the same operation.
    def __init__(self, value): self.value = value
    def total(self): return self.value


class Sum:
    def __init__(self, *children): self.children = children

    def total(self):
        # Treat leaves and nested groups uniformly.
        return sum(child.total() for child in self.children)


expression = Sum(Number(1), Sum(Number(2), Number(3)))
print(expression.total())
Gerar um botão Run para este exemplo

Resultado da execução

6

Explicação do código

Tanto Number quanto Sum têm o método total(). Number retorna o próprio valor, e Sum chama total() de cada filho e soma os resultados. Como um Sum pode conter outro Sum, a expressão Sum(Number(1), Sum(Number(2), Number(3))) é calculada de forma recursiva e resulta em 6.

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 tipos em vez de usar o método comum

Verificações com isinstance quebram quando aparece um novo tipo de nó.

Problema
if isinstance(child, Number):
    total += child.value
Correção
total += child.total()

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