[Backend] RedisTemplate

목차 (OPEN)

• 🎯 Redis Template
• 🧐 Redis Template이 필요한 이유
• 🧱 핵심 구성 요소
• 📄 예시
• 🤔 StringRedisTemplate과의 차이
• 📚 결론

 

 

 

 

🎯 Redis Template

Redis Template란 Spring Data Redis가 제공하는 고수준 클라이언트 객체이다.

 

즉, 자바 코드에서 Redis 명령을 쉽고 안전하게 다룰 수 있도록 래핑해놓은 바구니라고 보면 된다.

 

---

🧐 Redis Template이 필요한 이유

전통적 접근	RedisTemplate 접근
Lettuce/Jedis 클라이언트를 직접 호출 → SET key value, GET key 등 문자열 명령 조합	자바 메서드 호출 → template.opsForValue().set(key, obj) 같이 타입-안전하고, 트랜잭션·파이프라인 등 고급 기능 포함
직렬화/역직렬화는 개발자가 직접 처리해야 함	Serializer 전략을 한 번만 지정하면 모든 호출에 자동 적용
보일러플레이트(연결 열고/닫고, 예외 변환) 많음	Spring이 커넥션 생명주기·예외 변환을 알아서 처리

 

---

🧱 핵심 구성 요소

1️⃣ 연결 팩토리 (RedisConnectionFactory)

• Lettuce / Jedis 등 Raw 드라이버를 추상화함
• 템플릿은 여기에서 커넥션을 꺼내서 사용함

2️⃣ 직렬화 전략

• 키, 값, 해시 키, 해시 값 마다 따로 지정 가능함
• ex. StringRedisSerializer, GenericJackson2JsonRedisSerializer 등

3️⃣ Operation Helper

메서드	Redis 구조 대응	예시
opsForValue()	String	문자열/JSON 값
opsForHash()	Hash	Map 구조
opsForList()	List	큐/스택
opsForSet()	Set	중복 없는 집합
opsForZSet()	Sorted Set	점수 기반 랭킹

 

---

📄 예시

@Autowired
private RedisTemplate<String, Object> redisTemplate;

public void sample() {
    // 1) 단순 String (또는 JSON) 저장
    redisTemplate.opsForValue().set("accessaToken:123", "abc123", Duraton.ofMinutes(30
));

    // 2) Hash 예시: 세션 저장
    Map<String, Object> sessionDate = Map.of(
        "userId", 42,
        "role", "ADMIN"
    );
    redisTemplate.opsForHash().putAll("session:42", sessionData);
    
    // 3) Sorted Set 예시: 점수판
    redisTemplate.opsForZSet().add("ranking:game01", "soyeon", 9800);
}

 

---

🤔 StringRedisTemplate과의 차이

• StringRedisTemplate
  • 제네릭이 <String, String> 고정임
  • 기본 Serializer가 모두 StringRedisSerializer임
  • 정말 문자열만 넣고 빼면 된다는 단순한 상황에서 사용하기 편함
• RedisTemplate<K, V>
  • 타입을 자유롭게 지정하고, 직렬화 전략을 원하는 대로 조합 가능함
  • JSON, ProtoBuf, Kryo 등 커스텀 Serializer도 연결 가능함
  • 해시, 리스트 등 복잡한 구조를 다룰 땐 대부분 이걸 씀

 

---

📚 결론

• RedisTemplate란 스프링이 포장한 Redis Helper 객체이다.
• 이는 직렬화 및 연결 관리, 예외 처리 등을 알아서 처리해준다.
• 또한, 자바 친화적 메서드 덕분에 코드 가독성이 높고, 버그 가능성도 줄어든다.
• 문자열 뿐만 아니라 JSON 객체, 세션, 랭킹 등 다양한 타입 및 구조를 다룰 때 사용하기 좋다.

추후 파이프라인, 트랜잭션, Bound Operations, 실행 콜백 등에 관한 것도 공부해서 적용할 예정이다.