[스프링 핵심원리 - 고급편] #6. 동적 프록시 기술(3)

[YuDeokRin]

6️⃣ CGLIB - 소개

• CGLIB(Code Generator Library)란 ?
  • CGLIB는 바이트코드를 조작해서 동적으로 클래스를 생성하는 기술을 제공하는 라이브러리이다.
  • CGLIB를 사용하면 인터페이스가 없어도 구체 클래스만 가지고 동적 프록시를 만들어낼 수 있다.
  • CGLIB는 원래는 외부 라이브러리인데, 스프링 프레임워크가 스프링 내부 소스 코드에 포함함. 스프링을 사용하면 사용할 수 있음

참고
직접 CGLIB를 사용하는 경우는 거의 없다. ProxyFactory라는 것이 이 기술을 편리하게 사용하게 도와주기 때문에, 너무 깊이 CGLIB를 공부하는 것보다는 CGLIB가 어떤 역할하고 무엇인지만 파악하면된다.

➡️ 공통 예제 코드

• 앞으로 다양한 상황을 설명하기 위해서 공통으로 사용할 예제 코드를 만들어보자.

1. 인터페이스와 구현이 있는 서비스 클래스 - ServiceInterface, ServiceImpl
2. 구체 클래스만 있는 서비스 클래스 - ConcreteService

• ServiceInterface

package hello.proxy.common.service;

public interface ServiceInterface {
    void save();
    void find();
}

• ServiceImpl

package hello.proxy.common.service;

import lombok.extern.slf4j.Slf4j;

@Slf4j
public class ServiceImpl implements ServiceInterface {
    @Override
    public void save() {
      log.info("save 호출");
    }

    @Override
    public void find() {
        log.info("find 호출");
    }
}

• ConcreteService

package hello.proxy.common.service;

import lombok.extern.slf4j.Slf4j;

@Slf4j
public class ConcreteService {

    public void call() {
        log.info("ConcreteService 호출");
    }
}

7️⃣ CGLIB - 예제 코드

🗒️ CGLIB 코드

• JDK 동적 프록시에서 실행 로직을 위해 InvocationHandler를 제공했듯이, CGLIB는 MethodInterceptor를 제공한다.

➡️ MethodInterceptor - CGLIB 제공

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by FernFlower decompiler)
//
package org.springframework.cglib.proxy;

import java.lang.reflect.Method;

public interface MethodInterceptor extends Callback {
    Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable;
}

• obj : CGLIB가 적용된 객체
• method : 호출된 메소드
• args : 메서드를 호출하면서 전달된 인수
• proxy : 메서드 호출에 사용

➡️ TimeMethodInterceptor

package hello.proxy.cglib.code;

import lombok.extern.slf4j.Slf4j;
import org.springframework.cglib.proxy.MethodInterceptor;
import org.springframework.cglib.proxy.MethodProxy;

import java.lang.reflect.Method;

@Slf4j
public class TimeMethodInterceptor implements MethodInterceptor { // MethodInterceptor 인터페이스를 구현 CGLIB 프록시의 실행 로직을 정의
    
    private final Object target; // 프록시가 호출할 실제 대상

    public TimeMethodInterceptor(Object target) {
        this.target = target;
    }

    @Override
    public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable {
 
        log.info("TimeProxy 실행");
        long startTime = System.currentTimeMillis();
        
        //method를 사용해도되긴하지만, MethodProxy가 성능적으로 더 좋고 권장한다.
        Object result = proxy.invoke(obj, args); //실제 대상을 동적으로 호출한다.
        
        long endTime = System.currentTimeMillis();
        long resultTime = endTime - startTime;
        log.info("Timeproxy 종료 resultTime={}", resultTime);
          
        return result;
    }    
}

➡️ CglibTest

package hello.proxy.cglib;

import hello.proxy.cglib.code.TimeMethodInterceptor;
import hello.proxy.common.service.ConcreteService;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.cglib.proxy.Enhancer;

@Slf4j
public class CglibTest {

    @Test
    void cglib() {
        ConcreteService target = new ConcreteService();

        Enhancer enhancer = new Enhancer();
        
        // CGLIB는 구체 클래스를 상속 받아서 프록시를 생성할 수 있다. 
        // 어떤 구체 클래스를 상속 받을지 지정한다.
        enhancer.setSuperclass(ConcreteService.class); 
        
        //프록시에 적용할 실행 로직을 할당한다.
        enhancer.setCallback(new TimeMethodInterceptor(target));
        
        //프록시 생성한다. enhancer.setSuperclass(ConcreteService.class)에서 지정한 클래스를 상속받아서 프록시가 만들어짐.
        ConcreteService proxy = (ConcreteService) enhancer.create();
        
        log.info("targetClass={}", target.getClass());
        log.info("proxyClass={}", proxy.getClass());
				
        proxy.call();
    }
}

• JDK 동적 프록시는 인터페이스를 구현(implement)해서 프록시를 만듬. CGLIB는 구체 클래스를 상속(extends)해서 프록시를 만든다.

• 결과

CglibTest - targetClass=class hello.proxy.common.service.ConcreteService
CglibTest - proxyClass=class hello.proxy.common.service.ConcreteService$$EnhancerByCGLIB$$25d6b0e3
TimeMethodInterceptor - TimeProxy 실행
ConcreteService - ConcreteService 호출
TimeMethodInterceptor - TimeProxy 종료 resultTime=9

➡️ CGLIB가 생성한 프록시 클래스 이름

• CGLIB를 통해서 생성된 클래스의 이름을 확인해보자.

  • ConcreteService$$EnhancerByCGLIB$$25d6b0e3

• CGLIB가 동적으로 생성하는 클래스 이름은 다음과 같은 규칙으로 생성된다.

  • 대상클래스$$EnhancerByCGLIB$$임의코드

• 참고로 다음은 JDK Proxy가 생성한 클래스이름이다.

  • ProxyClass=class com.sum.proxy.$Proxy1

✅ 그림으로 정리

➡️ CGLIB 제약

• 클래스 기반 프록시는 상속을 사용하기 때문에 몇가지 제약이 있다.
  • 부모 클래스의 생성자를 체크해야 한다. 가 필요하다.
  • 클래스에 final 키워드가 붙으면 상속이 불가능하다. CGLIB에서는 예외가 발생한다.
  • 메서드에 final 키워드가 붙으면 해당 메서드를 오버라이딩 할 수 없다. CGLIB에서는 프록시 로직이
    동작하지 않는다.

8️⃣ 정리

• 인터페이스가 있는 경우에는 JDK 동적 프록시를 적용하고, 그렇지 않은 경우에는 CGLIB를 적용하려면 어떻게해야할까?
• 두 기술을 함께 사용할 때 부가 기능을 제공하기 위해서 JDK 동적 프록시가 제공하는 InvocationHandler
  와 CGLIB가 제공하는 MethodInterceptor 를 각각 중복으로 만들어서 관리해야 할까?
• 특정 조건에 맞을 때 프록시 로직을 적용하는 기능도 공통으로 제공되었으면?