[스프링] 스프링과 Apache Cassandra의 통합 방법

18 Dec 2023

스프링

Apache Cassandra는 분산형 NoSQL 데이터베이스로 대규모 데이터를 처리하는 데 적합합니다. Spring 프레임워크는 Java 언어를 기반으로 한 애플리케이션을 쉽게 개발할 수 있도록 지원합니다. 이 블로그 포스트에서는 스프링 프레임워크와 Apache Cassandra를 통합하는 방법에 대해 알아보겠습니다.

Apache Cassandra 설정

먼저, Apache Cassandra를 설치하고 설정해야 합니다. 데이터베이스 스키마를 정의하고 적절한 인덱스를 생성하는 작업을 수행해야 합니다.

$ cqlsh
cqlsh> CREATE KEYSPACE IF NOT EXISTS example_keyspace WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 3};
cqlsh> USE example_keyspace;
cqlsh:example_keyspace> CREATE TABLE IF NOT EXISTS example_table (id UUID PRIMARY KEY, name TEXT, age INT);
cqlsh:example_keyspace> CREATE INDEX IF NOT EXISTS ON example_table(name);

Spring 프로젝트 설정

Spring 프로젝트에서 Apache Cassandra를 사용하려면 Spring Data Cassandra라이브러리를 추가해야 합니다. Maven 또는 Gradle과 같은 의존성 관리 도구를 사용하여 라이브러리를 가져올 수 있습니다.

Maven을 사용하는 경우

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-cassandra</artifactId>
    </dependency>
</dependencies>

Gradle을 사용하는 경우

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-cassandra'
}

데이터 액세스 계층 구현

Spring에서 Cassandra 데이터베이스에 액세스하기 위해 Repository 인터페이스를 사용하여 데이터 액세스 계층을 정의해야 합니다.

import org.springframework.data.cassandra.repository.CassandraRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface ExampleRepository extends CassandraRepository<ExampleEntity, UUID> {
}

서비스 계층 구현

이제 데이터 액세스 계층을 사용하는 서비스 클래스를 구현해야 합니다.

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class ExampleService {
  
  @Autowired
  ExampleRepository exampleRepository;
  
  public ExampleEntity findById(UUID id) {
    return exampleRepository.findById(id).orElse(null);
  }
  
  // 다른 메서드 구현
}

컨트롤러 구현

마지막으로 웹 요청을 처리하는 컨트롤러를 구현해야 합니다.

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/example")
public class ExampleController {
  
  @Autowired
  ExampleService exampleService;
  
  @GetMapping("/{id}")
  public ExampleEntity getExample(@PathVariable UUID id) {
    return exampleService.findById(id);
  }
  
  // 다른 메서드 구현
}

결론

이제 Apache Cassandra와 Spring을 통합하여 애플리케이션을 개발하는 기본적인 방법에 대해 알아보았습니다. 이러한 통합은 대규모 데이터를 다루는 애플리케이션을 구축하는 데 도움이 될 것입니다.

참고문헌: