JDK·클래스 기반 프록시

수동 래퍼의 위임 코드는 메서드마다 반복됩니다.

JDK 동적 프록시는 런타임에 인터페이스 구현 객체를 만들고, 노출 인터페이스의 메서드와 equals·hashCode·toString 호출을 InvocationHandler로 보냅니다. getClass처럼 Object에서 물려받은 나머지 메서드까지 모두 핸들러에 들어가는 것은 아닙니다.

클래스 기반 프록시는 대상 클래스의 하위 클래스를 생성해 인터페이스 없는 빈도 감쌉니다.

둘은 생성 방식이 다르지만 클라이언트가 프록시 참조를 호출해야 어드바이스가 실행된다는 경계는 같습니다.

InvocationHandler 입력

핸들러는 메서드 이름 문자열만 비교하지 말고 선언 타입, 애노테이션, 시그니처를 사용해 범위를 결정합니다.

Method.invoke가 대상 예외를 InvocationTargetException으로 감싸므로 원래 원인을 꺼내지 않으면 호출자 계약이 달라집니다.

package board.dynamic;

import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Proxy;

public final class JdkProxyDemo {
    interface PostCommand {
        long register(String title);
    }

    static final class Target implements PostCommand {
        @Override
        public long register(String title) {
            if (title.isBlank()) {
                throw new IllegalArgumentException("blank title");
            }
            return 41L;
        }
    }

    public static void main(String[] args) {
        var target = new Target();
        PostCommand proxy = (PostCommand) Proxy.newProxyInstance(
                PostCommand.class.getClassLoader(),
                new Class<?>[]{PostCommand.class},
                (object, method, arguments) -> {
                    long start = System.nanoTime();
                    try {
                        return method.invoke(target, arguments);
                    } catch (InvocationTargetException failure) {
                        throw failure.getCause();
                    } finally {
                        System.out.println("method=" + method.getName()
                                + " measured=" + (System.nanoTime() >= start));
                    }
                });

        System.out.println("id=" + proxy.register("dynamic proxy"));
        System.out.println("jdkProxy=" + Proxy.isProxyClass(proxy.getClass()));
    }
}

method=register measured=true
id=41
jdkProxy=true

JDK 프록시의 런타임 타입은 Target이 아닙니다.

PostCommand로 주입받아야 하며 구체 클래스를 요구하는 주입 지점은 실패합니다.

좋은 포트 인터페이스가 이미 있다면 이 제약이 아키텍처를 더 명시적으로 만들 수 있습니다.

원 Target은 final 클래스여도 JDK 예제가 성립합니다. 생성된 프록시는 Target의 하위 클래스가 아니라 PostCommand를 구현하고, 별도로 만들어 둔 Target에 위임하기 때문입니다. 반대로 아래 클래스 프록시의 WeeklyReportService는 상속 가능한 클래스이며 호출할 메서드도 재정의할 수 있어야 합니다. 두 그림의 화살표는 호출 위임이고, JDK 프록시가 Target을 상속한다는 뜻이 아닙니다.

원 핸들러는 InvocationTargetException의 cause를 꺼냅니다. register가 만든 IllegalArgumentException은 검사 예외가 아니므로 인터페이스에 throws가 없어도 그 실패를 호출자에게 전달할 수 있습니다. InvocationHandler의 throws 계약은 선언되지 않은 검사 예외가 나오는 경우를 따로 구분합니다.

Object·기본 메서드

toString, equals, hashCode 호출도 핸들러에 들어올 수 있습니다.

모든 메서드를 대상에 리플렉션 호출하면 프록시 동일성이 예상과 달라질 수 있고 로그 포매팅만으로 업무 메트릭이 증가할 수 있습니다.

어드바이스 포인트컷에서 객체 메서드를 제외하거나 명시적으로 처리합니다.

예시 원 Target은 equals를 재정의하지 않습니다. 그 핸들러로 proxy.equals(proxy)를 호출하면 method.invoke의 수신자는 target, 인자는 proxy입니다. 따라서 target.equals(proxy)의 두 객체가 달라 false가 됩니다. proxy.equals(target)는 target.equals(target)로 이어져 true인 반면 target.equals(proxy)는 false입니다. 자기 자신과의 비교와 대칭성까지 깨질 수 있어 원 위임을 일반적인 동일성 구현으로 사용하면 안 됩니다. 이 세 호출은 원 main에서 실행한 출력이 아니라 해당 핸들러의 전달값을 따라 읽은 별도 조건입니다.

JDK Proxy API의 Object 메서드 분류를 보고, equals·hashCode·toString을 명시적으로 다루는 설계와 업무 메서드 측정 범위를 나누세요.

