[스프링 핵심 원리 - 고급편] #07. 스프링이 지원하는 프록시(3)

[YuDeokRin]

8️⃣ 프록시 팩토리 - 적용 1

• 프록시팩토리를 통해서 애플리케이션에 프록시를 만들어보기
• 인터페이스가 있는 v1 애플리케이션에 LogTrace 기능을 프록시 팩토리를 통해서 프록시를 만들어 적용해보자.

➡️ LogTraceAdvice

package hello.proxy.config.v3_proxyfactory.advice;

import hello.proxy.trace.TraceStatus;
import hello.proxy.trace.logtrace.LogTrace;
import org.aopalliance.intercept.MethodInterceptor;
import org.aopalliance.intercept.MethodInvocation;

import java.lang.reflect.Method;

public class LogTraceAdvice implements MethodInterceptor {

    private final LogTrace logTrace;

    public LogTraceAdvice(LogTrace logTrace) {
        this.logTrace = logTrace;
    }

    @Override
    public Object invoke(MethodInvocation invocation) throws Throwable {
        TraceStatus status = null;

        try {

            Method method = invocation.getMethod();

            String message = method.getDeclaringClass().getSimpleName() + "."
                    + method.getName() + "()";
            status = logTrace.begin(message);
            //로직 호출
            Object result = invocation.proceed();

            logTrace.end(status);
            return result;
        } catch (Exception e) {
            logTrace.exception(status, e);
            throw e;
        }

    }
}

➡️ ProxyFactoryConfigV1

package hello.proxy.config.v3_proxyfactory;

import hello.proxy.app.v1.*;
import hello.proxy.config.v3_proxyfactory.advice.LogTraceAdvice;
import hello.proxy.trace.logtrace.LogTrace;
import lombok.extern.slf4j.Slf4j;
import org.springframework.aop.Advisor;
import org.springframework.aop.framework.ProxyFactory;
import org.springframework.aop.support.DefaultPointcutAdvisor;
import org.springframework.aop.support.NameMatchMethodPointcut;
import org.springframework.aop.support.NameMatchMethodPointcutAdvisor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Slf4j
@Configuration
public class ProxyFactoryConfigV1 {

    @Bean
    public OrderControllerV1 orderControllerV1(LogTrace logTrace) {
        OrderControllerV1 orderController = new OrderControllerV1Impl(orderServiceV1(logTrace));

        ProxyFactory factory = new ProxyFactory(orderController);
        factory.addAdvisor(getAdvisor(logTrace));

        OrderControllerV1 proxy = (OrderControllerV1) factory.getProxy();

        log.info("ProxyFactory proxy={}, target={}", proxy.getClass(), orderController.getClass());

        return proxy;
    }

    @Bean
    public OrderServiceV1 orderServiceV1(LogTrace logTrace) {
        OrderServiceV1Impl orderService = new OrderServiceV1Impl(orderRepositoryV1(logTrace));

        ProxyFactory factory = new ProxyFactory(orderService);
        factory.addAdvisor(getAdvisor(logTrace));

        OrderServiceV1 proxy = (OrderServiceV1) factory.getProxy();
        log.info("ProxyFactory proxy={}, target={}", proxy.getClass(), orderService.getClass());

        return proxy;

    }

    @Bean
    public OrderRepositoryV1 orderRepositoryV1(LogTrace logTrace) {
        OrderRepositoryV1Impl orderRepository = new OrderRepositoryV1Impl();

        // 프록시 팩토리에 각각 taget, advisor를 등록해서 프록시를 생성한다. 그리고 생성된 프록시를 스프링 빈으로 등록한다.
        ProxyFactory factory = new ProxyFactory(orderRepository);
        factory.addAdvisor(getAdvisor(logTrace));

        OrderRepositoryV1 proxy = (OrderRepositoryV1)factory.getProxy();
        log.info("ProxyFactory proxy={}, target={}", proxy.getClass(), orderRepository.getClass());
        return proxy;
    }

