Patrones de diseño en Python

El patrón de diseño Visitor en Python

En esta lección vas a usar el patrón Visitor para añadir operaciones nuevas a un grupo de objetos sin modificar sus clases.

  • Avanzado
  • 3 min de lectura
  • 1 ejemplo ejecutable

Introducción

El problema

Tienes un conjunto estable de clases, como figuras o productos, y no paras de añadir operaciones nuevas: precio total, impuestos, exportar a JSON. Añadir cada operación como método en todas las clases reparte una sola función por muchos archivos.

Imagínalo así

El patrón Visitor es como un inspector de hacienda que visita tiendas distintas. Cada tienda simplemente deja pasar al inspector y dice qué tipo de tienda es. El inspector lleva las reglas para cada tipo de tienda, así que reglas nuevas significan un inspector nuevo, no cambios en cada tienda.

Del inspector de hacienda al código
item.accept(visitor)🚪 La tienda deja pasar al inspector
visitor.visit_book(self)🏷️ Dice qué tipo de tienda es
PriceVisitor🧾 El inspector con las reglas
15💰 El total de un libro y una película
La operación vive en el visitor, no en las clases de los elementos.
En una frase

El patrón Visitor saca una operación de un grupo de clases de elementos y la lleva a un objeto visitor aparte; cada elemento llama al método del visitor que corresponde a su propio tipo.

Puntos clave

  1. Book.accept llama a visitor.visit_book(self); Movie.accept llama a visitor.visit_movie(self).
  2. PriceVisitor contiene las reglas de precio de los dos tipos.
  3. sum(item.accept(visitor) for item in [Book(), Movie()]) suma 10 y 5.
  4. Una operación nueva, como los impuestos, sería una nueva clase visitor sin cambiar Book ni Movie.

¿Cuándo se usa?

  • Muchas operaciones sobre un conjunto estable de tipos: precios, exportación, dibujo.
  • Recorrer estructuras como los árboles de sintaxis en los compiladores.
  • Mantener el código de una función en un solo lugar.

Cuándo no hace falta

  • Se añaden tipos de elementos nuevos a menudo: entonces hay que actualizar cada visitor.
  • Código Python donde un diccionario de funciones por tipo o functools.singledispatch es más sencillo.

Código de ejemplo

Ejecutar código →
main.py
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()]))
Obtén un botón Run para este ejemplo

Resultado de la ejecución

15

Explicación del código

Cada elemento tiene un método accept() que llama al método correspondiente del visitante: Book llama a visit_book() y Movie llama a visit_movie(). PriceVisitor contiene toda la lógica de precios, así que las clases Book y Movie no necesitan saber nada de precios. El total es 10 + 5 = 15.

Cambia los valores y ejecuta el programa en el compilador Python online de CodeUtility sin instalar Python.

Ejercicios de práctica

Prueba a modificar el código siguiendo las ideas de abajo. Cambiar el código y ver el resultado te ayudará a entender la lección mucho mejor que solo leerla.

  1. Sustituye el dominio del ejemplo conservando la estructura del patrón.
  2. Compara el patrón con una implementación más sencilla y explica las ventajas y desventajas.
  3. Escribe pruebas para cada participante antes de añadir otra implementación.
Ejecutar en el compilador de Python →

Errores comunes

Llamar al método equivocado del visitor

Un elemento debe llamar al método de su propio tipo, o recibe las reglas equivocadas.

Problema
class Movie:
    def accept(self, visitor): return visitor.visit_book(self)
Solución
class Movie:
    def accept(self, visitor): return visitor.visit_movie(self)

¿Terminaste esta lección?

Márcala como aprendida para seguir tu progreso.