JDK·클래스 기반 프록시

수동 래퍼의 위임 코드는 메서드마다 반복됩니다. JDK 동적 프록시는 런타임에 인터페이스 구현 객체를 만들고 모든 호출을 InvocationHandler 하나로 보냅니다. 클래스 기반 프록시는 대상 클래스의 하위 클래스를 생성해 인터페이스 없는 빈도 감쌉니다. 둘은 생성 방식이 다르지만 클라이언트가 프록시 참조를 호출해야 어드바이스가 실행된다는 경계는 같습니다.

InvocationHandler 입력

핸들러는 메서드 이름 문자열만 비교하지 말고 선언 타입, 애노테이션, 시그니처를 사용해 범위를 결정합니다. Method.invoke가 대상 예외를 InvocationTargetException으로 감싸므로 원래 원인을 꺼내지 않으면 호출자 계약이 달라집니다.

src/main/java/board/dynamic/JdkProxyDemo.java

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()));
    }
}

JdkProxyDemo 실행

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

JDK 프록시의 런타임 타입은 Target이 아닙니다. PostCommand로 주입받아야 하며 구체 클래스를 요구하는 주입 지점은 실패합니다. 좋은 포트 인터페이스가 이미 있다면 이 제약이 아키텍처를 더 명시적으로 만들 수 있습니다.

Object·기본 메서드

toString, equals, hashCode 호출도 핸들러에 들어올 수 있습니다. 모든 메서드를 대상에 리플렉션 호출하면 프록시 동일성이 예상과 달라질 수 있고 로그 포매팅만으로 업무 메트릭이 증가할 수 있습니다. 어드바이스 포인트컷에서 객체 메서드를 제외하거나 명시적으로 처리합니다.

인터페이스 기본값 메서드도 프록시 구현과 JDK 버전에 따라 호출 의미를 이해해야 합니다. Spring AOP의 인터셉터 체인을 사용하면 프레임워크가 세부를 처리하지만 포인트컷 범위는 여전히 검토합니다.

핸들러가 인자 배열을 수정하면 대상 입력이 바뀝니다. 검증 프록시처럼 의도한 경우가 아니면 불변 명령을 전달하고 관찰 어드바이스가 값을 변경하지 않게 합니다.

클래스 기반 프록시 제한

Spring ProxyFactory에 구체 대상을 넣고 setProxyTargetClass(true)를 지정하면 클래스 프록시를 만들 수 있습니다. 생성된 객체는 대상 타입으로 주입될 수 있지만 final 클래스와 final 메서드는 재정의할 수 없습니다. private 메서드도 외부 조인 지점이 아닙니다.

src/main/java/board/dynamic/ClassProxyDemo.java

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 설정 하나로 강제하기보다 선택 이유를 기록합니다.

조건	JDK 프록시	Class 프록시
필요한 계약	인터페이스	하위 클래스 가능한 클래스
주입 타입	인터페이스 권장	구체 가능
`final` 메서드	인터페이스 호출 가능	가로채기 불가
`private` 자기 호출	가로채기 불가	가로채기 불가
프록시 타입 형 변환	대상 클래스 불가	대상 클래스 가능

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

한 어드바이스 인스턴스를 두 팩토리에 재사용할 수 있지만 변경 가능한 호출 상태를 필드에 두면 동시성 문제가 생깁니다. 카운터가 필요하면 스레드-안전 미터를 주입합니다.

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();
    }
}

테스트는 JDK 프록시를 구체 대상으로 형 변환하지 않고 노출된 인터페이스로 호출합니다.

InvocationHandler 입력

Object·기본 메서드

클래스 기반 프록시 제한

프록시 방식 선택

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

직접·프록시 호출 비교

연습 문제

이 페이지의 목차