    private Advisor getAdvisor(LogTrace logTrace) {
        //pointcut
        NameMatchMethodPointcut pointcut = new NameMatchMethodPointcut(); // 여기에는 심플 매칭 기능이 있어서 *을 매칭할 수 있다
        pointcut.setMappedNames("request*", "order*", "save*"); // 메서드에 포인트컷은 true를 반환한다.
        // 이렇게 설정한 이유는 noLog() 메서드에는 어드바이스를 적용하지 않기 위해서.

        //advice = pontcut + advice
        LogTraceAdvice advice = new LogTraceAdvice(logTrace);

        return new DefaultPointcutAdvisor(pointcut, advice);
    }
}

➡️ ProxyApplication

package hello.proxy;

import hello.proxy.config.v1_proxy.ConcreteProxyConfig;
import hello.proxy.config.v2_dynamicproxy.DynamicProxyBasicConfig;
import hello.proxy.config.v3_proxyfactory.ProxyFactoryConfigV1;
import hello.proxy.config.v3_proxyfactory.advice.ProxyFactoryConfigV2;
import hello.proxy.trace.logtrace.LogTrace;
import hello.proxy.trace.logtrace.ThreadLocalLogTrace;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Import;

//@Import({AppV1Config.class, AppV2Config.class})
//@Import(InterfaceProxyConfig.class)
//@Import(ConcreteProxyConfig.class)
//@Import(DynamicProxyBasicConfig.class)
@Import(ProxyFactoryConfigV1.class) // 변경 
@SpringBootApplication(scanBasePackages = "hello.proxy.app") //주의
public class ProxyApplication {

	public static void main(String[] args) {
		SpringApplication.run(ProxyApplication.class, args);
	}

	@Bean
	public LogTrace logTrace() {
		return new ThreadLocalLogTrace();
	}

}

• 애플리케이션 로딩 로그

2025-04-11 17:04:22.205  INFO 49331 --- [           main] h.p.c.v.ProxyFactoryConfigV1             : ProxyFactory proxy=class com.sun.proxy.$Proxy50, target=class hello.proxy.app.v1.OrderRepositoryV1Impl
2025-04-11 17:04:22.207  INFO 49331 --- [           main] h.p.c.v.ProxyFactoryConfigV1             : ProxyFactory proxy=class com.sun.proxy.$Proxy52, target=class hello.proxy.app.v1.OrderServiceV1Impl
2025-04-11 17:04:22.217  INFO 49331 --- [           main] h.p.c.v.ProxyFactoryConfigV1             : ProxyFactory proxy=class com.sun.proxy.$Proxy53, target=class hello.proxy.app.v1.OrderControllerV1Impl

• 결과
  • http://localhost:8080/v1/request?itemId=hello

2025-04-11 17:02:41.548  INFO 49307 --- [nio-8080-exec-6] h.p.trace.logtrace.ThreadLocalLogTrace   : [9fb90236] OrderControllerV1.request()
2025-04-11 17:02:41.555  INFO 49307 --- [nio-8080-exec-6] h.p.trace.logtrace.ThreadLocalLogTrace   : [9fb90236] |-->OrderServiceV1.orderItem()
2025-04-11 17:02:41.556  INFO 49307 --- [nio-8080-exec-6] h.p.trace.logtrace.ThreadLocalLogTrace   : [9fb90236] |   |-->OrderRepositoryV1.save()
2025-04-11 17:02:42.562  INFO 49307 --- [nio-8080-exec-6] h.p.trace.logtrace.ThreadLocalLogTrace   : [9fb90236] |   |<--OrderRepositoryV1.save() time=1005ms
2025-04-11 17:02:42.576  INFO 49307 --- [nio-8080-exec-6] h.p.trace.logtrace.ThreadLocalLogTrace   : [9fb90236] |<--OrderServiceV1.orderItem() time=1021ms
2025-04-11 17:02:42.577  INFO 49307 --- [nio-8080-exec-6] h.p.trace.logtrace.ThreadLocalLogTrace   : [9fb90236] OrderControllerV1.request() time=1029ms

9️⃣ 프록시 팩토리 - 적용 2

• 인터페이스가 없고 구체 클래스만 있는 v2 애플리케이션에 LogTrace 기능을 프록시 팩토리를 통해서 프록시를 만들어 적용해보자.

