Padrões de projeto em Python

Padrão de projeto Proxy em Python

Nesta lição, você vai usar o padrão Proxy para adiar a criação de um objeto custoso até que ele seja realmente necessário.

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

Introdução

O problema

Alguns objetos são caros de criar, como um relatório grande ou uma conexão remota, e talvez nem sejam necessários. Outros precisam de proteção, como uma verificação de acesso antes do uso. Um proxy fica na frente do objeto real e decide quando e se vai usá-lo.

Pense assim

Um proxy é como o título de um relatório numa lista de documentos. O título é leve e está sempre ali, no lugar do arquivo pesado. O arquivo em si só é carregado na primeira vez que você o abre, e continua aberto para todas as consultas seguintes.

Da lista de documentos para o código
ReportProxy()📄 O título na lista: leve e sempre disponível
if self._report is None:🤔 O arquivo já foi carregado?
self._report = Report()📥 Carregue o relatório de verdade, uma vez só
self._report.display()📖 Mostre o conteúdo do relatório de verdade
O proxy oferece o mesmo método e controla o acesso ao objeto real.
Em uma frase

O padrão Proxy coloca um objeto substituto, com a mesma interface, na frente de um objeto real para controlar o acesso a ele.

Pontos-chave

  1. ReportProxy oferece o mesmo método display() que Report.
  2. self._report começa como None, então o relatório caro ainda não é criado.
  3. A primeira chamada a display() imprime "Loading report" e cria o Report real.
  4. As chamadas seguintes reaproveitam self._report sem carregar de novo.

Quando usar?

  • Carregamento sob demanda (lazy loading) de objetos caros, como arquivos ou imagens grandes.
  • Controle de acesso, log ou cache na frente de um objeto.
  • Substitutos locais para serviços remotos.

Quando não é preciso

  • O objeto real é barato e sempre necessário: o proxy só acrescenta uma camada.
  • O functools.cached_property do Python já dá carregamento sob demanda para um único atributo.

Código de exemplo

Executar código →
main.py
class Report:
    # Proxy: stand in for another object and control access to it.
    def display(self): return "Quarterly report"


class ReportProxy:
    def __init__(self): self._report = None

    def display(self):
        # Delay construction until the object is actually needed.
        if self._report is None:
            print("Loading report")
            self._report = Report()
        return self._report.display()


proxy = ReportProxy()
print(proxy.display())
Gerar um botão Run para este exemplo

Resultado da execução

Loading report
Quarterly report

Explicação do código

ReportProxy não cria o objeto Report ao ser inicializado. Somente quando display() é chamado pela primeira vez, o proxy imprime Loading report, cria o Report e o guarda para as próximas chamadas. Assim, objetos que consomem muitos recursos só são criados quando realmente necessário.

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

Criar o objeto real no construtor

Isso elimina a vantagem do carregamento sob demanda.

Problema
def __init__(self):
    self._report = Report()
Correção
def __init__(self):
    self._report = None

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.