@Cacheable 심화 — 캐시 추상화의 동작 원리와 설정 옵션

@Service
public class ProductService {

    @Cacheable("products")
    public Product findById(Long id) {
        // 캐시 미스일 때만 실행됨
        log.info("DB에서 상품 조회: {}", id);
        return productRepository.findById(id)
                .orElseThrow(() -> new NotFoundException("상품을 찾을 수 없습니다"));
    }
}

// 파라미터의 특정 필드를 키로 사용
@Cacheable(value = "users", key = "#request.email")
public User findByEmail(UserSearchRequest request) { ... }

// 여러 파라미터 조합
@Cacheable(value = "products", key = "#category + ':' + #page")
public List<Product> findByCategory(String category, int page) { ... }

// 메서드 이름 포함
@Cacheable(value = "reports", key = "#root.methodName + ':' + #date")
public Report getReport(LocalDate date) { ... }

@Cacheable(
    value = "products",
    condition = "#id > 0",           // 실행 전: id가 양수일 때만 캐시 사용
    unless = "#result.price == 0"    // 실행 후: 가격이 0이면 캐시하지 않음
)
public Product findById(Long id) { ... }

// null 결과는 캐시하지 않기
@Cacheable(value = "users", unless = "#result == null")
public User findByEmail(String email) { ... }

// 특정 조건에서만 캐시 조회 (조건 불충족 시 항상 메서드 실행)
@Cacheable(value = "config", condition = "#env == 'production'")
public Config getConfig(String env) { ... }

@CachePut(value = "products", key = "#product.id")
public Product update(Product product) {
    // 항상 실행됨
    return productRepository.save(product);
}

// 특정 키의 캐시 삭제
@CacheEvict(value = "products", key = "#id")
public void delete(Long id) {
    productRepository.deleteById(id);
}

// 해당 캐시의 모든 엔트리 삭제
@CacheEvict(value = "products", allEntries = true)
public void bulkUpdate(List<Product> products) {
    productRepository.saveAll(products);
}

// 메서드 실행 전에 캐시 삭제
@CacheEvict(value = "products", beforeInvocation = true)
public void riskyDelete(Long id) {
    // 메서드 실행 전에 캐시가 삭제됨
    // 메서드가 실패해도 캐시는 이미 삭제된 상태
    productRepository.deleteById(id);
}

@Caching(
    put = {
        @CachePut(value = "productsById", key = "#result.id"),
        @CachePut(value = "productsByCode", key = "#result.code")
    },
    evict = {
        @CacheEvict(value = "productList", allEntries = true)
    }
)
public Product create(ProductCreateRequest request) {
    return productRepository.save(request.toEntity());
}

@Configuration
@EnableCaching
public class CacheConfig {

}

spring:
  cache:
    type: caffeine  # none, simple, caffeine, redis 등
    caffeine:
      spec: maximumSize=1000,expireAfterWrite=10m

@Service
public class ProductService {

    @Cacheable("products")
    public Product findById(Long id) { ... }

    public Product findWithDetails(Long id) {
        // 같은 클래스 내부 호출 → 프록시를 거치지 않아 캐시가 동작하지 않음!
        Product product = findById(id);
        // ...
        return product;
    }
}

// 해결: 별도 빈으로 분리
@Service
public class ProductCacheService {
    @Cacheable("products")
    public Product findById(Long id) { ... }
}

@Service
public class ProductService {
    private final ProductCacheService cacheService;

    public Product findWithDetails(Long id) {
        Product product = cacheService.findById(id);  // 프록시를 통해 호출
        // ...
        return product;
    }
}