➡️  ProxyFactoryConfigV2

package hello.proxy.config.v3_proxyfactory;

import hello.proxy.app.v2.OrderControllerV2;
import hello.proxy.app.v2.OrderRepositoryV2;
import hello.proxy.app.v2.OrderServiceV2;
import hello.proxy.config.v3_proxyfactory.advice.LogTraceAdvice;
import hello.proxy.trace.logtrace.LogTrace;
import lombok.extern.slf4j.Slf4j;
import org.springframework.aop.Advisor;
import org.springframework.aop.framework.ProxyFactory;
import org.springframework.aop.support.DefaultPointcutAdvisor;
import org.springframework.aop.support.NameMatchMethodPointcut;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Slf4j
@Configuration
public class ProxyFactoryConfigV2 {

    @Bean
    public OrderControllerV2 orderControllerV2(LogTrace logTrace) {
        OrderControllerV2 orderController = new OrderControllerV2(orderServiceV2(logTrace));

        ProxyFactory factory = new ProxyFactory(orderController);
        factory.addAdvisor(getAdvisor(logTrace));

        OrderControllerV2 proxy = (OrderControllerV2) factory.getProxy();

        log.info("ProxyFactory proxy={}, target={}", proxy.getClass(), orderController.getClass());

        return proxy;
    }

    @Bean
    public OrderServiceV2 orderServiceV2(LogTrace logTrace) {
        OrderServiceV2 orderService = new OrderServiceV2(orderRepositoryV2(logTrace));

        ProxyFactory factory = new ProxyFactory(orderService);
        factory.addAdvisor(getAdvisor(logTrace));

        OrderServiceV2 proxy = (OrderServiceV2) factory.getProxy();
        log.info("ProxyFactory proxy={}, target={}", proxy.getClass(), orderService.getClass());

        return proxy;

    }

    @Bean
    public OrderRepositoryV2 orderRepositoryV2(LogTrace logTrace) {
        OrderRepositoryV2 orderRepository = new OrderRepositoryV2();

        ProxyFactory factory = new ProxyFactory(orderRepository);
        factory.addAdvisor(getAdvisor(logTrace));

        OrderRepositoryV2 proxy = (OrderRepositoryV2)factory.getProxy();
        log.info("ProxyFactory proxy={}, target={}", proxy.getClass(), orderRepository.getClass());
        return proxy;
    }

    private Advisor getAdvisor(LogTrace logTrace) {
        //pointcut
        NameMatchMethodPointcut pointcut = new NameMatchMethodPointcut();
        pointcut.setMappedNames("request*", "order*", "save*");

        //advice
        LogTraceAdvice advice = new LogTraceAdvice(logTrace);

        return new DefaultPointcutAdvisor(pointcut, advice);
    }
}

➡️ ProxyApplication

package hello.proxy;

import hello.proxy.config.v3_proxyfactory.ProxyFactoryConfigV1;
import hello.proxy.config.v3_proxyfactory.ProxyFactoryConfigV2;
import hello.proxy.trace.logtrace.LogTrace;
import hello.proxy.trace.logtrace.ThreadLocalLogTrace;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Import;

//@Import({AppV1Config.class, AppV2Config.class})
//@Import(InterfaceProxyConfig.class)
//@Import(ConcreteProxyConfig.class)
//@Import(DynamicProxyBasicConfig.class)
//@Import(ProxyFactoryConfigV1.class)
@Import(ProxyFactoryConfigV2.class)
@SpringBootApplication(scanBasePackages = "hello.proxy.app") //주의
public class ProxyApplication {

	public static void main(String[] args) {
		SpringApplication.run(ProxyApplication.class, args);
	}

	@Bean
	public LogTrace logTrace() {
		return new ThreadLocalLogTrace();
	}

}

• 애플리케이션 로딩 로그

