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.
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.
ReportProxy()📄 O título na lista: leve e sempre disponívelif 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 verdadeO 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
ReportProxyoferece o mesmo métododisplay()queReport.self._reportcomeça como None, então o relatório caro ainda não é criado.- A primeira chamada a
display()imprime"Loading report"e cria oReportreal. - As chamadas seguintes reaproveitam
self._reportsem 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_propertydo Python já dá carregamento sob demanda para um único atributo.
Código de exemplo
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())
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.
- 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
Criar o objeto real no construtor
Isso elimina a vantagem do carregamento sob demanda.
def __init__(self):
self._report = Report()
def __init__(self):
self._report = None
Terminou esta lição?
Marque como aprendida para acompanhar seu progresso.