Паттерн "Заместитель" (Proxy) в Java — доступ, кэш и lazy loading

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику Архитектору

Обзор — в структурных паттернах. Здесь — Proxy на Java: объект с тем же интерфейсом, что и "настоящий" сервис, но с перехватом до/после вызова.

Загрузка редактора схем…

---

Задача паттерна

Proxy подменяет реальный объект суррогатом с тем же контрактом. Клиент вызывает прокси; прокси может проверить права, закэшировать ответ или отложить создание тяжёлого объекта.

---

Пример — документы с доступом и кэшем

import java.util.HashMap;
import java.util.Map;
import java.util.Set;

interface DocumentService {
    String loadDocument(String docId);
}

class RealDocumentService implements DocumentService {
    @Override
    public String loadDocument(String docId) {
        System.out.println("Загрузка из хранилища: " + docId);
        return "Содержимое документа " + docId;
    }
}

final class SecurityContext {
    private static final ThreadLocal<String> currentRole = new ThreadLocal<>();

    static void setCurrentRole(String role) {
        currentRole.set(role);
    }

    static String getCurrentRole() {
        return currentRole.get();
    }
}

class DocumentServiceProxy implements DocumentService {
    private final RealDocumentService realService = new RealDocumentService();
    private final Map<String, String> cache = new HashMap<>();
    private final Set<String> allowedRoles;

    DocumentServiceProxy(Set<String> allowedRoles) {
        this.allowedRoles = allowedRoles;
    }

    @Override
    public String loadDocument(String docId) {
        String role = SecurityContext.getCurrentRole();
        if (!allowedRoles.contains(role)) {
            throw new SecurityException("Нет доступа");
        }
        return cache.computeIfAbsent(docId, realService::loadDocument);
    }
}

SecurityContext.setCurrentRole("ADMIN");
DocumentService service = new DocumentServiceProxy(Set.of("ADMIN", "EDITOR"));
String doc = service.loadDocument("report-2026");

---

Виды прокси в Java

Тип	Пример
Protection	Проверка роли перед вызовом (Spring Security)
Caching	computeIfAbsent в примере выше
Lazy	Hibernate lazy-прокси сущности (JPA)
Remote	RMI, gRPC-клиент как удалённый суррогат
Logging / metrics	Spring AOP @Around

JDK динамические прокси (java.lang.reflect.Proxy) и ByteBuddy/CGLIB в Spring создают прокси во время выполнения без ручного класса-обёртки.

---

Proxy и Decorator

	Proxy	Decorator
Фокус	Контроль доступа и жизненного цикла	Добавление поведения
Клиент	Может не знать о существовании real subject	Ожидает цепочку обёрток
Пример	Lazy load, security	new BufferedInputStream(new FileInputStream(...))

---

Когда применять и риски

Прокси уместен, когда нужен прозрачный контроль без изменения клиентского кода.

Несколько слоёв прокси (AOP + security + cache) усложняют отладку и добавляют задержку — логируйте цепочку перехватчиков в dev-среде.

---

См. также

• Структурные паттерны — Заместитель
• Фасад в Java
• Цепочка обязанностей в Java