Padrão de projeto Builder em Python
Nesta lição, você vai usar o padrão Builder para construir um objeto complexo em etapas bem definidas.
Introdução
O problema
Alguns objetos têm muitas partes opcionais: um relatório pode ter título, gráfico, tabela, rodapé ou qualquer mistura disso. Um construtor com dez argumentos opcionais é difícil de ler e fácil de chamar errado. Um builder adiciona as partes uma de cada vez, com clareza.
Pense assim
Um builder é como pedir um sanduíche no balcão. Você diz "pão, depois queijo, depois tomate", e o sanduíche cresce a cada instrução. Quando diz "pronto", recebe o sanduíche terminado.
ReportBuilder()🍞 Comece um pedido vazio.add_title()🧀 Adicione um ingrediente.add_chart()🍅 Adicione outro; a ordem importa.build()🥪 Entregue o sanduíche prontoO padrão Builder constrói um objeto complexo passo a passo, com métodos separados, e devolve o objeto pronto numa chamada final build.
Pontos-chave
self.partsjunta as partes adicionadas até agora.add_titleeadd_chartadicionam uma parte cada e fazemreturn self, então as chamadas podem ser encadeadas.ReportBuilder().add_title().add_chart().build()se lê como uma lista de instruções.build()transforma as partes reunidas no texto final do relatório.
Quando usar?
- Objetos com muitas partes opcionais: relatórios, requisições HTTP, consultas SQL, documentos.
- Deixar legível uma construção passo a passo com encadeamento de métodos.
- Criar variantes diferentes com os mesmos passos de construção.
Quando não é preciso
- Objetos com dois ou três campos obrigatórios: um construtor normal ou uma dataclass é mais simples.
- Código Python em que argumentos nomeados com valores padrão já deixam a chamada clara.
Código de exemplo
class ReportBuilder:
# Builder: assemble a complex value one optional part at a time.
def __init__(self):
self.parts = []
def add_title(self):
self.parts.append("title")
return self
def add_chart(self):
self.parts.append("chart")
return self
def build(self):
# Hide the final assembly behind one operation.
return "Report: " + ", ".join(self.parts)
report = ReportBuilder().add_title().add_chart().build()
print(report)
Resultado da execução
Report: title, chart
Explicação do código
Cada método, como add_title(), adiciona uma parte ao relatório e devolve o próprio objeto builder (return self). Assim, as chamadas podem ser encadeadas na mesma linha. No final, o método build() junta as partes e retorna o relatório completo, Report: title, chart.
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
Esquecer de devolver self
Sem return self, o encadeamento falha porque o método devolve None.
def add_title(self):
self.parts.append("title")
def add_title(self):
self.parts.append("title")
return self
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