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.
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.
Number(1)📦 Um item sozinho: sabe o próprio pesoSum(...)🗃️ Uma caixa com itens e caixas menoressum(child.total() for child in self.children)➕ A caixa pergunta a cada filho e somaexpression.total()⚖️ Uma pergunta para o pacote inteiro: 6O 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
Number.total()devolve o próprio valor: é uma folha.Sum.total()chamatotal()em cada filho e soma os resultados.- Um filho de
Sumpode ser outroSum, o que faz da estrutura uma árvore. 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
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())
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.
- Substitua o domínio do exemplo preservando a estrutura do padrão.
- Compare o padrão com uma implementação mais simples e explique as diferenças.
- Escreva testes para cada participante antes de adicionar outra implementação.
Erros comuns
Verificar tipos em vez de usar o método comum
Verificações com isinstance quebram quando aparece um novo tipo de nó.
if isinstance(child, Number):
total += child.value
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