🍃 Spring Boot 프로젝트에서 Redis 활용하기

Redis의 기본 자료형을 익혔다면, 이제 실제 백엔드 서비스(Spring Boot)에 Redis를 연동해 볼 차례입니다. Spring에서 Redis를 사용하는 두 가지 주요 방법인 RedisRepository와 RedisTemplate을 알아보겠습니다.

---

1. Spring Data Redis 설정

Spring Initializr에서 프로젝트 생성 시 다음 의존성을 추가해야 합니다.

• Dependencies: Spring Data Redis, Lombok

---

2-1. Spring Data Repository 방식

JPA와 매우 유사한 방식으로, Java 객체를 Redis의 Hash 자료형으로 손쉽게 매핑하여 CRUD를 수행할 수 있습니다.

🔹도메인 객체 만들기 (Item.java)

JPA의 @Entity 대신 @RedisHash 어노테이션을 사용합니다.

@Getter @Setter @Builder
@NoArgsConstructor @AllArgsConstructor
@RedisHash("item") // Redis의 Key prefix 설정
public class Item implements Serializable {
    @Id
    private Long id;
    private String name;
    private String description;
    private Integer price;
}

🔹Repository 만들기 (ItemRepository.java)

public interface ItemRepository extends CrudRepository<Item, Long> {}

🔹테스트 코드로 확인하기

@Test
public void createTest() {
    Item item = Item.builder()
            .id(1L)
            .name("keyboard")
            .description("Mechanical Keyboard Expensive")
            .build();
    itemRepository.save(item);
}

🔍 Redis 내부에서는 어떻게 저장될까?
테스트 성공 후 Redis CLI에서 KEYS *를 입력해 보면 재미있는 결과를 볼 수 있습니다.

• item (Set 자료형): 현재 저장된 아이템들의 ID 목록을 관리하는 인덱스 역할을 합니다.
• item:1 (Hash 자료형): 실제 객체의 데이터가 담긴 키입니다. HGETALL item:1 명령어로 조회해 보면 필드별로 값이 예쁘게 들어있는 것을 확인할 수 있습니다.

@Test
public void readOneTest() {
    Item item = itemRepository.findById(1L)
            .orElseThrow();
    System.out.println(item.getDescription());
}


@Test
public void updateTest() {
    Item item = itemRepository.findById(1L)
            .orElseThrow();
    item.setDescription("On Sale!!!");
    itemRepository.save(item);

    item = itemRepository.findById(1L)
            .orElseThrow();
    System.out.println(item.getDescription());
}

@Test
public void deleteTest() {
    itemRepository.deleteById(1L);
}

---

2-2 RedisTemplate 써보기

Key를 직접 설정하거나 Redis의 다양한 자료형 기능을 세밀하게 제어하고 싶다면 RedisTemplate을 사용합니다.

🔹 StringRedisTemplate 맛보기

문자열 데이터를 다룰 때 기본으로 제공되는 Bean입니다. 각 자료형에 맞는 Operations 인터페이스를 제공합니다.

@Autowired
private StringRedisTemplate stringRedisTemplate;

@Test
public void stringValueOpsTest() {
    // Redis String 자료형 사용
    ValueOperations<String, String> ops = stringRedisTemplate.opsForValue();
    ops.set("simplekey", "simplevalue");
    System.out.println(ops.get("simplekey"));
}

@Test
public void stringSetOpsTest() {
    // Redis Set 자료형 사용
    SetOperations<String, String> setOps = stringRedisTemplate.opsForSet();
    setOps.add("hobbies", "games", "coding", "alcohol");
    System.out.println(setOps.size("hobbies"));
}

☝🏻 주의할 점!
StringRedisTemplate은 Redis의 String 데이터 타입만 다루는 도구가 아닙니다. 정확히는 Redis와 소통할 때 Java의 String 자료형을 사용해 데이터를 주고받는다는 의미입니다. 즉, Redis의 List나 Set에 데이터를 넣을 때도 Java의 문자열(String)을 전달하고 싶다면 이 템플릿을 사용합니다.

🔹 공용 명령어 활용

EXPIRE, DEL 같은 공통 기능은 Template 자체 메서드로 실행합니다.

stringRedisTemplate.expire("simplekey", 5, TimeUnit.SECONDS);

3. @Configuration에서 RedisTemplate 정의하기

🔹 RedisConfig 설정 (RedisConfig.java)

@Configuration
public class RedisConfig {
    @Bean
    public RedisTemplate<String, ItemDto> itemRedisTemplate(
            RedisConnectionFactory connectionFactory
    ) {
    	// 1
        RedisTemplate<String, ItemDto> template = new RedisTemplate<>();
        // 2
        template.setConnectionFactory(connectionFactory);
        
        // 데이터 가독성을 위해 Key는 String, Value는 JSON으로 직렬화
        // 3-a
        template.setKeySerializer(RedisSerializer.string());
        
 		// 3-b
 		template.setValueSerializer(RedisSerializer.json());
        // 4
        return template;
    }
}

1. 새로운 RedisTemplate을 만들면서 타입 파라미터를 String, ItemDto로 설정하는데 Key는 Java의 String, Value는 ItemDto를 사용하여 Redis와 소통할 것이다라는 의미입니다.
2. Redis와의 연결을 담당할 RedisConnectionFactory를 template에 전달합니다. 이때 RedisConnectionFactory의 경우 application.yaml 파일의 내용을 바탕으로 내부적으로 만들어 Bean 객체로 등록됩니다.
3. 데이터 직렬화 방법을 결정합니다.
   a. Key는 String으로 직렬화
   b. Value는 JSON으로 직렬화
4. template을 반환하면 Bean 객체로 등록됩니다.

🔹 커스텀 Template 사용 예시

@Test
public void itemRedisTemplateTest() {
    ValueOperations<String, ItemDto> ops = itemRedisTemplate.opsForValue();
    ops.set("my:keyboard", ItemDto.builder()
            .name("Mechanical Keyboard")
            .price(300000)
            .build());
}

💡 요약 및 결론

• Repository: 단순 CRUD 작업 및 JPA 스타일에 익숙할 때 유리합니다.

• Template: 자료형의 상세 기능을 활용하거나 세밀한 Key 설계가 필요할 때 사용합니다.

상황에 맞는 적절한 방식을 선택하여 Redis의 성능을 극대화해 보세요! 🚀