Spring AOP 튜토리얼
— DB 암복호화 적용 사례로 배우기

01AOP란 무엇인가

• AOP (Aspect Oriented Programming, 관점 지향 프로그래밍)
• 로깅·트랜잭션·보안·암복호화 등 공통 기능을 핵심 비즈니스 로직과 분리하여, 필요한 지점에 자동 적용하는 프로그래밍 방식
• 스프링을 쓰는 서비스라면 사실상 AOP를 쓰고 있음 — @Transactional, @Cacheable, 스프링 시큐리티 권한 체크가 모두 AOP 기반

02AOP 주요 키워드 5가지

03AOP 주요 어노테이션 정리

04어노테이션별 사용 예제

1) @EnableAspectJAutoProxy — AOP 활성화 (설정)

설정 클래스에 한 번만 선언하면 스프링이 프록시를 자동 생성합니다. (Spring Boot는 기본 활성화)

@Configuration
@EnableAspectJAutoProxy
public class AopConfig {
    // 별도 내용 없이 선언만으로 AOP 활성화
}

2) @Aspect + @Pointcut — 공통 모듈과 적용 대상 선언

Pointcut을 메서드로 정의해두면 여러 Advice에서 이름으로 재사용할 수 있습니다.

@Aspect
@Component
public class DaoSecurityAspect {

    // com.example.dao 하위 모든 메서드를 대상으로 지정
    @Pointcut("execution(* com.example.dao..*(..))")
    public void daoLayer() {}
}

3) @Before — 메서드 실행 전 (저장 전 암호화)

@Before("daoLayer()")
public void encryptParams(JoinPoint jp) {
    // jp.getArgs()로 파라미터 접근 가능
    System.out.println("[Before] " + jp.getSignature().getName()
        + " 호출 전 — 파라미터 암호화");
}

4) @AfterReturning — 정상 반환 후 (조회 결과 복호화)

returning 속성으로 반환값을 파라미터로 받아 후처리할 수 있습니다.

@AfterReturning(pointcut = "daoLayer()", returning = "result")
public void decryptResult(JoinPoint jp, Object result) {
    System.out.println("[AfterReturning] 조회 결과 복호화: " + result);
}

5) @AfterThrowing — 예외 발생 시 (오류 로깅)

throwing 속성으로 발생한 예외 객체를 받을 수 있습니다.

@AfterThrowing(pointcut = "daoLayer()", throwing = "ex")
public void logError(JoinPoint jp, Exception ex) {
    System.out.println("[AfterThrowing] " + jp.getSignature().getName()
        + " 예외: " + ex.getMessage());
}

6) @After — 성공/실패 무관 항상 수행 (자원 정리)

@After("daoLayer()")
public void cleanup(JoinPoint jp) {
    System.out.println("[After] " + jp.getSignature().getName() + " 종료");
}

7) @Around — 전후 모두 제어 (수행시간 측정 + 암복호화)

pjp.proceed() 호출 전이 "실행 전", 이후가 "실행 후"입니다. 반환값을 반드시 return 해야 합니다.

@Around("daoLayer()")
public Object measureAndSecure(ProceedingJoinPoint pjp) throws Throwable {
    long start = System.currentTimeMillis();

    // (실행 전) 파라미터 암호화 등 전처리
    Object result = pjp.proceed();   // 실제 대상 메서드 실행
    // (실행 후) 결과 복호화 등 후처리

    long elapsed = System.currentTimeMillis() - start;
    System.out.println("[Around] 수행시간: " + elapsed + "ms");
    return result;   // 반환값을 돌려주지 않으면 호출자가 null을 받음!
}

05프록시(Proxy) 개념

• 실제 객체 대신 요청을 먼저 받아 처리하는 대리 객체
• 중간에 부가 기능(암복호화·로깅·트랜잭션)을 삽입할 수 있는 구조
• 스프링 AOP는 프록시 기반으로 동작

06커스텀 어노테이션 + AOP 패턴

• 패키지 경로 대신 직접 만든 어노테이션을 붙인 메서드만 골라 공통 기능 적용
• 대상 지정이 명시적이고 유연해서 실무에서 매우 흔한 패턴
• 스프링의 @Transactional, @Cacheable도 같은 원리로 만들어진 것

// 1. 커스텀 어노테이션 정의
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Encrypt {}

// 2. Aspect에서 어노테이션 기준으로 적용
@Aspect
@Component
public class EncryptAspect {
    @Around("@annotation(com.example.annotation.Encrypt)")
    public Object encrypt(ProceedingJoinPoint pjp) throws Throwable {
        // 암복호화 처리
        return pjp.proceed();
    }
}

// 3. 필요한 메서드에만 선언
@Encrypt
public void saveUser(User user) { ... }

07DAO 암복호화 적용 사례

• DAO 메서드마다 암복호화 코드를 직접 작성하지 않고, AOP로 호출 전후를 가로채 공통 처리
• DB 저장 전 암호화 → DB 조회 후 복호화 자동 수행
• 비즈니스 로직 수정 없이 보안 기능 적용 가능

08관련 라이브러리 구성