EhCache로 Hibernate 2차 캐시 적용하기
2분 소요
네트워크를 통해 데이터베이스에 접근하는 시간과 비용은 서버 내부 메모리에 접근하는 시간보다 훨씬 큽니다. 이 글에서는 데이터를 메모리에 캐싱하여 데이터베이스 접근 횟수를 줄이는 방법을 설명합니다.
개요
다른 대부분의 완전한 기능을 갖춘 ORM 프레임워크와 마찬가지로 Hibernate에도 1차 캐시라는 개념이 있습니다. 이 글에서는 Hibernate 2차 캐시를 살펴봅니다.
또한 2차 캐시와 1차 캐시의 차이도 설명합니다.
ORM(Object-Relational Mapping)이란?
객체-관계 매핑(ORM)은 메타데이터 기술자를 사용하여 객체 코드를 관계형 데이터베이스에 연결하는 프로그래밍 기법입니다.
Table : Entity (1:1)

ORM (Object-Relational Mapping)
Hibernate는 ORM 프레임워크 중 하나입니다.
1차 캐시에 대하여
JPA에서는 1차 캐시가 기본적으로 적용됩니다. 세션 범위의 캐시로, 각 엔티티 인스턴스가 영속성 컨텍스트에 한 번만 로드되도록 보장합니다.

first-level cache
user2ID 값으로 정보를 검색합니다userRepository.findById("userId")- 캐시에 정보가 있으면 캐시의 값을 반환합니다.
없으면 DB에서 정보를 조회합니다.
SELECT * FROM USER_INFO WHERE USER_ID = #{userId} - 값을 캐시에 저장하고 반환합니다
- Spring이 실행될 때 모든 데이터를 캐싱하지는 않으며,
select,update,delete,save시점에 행 단위 레코드만 캐싱됩니다. - 세션이 닫히면 1차 캐시도 종료됩니다. 이는 동시에 실행되는 세션들이 서로 격리된 상태로 엔티티 인스턴스를 다룰 수 있게 해 주므로 오히려 바람직합니다.
2차 캐시에 대하여
반대로 2차 캐시는 SessionFactory 범위입니다. 즉, 같은 세션 팩토리로 생성된 모든 세션이 공유합니다.

second-level cache
- 첫 조회 시점에는 2차 캐시에 엔티티가 없으므로 DB에서 조회합니다.
- 결과를 2차 캐시에 저장하고, 엔티티의 복사본을 반환합니다.
- 같은 엔티티를 조회하면 2차 캐시에서 엔티티의 복사본을 반환합니다.
왜 2차 캐시를 사용할까?
2차 캐시는 영속성 컨텍스트에 쿼리 결과의 복사본을 제공합니다. 여러 사용자가 1차 캐시의 엔티티를 수정하더라도, 실제로 반영되는 2차 캐시에는 영향을 주지 않기 때문입니다.
이를 통해 동시성을 극대화할 수 있습니다.
동시성(Concurrency)은 하나의 코어에서 멀티 스레드를 운영하는 방식으로, 멀티태스킹을 위해 여러 스레드가 번갈아 실행되는 특성을 말합니다. 동시성을 이용한 단일 코어 멀티태스킹은 각 스레드가 병렬로 실행되는 것처럼 보이지만, 실제로는 조금씩 번갈아 실행되고 있습니다.
2차 캐시 사용 방법
Java: 1.8

pom.xml
application.yml
## @Cacheable 애노테이션 활성화
spring.jpa.properties.javax.persistence.sharedCache.mode = ENABLE_SELECTIVE
## 2차 캐시 활성화
spring.jpa.properties.hibernate.cache.use_second_level_cache = true
## 2차 캐시를 처리할 클래스 지정
spring.jpa.properties.hibernate.cache.region.factory_class = org.hibernate.cache.ehcache.EhCacheRegionFactory
## 캐시 적용 여부 확인
spring.jpa.properties.hibernate.generate_statistics = true

resources/ehcache.xml
.xml 파일로 캐시 설정을 지정할 수 있습니다. 더 많은 설정이 가능합니다.

ItemEntity.java
Cacheable 애노테이션을 추가하면 2차 캐시를 사용할 준비가 모두 끝납니다. 이제 결과를 확인해 보겠습니다.
- 첫 번째 요청
findById(1)

firstRequest
캐시에 값이 없으므로 1 miss가 발생하고, DB에서 가져온 값을 캐시에 저장합니다.
- 두 번째 요청 (같은 엔티티)
findById(1)

secondRequest
캐시에 값이 있으므로 1 hit입니다.