Ch10. 스프링 AOP(구현) - 스프링 AOP 구현(어드바이스 종류)

어드바이스 종류

@Around : 메서드 호출 전후에 수행, 가장 강력한 어드바이스, 조인 포인트 실행 여부 선택, 반환 값 변환, 예외 변환 등이 가능

@Before : 조인 포인트 실행 이전에 실행

@AfterReturning : 조인 포인트가 정상 완료 후 실행

@AfterThrowing : 메서드가 예외를 던지는 경우 실행

@After : 조인 포인트가 정상 또는 예외에 관계없이 실행(finally)

Around가 큰 기능이고 이를 조각조각 낸 것들이 나머지 기능들이다.

@Slf4j
@Aspect
public class AspectV6Advice {

    @Around("hello.aop.order.aop.Pointcuts.orderAndService()")
    public Object doTransaction(ProceedingJoinPoint joinPoint) throws Throwable {
        try {
            //@Before
            log.info("[트랜잭션 시작] {}", joinPoint.getSignature());
            Object result = joinPoint.proceed();
            //@AfterReturning
            log.info("[트랜잭션 커밋] {}", joinPoint.getSignature());
            return result;
        }catch (Exception e){
            //@AfterThrowing
            log.info("[log] {} ", joinPoint.getSignature()); //join point 시그니처
            throw e;
        }finally {
            //@After
            log.info("[리소스 릴리즈] {}", joinPoint.getSignature());

        }
    }

    @Before("hello.aop.order.aop.Pointcuts.orderAndService()")
    public void doBefore(JoinPoint joinPoint){ //매개 변수를 받지 않아도 된다.
        log.info("[before] {}", joinPoint.getSignature());
        //joinPoint 실행은 알아서 해준다
    }

    @AfterReturning(value = "hello.aop.order.aop.Pointcuts.orderAndService()", returning = "result")
    public void doReturn(JoinPoint joinPoint, Object result){ // 리턴타입이 맞아야 실행시켜 준다
        log.info("[return] {}, return={}", joinPoint.getSignature(), result); //리턴값 변경은 안된다//@Around 는 가능
    }


    @AfterReturning(value = "hello.aop.order.aop.Pointcuts.allOrder()", returning = "result")
    public void doReturn2(JoinPoint joinPoint, Integer result){ // 리턴타입이 맞아야 실행시켜 준다
        log.info("[return2] {}, return={}", joinPoint.getSignature(), result); //리턴값 변경은 안된다//@Around 는 가능
    }

    @AfterThrowing(value = "hello.aop.order.aop.Pointcuts.orderAndService()", throwing = "ex")
    public void doThrowing(JoinPoint joinPoint, Exception ex){ //예외도 마찬가지로 타입이 맞아야 사용이 가능하다.
        log.info("[ex] {} message={}", ex, ex.getMessage());
    }

    @After(value = "hello.aop.order.aop.Pointcuts.orderAndService()")
    public void doAfter(JoinPoint joinPoint){
        log.info("[after] {}", joinPoint.getSignature());
    }
}

• 사실 @Around 를 제외한 나머지 어드바이스들은 @Around 가 할 수 있는 일의 일부만 제공할 뿐이다. 따라서 @Around 어드바이스만 사용해도 필요한 기능을 모두 수행할 수 있다
• 참고 정보 획득
  
  • 모든 어드바이스는 org.aspectj.lang.JoinPoint 를 첫 번째 파라미터에 사용할 수 있다. (생략해도 된다.)
  • 단 @Around 는 ProceedingJoinPoint을 사용해야 한다.
  • 참고로 ProceedingJoinPoint 는 org.aspectj.lang.JoinPoint의 하위 타입이다.
  • JoinPoint 인터페이스의 주요 기능
    • getArgs() : 메서드 인수를 반환합니다.
    • getThis() : 프록시 객체를 반환합니다.
    • getTarget() : 대상 객체를 반환합니다.
    • getSignature() : 조언되는 메서드에 대한 설명을 반환합니다.
    • toString() : 조언되는 방법에 대한 유용한 설명을 인쇄합니다.
  • ProceedingJoinPoint 인터페이스의 주요 기능
    • proceed() : 다음 어드바이스나 타깃을 호출한다.

@Before

조인 포인트 실행 전

