Padrão de projeto Visitor em Python
Nesta lição, você vai usar o padrão Visitor para adicionar novas operações a um grupo de objetos sem alterar as suas classes.
Introdução
O problema
Você tem um conjunto estável de classes, como formas ou produtos, e vive adicionando operações novas: preço total, imposto, exportar para JSON. Adicionar cada operação como método em todas as classes espalha um recurso por muitos arquivos.
Pense assim
O padrão Visitor é como um fiscal visitando lojas diferentes. Cada loja só deixa o fiscal entrar e diz que tipo de loja é. O fiscal traz as regras para cada tipo de loja, então regras novas significam um fiscal novo, não mudanças em todas as lojas.
item.accept(visitor)🚪 A loja deixa o fiscal entrarvisitor.visit_book(self)🏷️ Ela diz que tipo de loja éPriceVisitor🧾 O fiscal com as regras15💰 O total de um livro e um filmeO padrão Visitor tira uma operação de um grupo de classes de elementos e a coloca num objeto visitor separado; cada elemento chama o método do visitor que corresponde ao seu próprio tipo.
Pontos-chave
Book.acceptchamavisitor.visit_book(self);Movie.acceptchamavisitor.visit_movie(self).PriceVisitorguarda as regras de preço dos dois tipos.sum(item.accept(visitor) for item in [Book(), Movie()])soma 10 e 5.- Uma operação nova, como imposto, seria uma nova classe visitor sem mudar
BooknemMovie.
Quando usar?
- Muitas operações sobre um conjunto estável de tipos: preços, exportação, desenho.
- Percorrer estruturas como árvores sintáticas em compiladores.
- Manter o código de um recurso num só lugar.
Quando não é preciso
- Tipos de elementos novos aparecem com frequência: aí todo visitor precisa ser atualizado.
- Código Python em que um dicionário de funções por tipo ou
functools.singledispatché mais simples.
Código de exemplo
class Book:
# Visitor: move new operations outside stable element classes.
def accept(self, visitor): return visitor.visit_book(self)
class Movie:
def accept(self, visitor): return visitor.visit_movie(self)
class PriceVisitor:
def visit_book(self, book): return 10
def visit_movie(self, movie): return 5
# Each element dispatches to the matching visitor method.
visitor = PriceVisitor()
print(sum(item.accept(visitor) for item in [Book(), Movie()]))
Resultado da execução
15
Explicação do código
Cada elemento tem o método accept(), que chama o método correspondente do visitor: Book chama visit_book() e Movie chama visit_movie(). PriceVisitor concentra toda a lógica de preço, então as classes Book e Movie não precisam saber nada sobre preços. O total é 10 + 5 = 15.
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
Chamar o método errado do visitor
Um elemento precisa chamar o método do seu próprio tipo, senão recebe as regras erradas.
class Movie:
def accept(self, visitor): return visitor.visit_book(self)
class Movie:
def accept(self, visitor): return visitor.visit_movie(self)
Terminou esta lição?
Marque como aprendida para acompanhar seu progresso.