Spring Boot와 생태계 경로

Core provider와 자동 설정을 나눈다

현재 모듈은 Hibernate RegionFactory 자체입니다. Spring Boot properties binding, HibernatePropertiesCustomizer, Micrometer와 Actuator가 필요하면 별도 artifact를 추가합니다.

dependencies {
    implementation(platform("io.github.bluetape4k:bluetape4k-dependencies:<version>"))
    implementation("io.github.bluetape4k:bluetape4k-spring-boot-hibernate-lettuce")
}

Spring Boot module은 core provider를 API dependency로 포함하므로 둘의 버전을 따로 맞추지 않습니다.

bluetape4k:
  cache:
    lettuce-near:
      redis-uri: redis://localhost:6379
      codec: lz4fory
      use-resp3: true
      local:
        max-size: 10000
        expire-after-write: 30m
      redis-ttl:
        default: 120s
        regions:
          io.example.Product: 300s
      metrics:
        enabled: true
        enable-caffeine-stats: true

자동 설정은 이 값을 hibernate.cache.lettuce.*로 변환하고 2차 캐시를 켭니다. enabled=false이면 자동 설정이 물러납니다. Metrics를 켜면 Hibernate statistics도 활성화되므로 운영 비용을 측정합니다.

실행 가능한 demo

bluetape4k-spring-boot-hibernate-lettuce-demo는 Product entity, Spring Data repository, cache controller와 실제 설정을 담았습니다. core 모듈 테스트로 provider 계약을 확인한 뒤 demo에서 HTTP 요청과 cache statistics를 연결합니다.

./gradlew :bluetape4k-spring-boot-hibernate-lettuce-demo:bootRun

demo 설정을 그대로 운영에 복사하지 않습니다. Redis 인증·TLS, DB migration, TTL, pool과 observability 정책은 배포 환경에 맞게 정합니다.

어디로 이어갈까

필요한 학습	다음 경로	이유
entity와 transaction 기본	bluetape4k-hibernate	cache 전에 ORM lifecycle을 이해합니다.
Near Cache 직접 사용	bluetape4k-cache-lettuce	Hibernate Region 밖의 cache API를 다룹니다.
Redis command와 codec	bluetape4k-lettuce	Lettuce client·serialization 계층을 확인합니다.
Spring Boot Metrics·Actuator	Spring Boot Hibernate Lettuce	자동 설정과 운영 endpoint를 붙입니다.
repository cache 전략	exposed-workshop	cache-aside와 read/write-through를 DB repository 관점에서 비교합니다.

Hibernate 2차 캐시는 entity state와 query 결과를 Hibernate lifecycle 안에서 캐시합니다. Exposed workshop의 JdbcCacheRepository, EntityMapLoader, EntityMapWriter는 애플리케이션 repository가 read-through·write-through·write-behind를 소유하는 다른 구조입니다. 어느 쪽이 더 낫다기보다 persistence owner가 다릅니다.

Spring Boot와 생태계 경로

Core provider와 자동 설정을 나눈다

실행 가능한 demo

어디로 이어갈까

Source와 links