2025-04-11 17:09:05.015  INFO 49356 --- [           main] h.p.c.v.ProxyFactoryConfigV2             : ProxyFactory proxy=class hello.proxy.app.v2.OrderRepositoryV2$$EnhancerBySpringCGLIB$$3df230e7, target=class hello.proxy.app.v2.OrderRepositoryV2
2025-04-11 17:09:05.025  INFO 49356 --- [           main] h.p.c.v.ProxyFactoryConfigV2             : ProxyFactory proxy=class hello.proxy.app.v2.OrderServiceV2$$EnhancerBySpringCGLIB$$92425f0a, target=class hello.proxy.app.v2.OrderServiceV2
2025-04-11 17:09:05.030  INFO 49356 --- [           main] h.p.c.v.ProxyFactoryConfigV2             : ProxyFactory proxy=class hello.proxy.app.v2.OrderControllerV2$$EnhancerBySpringCGLIB$$3ff9579d, target=class hello.proxy.app.v2.OrderControllerV2

• 결과

2025-04-11 17:10:08.675  INFO 49356 --- [nio-8080-exec-1] h.p.trace.logtrace.ThreadLocalLogTrace   : [4a5cae42] OrderControllerV2.request()
2025-04-11 17:10:08.688  INFO 49356 --- [nio-8080-exec-1] h.p.trace.logtrace.ThreadLocalLogTrace   : [4a5cae42] |-->OrderServiceV2.orderItem()
2025-04-11 17:10:08.697  INFO 49356 --- [nio-8080-exec-1] h.p.trace.logtrace.ThreadLocalLogTrace   : [4a5cae42] |   |-->OrderRepositoryV2.save()
2025-04-11 17:10:09.706  INFO 49356 --- [nio-8080-exec-1] h.p.trace.logtrace.ThreadLocalLogTrace   : [4a5cae42] |   |<--OrderRepositoryV2.save() time=1008ms
2025-04-11 17:10:09.708  INFO 49356 --- [nio-8080-exec-1] h.p.trace.logtrace.ThreadLocalLogTrace   : [4a5cae42] |<--OrderServiceV2.orderItem() time=1020ms
2025-04-11 17:10:09.708  INFO 49356 --- [nio-8080-exec-1] h.p.trace.logtrace.ThreadLocalLogTrace   : [4a5cae42] OrderControllerV2.request() time=1033ms

🔟 정리

• 프록시 팩토리에 도움을 받아 편리하게 프록시를 생성할 수 있게 되었다.

✅ 남은 문제

• 프록시 팩토리와 어드바이저 같은 개념 덕분에 지금까지 고민했던 문제들은 해결되었다. 프록시도 깔끔하게 적용하고 포인트컷으로 어디에 부가 기능을 적용할지도 명확하게 정의할 수 있다.
• 원본 코드를 전혀 손대지 않고 프록시를 통해 부가 기능도 적용할 수 있었다. 그런데 아직 해결되지 않는 문제가 있다.

✅  문제 1 - 너무 많은 설정

• 바로 ProxyFactoryConfigV1 , ProxyFactoryConfigV2 와 같은 설정 파일이 지나치게 많다는 점이다.
• 예를 들어서 애플리케이션에 스프링 빈이 100개가 있다면 여기에 프록시를 통해 부가 기능을 적용하려면 100개의 동적 프록시 생성 코드를 만들어야 한다
• 무수히 많은 설정 파일 때문에 설정 지옥을 경험하게 될 것이다.
• 최근에는 스프링 빈을 등록하기 귀찮아서 컴포넌트 스캔까지 사용하는데, 이렇게 직접 등록하는 것도 모자라서, 프록시를 적용하는 코드까지 빈 생성 코드에 넣어야 한다.

✅ 문제 2 - 컴포넌트 스캔

• 애플리케이션 V3처럼 컴포넌트 스캔을 사용하는 경우 지금까지 학습한 방법으로는 프록시 적용이 불가능하다.
• 왜냐하면 실제 객체를 컴포넌트 스캔으로 스프링 컨테이너에 스프링 빈으로 등록을 다 해버린 상태이기 때문이다.
• 지금까지 학습한 프록시를 적용하려면, 실제 객체를 스프링 컨테이너에 빈으로 등록하는 것이 아니라
  ProxyFactoryConfigV1 에서 한 것 처럼, 부가 기능이 있는 프록시를 실제 객체 대신 스프링 컨테이너에 빈으로 등록해야 한다.