Reactive Cassandraを使用したSpring Data
1. 前書き
2. Mavenの依存関係
実際のところ、Spring Data CassandraはProject ReactorおよびRxJavaのリアクティブ型をサポートしています。 実例を示すために、このチュートリアルではプロジェクトリアクターのリアクティブタイプFluxとMono を使用します。
まず、チュートリアルに必要な依存関係を追加しましょう。
org.springframework.data
spring-data-cassandra
2.1.2.RELEASE
io.projectreactor
reactor-core
spring-data-cassandra の最新バージョンはhereで見つかります。
次に、REST APIを介してデータベースからSELECT操作を公開します。 それでは、RestControllerの依存関係も追加しましょう。
org.springframework.boot
spring-boot-starter-web
3. アプリの実装
データを永続化するので、最初にエンティティオブジェクト:を定義しましょう
@Table
public class Employee {
@PrimaryKey
private int id;
private String name;
private String address;
private String email;
private int age;
}
次に、ReactiveCassandraRepository.から拡張するEmployeeRepository を作成します。this interface enables the support for reactive typesに注意することが重要です。
public interface EmployeeRepository extends ReactiveCassandraRepository {
@AllowFiltering
Flux findByAgeGreaterThan(int age);
}
3.1. CRUD操作用のRESTコントローラー
説明のために、単純なRESTコントローラーを使用したいくつかの基本的なSELECT操作を公開します。
@RestController
@RequestMapping("employee")
public class EmployeeController {
@Autowired
EmployeeService employeeService;
@PostConstruct
public void saveEmployees() {
List employees = new ArrayList<>();
employees.add(new Employee(123, "John Doe", "Delaware", "[email protected]", 31));
employees.add(new Employee(324, "Adam Smith", "North Carolina", "[email protected]", 43));
employees.add(new Employee(355, "Kevin Dunner", "Virginia", "[email protected]", 24));
employees.add(new Employee(643, "Mike Lauren", "New York", "[email protected]", 41));
employeeService.initializeEmployees(employees);
}
@GetMapping("/list")
public Flux getAllEmployees() {
Flux employees = employeeService.getAllEmployees();
return employees;
}
@GetMapping("/{id}")
public Mono getEmployeeById(@PathVariable int id) {
return employeeService.getEmployeeById(id);
}
@GetMapping("/filterByAge/{age}")
public Flux getEmployeesFilterByAge(@PathVariable int age) {
return employeeService.getEmployeesFilterByAge(age);
}
}
最後に、単純なEmployeeServiceを追加しましょう。
@Service
public class EmployeeService {
@Autowired
EmployeeRepository employeeRepository;
public void initializeEmployees(List employees) {
Flux savedEmployees = employeeRepository.saveAll(employees);
savedEmployees.subscribe();
}
public Flux getAllEmployees() {
Flux employees = employeeRepository.findAll();
return employees;
}
public Flux getEmployeesFilterByAge(int age) {
return employeeRepository.findByAgeGreaterThan(age);
}
public Mono getEmployeeById(int id) {
return employeeRepository.findById(id);
}
}
3.2. データベース構成
次に、application.propertiesでCassandraとの接続に使用するキースペースとポートを指定しましょう。
spring.data.cassandra.keyspace-name=practice
spring.data.cassandra.port=9042
4. エンドポイントのテスト
最後に、APIエンドポイントをテストします。
4.1. 手動テスト
まず、データベースから従業員レコードを取得しましょう。
curl localhost:8080/employee/list
その結果、すべての従業員を取得します。
[
{
"id": 324,
"name": "Adam Smith",
"address": "North Carolina",
"email": "[email protected]",
"age": 43
},
{
"id": 123,
"name": "John Doe",
"address": "Delaware",
"email": "[email protected]",
"age": 31
},
{
"id": 355,
"name": "Kevin Dunner",
"address": "Virginia",
"email": "[email protected]",
"age": 24
},
{
"id": 643,
"name": "Mike Lauren",
"address": "New York",
"email": "[email protected]",
"age": 41
}
]
次に、IDで特定の従業員を見つけてみましょう。
curl localhost:8080/employee/643
その結果、氏を取得します マイク・ローレンバック:
{
"id": 643,
"name": "Mike Lauren",
"address": "New York",
"email": "[email protected]",
"age": 41
}
最後に、年齢フィルターが機能するかどうかを見てみましょう。
curl localhost:8080/employee/filterByAge/35
予想どおり、年齢が35歳を超えるすべての従業員を取得します。
[
{
"id": 324,
"name": "Adam Smith",
"address": "North Carolina",
"email": "[email protected]",
"age": 43
},
{
"id": 643,
"name": "Mike Lauren",
"address": "New York",
"email": "[email protected]",
"age": 41
}
]
4.2. 統合テスト
さらに、テストケースを作成して、同じ機能をテストしましょう。
@RunWith(SpringRunner.class)
@SpringBootTest
public class ReactiveEmployeeRepositoryIntegrationTest {
@Autowired
EmployeeRepository repository;
@Before
public void setUp() {
Flux deleteAndInsert = repository.deleteAll()
.thenMany(repository.saveAll(Flux.just(
new Employee(111, "John Doe", "Delaware", "[email protected]", 31),
new Employee(222, "Adam Smith", "North Carolina", "[email protected]", 43),
new Employee(333, "Kevin Dunner", "Virginia", "[email protected]", 24),
new Employee(444, "Mike Lauren", "New York", "[email protected]", 41))));
StepVerifier
.create(deleteAndInsert)
.expectNextCount(4)
.verifyComplete();
}
@Test
public void givenRecordsAreInserted_whenDbIsQueried_thenShouldIncludeNewRecords() {
Mono saveAndCount = repository.count()
.doOnNext(System.out::println)
.thenMany(repository
.saveAll(Flux.just(
new Employee(325, "Kim Jones", "Florida", "[email protected]", 42),
new Employee(654, "Tom Moody", "New Hampshire", "[email protected]", 44))))
.last()
.flatMap(v -> repository.count())
.doOnNext(System.out::println);
StepVerifier
.create(saveAndCount)
.expectNext(6L)
.verifyComplete();
}
@Test
public void givenAgeForFilter_whenDbIsQueried_thenShouldReturnFilteredRecords() {
StepVerifier
.create(repository.findByAgeGreaterThan(35))
.expectNextCount(2)
.verifyComplete();
}
}
5. 結論
要約すると、Spring Data Cassandraを使用してリアクティブ型を使用して、ノンブロッキングアプリケーションを構築する方法を学びました。
いつものように、このチュートリアルover on GitHubのソースコードを確認してください。