@Around 와 다르게 작업 흐름을 변경할 수는 없다. @Around는 ProceedingJoinPoint.proceed()를 호출해야 다음 대상이 호출된다. 만약 호출하지 않으면 다음 대상이 호출되지 않는다. 반면에 @Before는 ProceedingJoinPoint.proceed() 자체를 사용하지 않는다. 메서드 종료 시 자동으로 다음 타깃이 호출된다. 물론 예외가 발생하면 다음 코드가 호출되지는 않는다.

@AfterReturning

메서드 실행이 정상적으로 반환될 때 실행

returning 속성에 사용된 이름은 어드바이스 메서드의 매개변수 이름과 일치해야 한다.

returning 절에 지정된 타입의 값을 반환하는 메서드만 대상으로 실행한다. (부모 타입을 지정하면 모든 자식 타입은 인정된다.)

@Around 와 다르게 반환되는 객체를 변경할 수는 없다. 반환 객체를 변경하려면 @Around를 사용해야 한다. 참고로 반환 객체를 조작할 수는 있다.

@AfterThrowing

메서드 실행이 예외를 던져서 종료될 때 실행

throwing 속성에 사용된 이름은 어드바이스 메서드의 매개변수 이름과 일치해야 한다.

throwing 절에 지정된 타입과 맞은 예외를 대상으로 실행한다. (부모 타입을 지정하면 모든 자식 타입은 인정된다.)

@After

메서드 실행이 종료되면 실행된다. (finally를 생각하면 된다.)

정상 및 예외 반환 조건을 모두 처리한다.

일반적으로 리소스를 해제하는 데 사용한다.

@Around

메서드의 실행의 주변에서 실행된다. 메서드 실행 전후에 작업을 수행한다.

가장 강력한 어드바이스

• 조인 포인트 실행 여부 선택 joinPoint.proceed() 호출 여부 선택
• 전달 값 변환: joinPoint.proceed(args[])
• 반환 값 변환
• 예외 변환
• 트랜잭션처럼 try ~ catch~ finally 모두 들어가는 구문 처리

가능 어드바이스의 첫 번째 파라미터는 ProceedingJoinPoint를 사용해야 한다.

proceed()를 통해 대상을 실행한다.

proceed() 를 여러 번 실행할 수도 있음(재시도)

실행

@Import(AspectV6Advice.class)
public class AopTest {
	...	
}

결과

순서

• 스프링은 5.2.7 버전부터 동일한 @Aspect 안에서 동일한 조인 포인트의 우선순위를 정했다.
• 실행 순서: @Around , @Before , @After , @AfterReturning , @AfterThrowing
• 어드바이스가 적용되는 순서는 이렇게 적용되지만, 호출 순서와 리턴 순서는 반대라는 점을 알아두자.
• 물론 @Aspect 안에 동일한 종류의 어드바이스가 2개 있으면 순서가 보장되지 않는다. 이 경우 앞서 배운 것처럼 @Aspect를 분리하고 @Order를 적용하자.

@Around 외에 다른 어드바이스가 존재하는 이유

@Around는 항상 joinPoint.proceed()를 호출해야 한다. 만약 실수로 호출하지 않으면 타깃이 호출되지 않는 치명적인 버그가 발생한다

@Before는 joinPoint.proceed()를 호출하는 고민을 하지 않아도 된다.

@Around 가 가장 넓은 기능을 제공하는 것은 맞지만, 실수할 가능성이 있다. 반면에 @Before , @After 같은 어드바이스는 기능은 적지만 실수할 가능성이 낮고, 코드도 단순하다. 그리고 가장 중요한 점이 있는데, 바로 이 코드를 작성한 의도가 명확하게 드러난다는 점이다. @Before라는 애노테이션을 보는 순간 아~ 이 코드는 타깃 실행 전에 한정해서 어떤 일을 하는 코드구나 라는 것이 드러난다.

 

좋은 설계는 제약이 있는 것이다.

제약은 실수를 미연에 방지한다(일종에 가이드 역할), 만약 @Around를 사용했는데, 중간에 다른 개발자가 해당 코드를 수정해서 호출하지 않았다면? 큰 장애가 발생했을 것이다. 처음부터 @Before를 사용했다면 이런 문제 자체가 발생하지 않는다. 제약 덕분에 역할이 명확해진다. 다른 개발자도 이 코드를 보고 고민해야 하는 범위가 줄어들고 코드의 의도도 파악하기 쉽다.