인터페이스 기본 메서드도 프록시 구현과 JDK 버전에 따라 호출 의미를 이해해야 합니다.

Spring AOP의 인터셉터 체인을 사용하면 프레임워크가 세부를 처리하지만 포인트컷 범위는 여전히 검토합니다.

핸들러가 인자 배열을 수정하면 대상 입력이 바뀝니다.

검증 프록시처럼 의도한 경우가 아니면 불변 명령을 전달하고 관찰 어드바이스가 값을 변경하지 않게 합니다.

클래스 기반 프록시 제한

Spring ProxyFactory에 구체 대상을 넣고 setProxyTargetClass(true)를 지정하면 클래스 프록시를 만들 수 있습니다.

생성된 객체는 대상 타입으로 주입될 수 있지만 final 클래스는 상속할 수 없고 final 메서드는 재정의할 수 없습니다.

private 메서드도 외부 조인 지점이 아닙니다.

package board.dynamic;

import org.aopalliance.intercept.MethodInterceptor;
import org.springframework.aop.framework.ProxyFactory;
import org.springframework.aop.support.AopUtils;

public final class ClassProxyDemo {
    public static class WeeklyReportService {
        public int publishedPostCount(long authorId) {
            return authorId == 41L ? 12 : 0;
        }
    }

    public static void main(String[] args) {
        var factory = new ProxyFactory(new WeeklyReportService());
        factory.setProxyTargetClass(true);
        factory.addAdvice((MethodInterceptor) invocation -> {
            System.out.println("before=" + invocation.getMethod().getName());
            Object result = invocation.proceed();
            System.out.println("after=" + result);
            return result;
        });

        WeeklyReportService proxy = (WeeklyReportService) factory.getProxy();
        System.out.println("postCount=" + proxy.publishedPostCount(41L));
        System.out.println("aopProxy=" + AopUtils.isAopProxy(proxy));
    }
}

클래스 프록시가 생성자를 두 번 실행한다고 가정해 부수 효과를 두지 않습니다.

Spring은 Objenesis를 활용할 수 있지만 대상 생성과 의존성 주입은 여전히 정상 빈 생명 주기를 따라야 합니다.

프록시 방식 선택

인터페이스가 있고 클라이언트도 인터페이스로 의존하면 JDK 프록시가 충분합니다.

인터페이스 없는 애플리케이션 서비스나 구체 타입 주입을 유지해야 하면 클래스 프록시가 필요할 수 있습니다.

Boot 설정 하나로 강제하기보다 선택 이유를 기록합니다.

두 방식 모두 내부 호출을 해결하지 않습니다.

프록시 생성 기술을 바꾸는 것으로 내부 호출 애노테이션이 살아난다고 기대하지 않습니다.

리플렉션·하위 클래스 진단

스택 트레이스에 $Proxy 또는 생성된 하위 클래스 이름이 나타날 수 있습니다.

애플리케이션 로그와 메트릭에는 런타임 클래스 대신 AopUtils.getTargetClass나 안정적인 작업 이름을 사용합니다.

생성된 이름을 허용 목록 키로 저장하면 재시작마다 달라질 수 있습니다.

네이티브 이미지와 AOT 환경에서는 동적 프록시 힌트와 리플렉션 메타데이터가 필요할 수 있습니다.

Spring Boot AOT가 일반 인프라를 생성하더라도 사용자 정의 런타임 인터페이스 목록은 빌드 시점에 알려 주는 편이 안전합니다.

실제 네이티브 간이 검증으로 확인합니다.

직접·프록시 호출 비교

어드바이스 카운터를 만들고 대상에서 직접 한 번, 프록시에서 한 번 호출해 카운터가 정확히 한 번 증가하는지 봅니다.

예외 동일성, 반환 타입, 객체 메서드 제외, final 메서드 경고도 테스트합니다.

프록시 클래스 이름만 검증하면 구현 변경에 취약합니다.

연습 문제

인터페이스가 있는 명령과 인터페이스 없는 보고서 서비스에 같은 시간 측정 인터셉터를 적용하세요.

ProxyFactory가 선택한 프록시 종류, 대상 클래스, 어드바이스 개수를 출력하고 final 보고서 메서드가 가로채기되지 않는 위험을 설명하세요.

package board.dynamic;

import java.util.concurrent.atomic.AtomicInteger;

import org.aopalliance.intercept.MethodInterceptor;

public final class CountingAdvice implements MethodInterceptor {
    private final AtomicInteger calls = new AtomicInteger();

    @Override
    public Object invoke(org.aopalliance.intercept.MethodInvocation invocation)
            throws Throwable {
        calls.incrementAndGet();
        return invocation.proceed();
    }

    public int callCount() {
        return calls.get();
    }
}