本シリーズでは、VMware Tanzu Data Serviceの１製品である「VMware Tanzu GemFire」について4回の連載となります。
第一回：GemFireのご紹介と機能性
第二回：Gemfireを仮想マシンへのインストールとREST APIによる操作
第三回：GemFire for Kubernetes のご紹介
第四回：Petclinicを使ったGemfire対応アプリケーション

数回に渡りGemfireを紹介する記事を紹介してまいりました。
この第4回ではより深く理解ということで、実際のアプリケーションを使いながらGemfireを解説したいと思います。

サンプルのアプリケーションとして、Springで有名なPetclinicを使い、かつそれをGemfireに切り替える方法を紹介します。

前提

今回の検証を試すには、最低限以下がインストールされた環境で実施が必要になります。

Java 8 (or Java 11)
Gemfireをローカルにインストール(厳密にはこの中のgfshツールを使います)

なお、IntellijやEclipseなどより高度なエディタはオプショナルです。Gemfireのローカルのインストールは以下を参照ください。

Windows/Unix/Linux—Install Pivotal GemFire from a Compressed TAR File
Install Pivotal GemFire from a Homebrew Package

PetClinicとは？

まず、Petclinicを簡単に解説します。Spring PetclinicとはコミュニティによってメンテナンスされているSpringのサンプルアプリケーションです。Spring Petclinicは以下の様々なフォーマットで提供されています。

今回は、この中のSpring Bootフォーマットのものを使います。さて、このSpring Bootバージョンでは、Veterinarians(獣医)の一覧を参照する際に、ehcacheによってキャッシングをしています。つまり、初回のクエリはデータベースから問い合わせるものの、二回目以降はキャッシュ領域から参照するような仕組みにしています。以下Petclinicを解説した資料ですが、その中のp7.で触れられています。

今回の投稿は、これをehcacheのキャッシュではなく、Gemfireのキャッシュに切り替えたいと思います。図で表すと以下のようです。

コードは筆者が編集したものを使います。

https://github.com/mhoshi-vm/spring-petclinic/tree/gemfire-cache

アプリケーションを起動

まずはアプリケーションを起動してみたいと思います。以下のコマンドでコードをローカルにコピーしてください。

git clone -b gemfire-cache https://github.com/mhoshi-vm/spring-petclinic

その後、ディレクトリーに移動して、アプリケーションの起動を以下で実施してください。

cd spring-petclinic
./mvnw spring-boot:run

しばらくすれば、正常にアプリケーションが起動すると思いますので、以下のURLをアクセスしてみてください。

http://localhost:8080/

以下のようにUIにアクセスできれば、成功です。

Gemfireにアクセス

アプリケーションを起動したら、gfshクライアントツールを使い、Gemfireにアクセスします。以下のコマンドを実行してください。専用のプロンプトが起動されます。

gfsh

プロンプトが起動したら以下のコマンドで、Gemfireにアクセスします。

connect
list members

この中で表示されている「SpringBasedCacheServerApplication」は先ほど起動したPetclinicとともに起動したGemfireのインスタンスです。なおここでは、GemfireのClientCacheという機能を使ってローカルで起動するシンプルなGemfireを使っています。本番環境などでは、外部に構成した専用のGemfireクラスターを構成するべきですが、今回は検証目的なので、あくまでこのままで使用します。

さて、この状態で以下のコマンドを実行します。

query –query=”select * from /vets”

これはOQLという言語で、Gemfire内のデータを参照していますが、スクリーンショットにあるよう、「Rows : 0」とあるように特に、なにもデータがない状態であることが確認できます。

データをキャッシング

ここから実際のデータのキャッシュを発生させたいと思います。Petclinicのアプルに戻りVeterinariansをクリックして、獣医一覧の情報だしてください。

獣医の一覧が表示されたあとにgfshに戻り、以下のコマンドを入力します。

query –query=”select * from /vets”
query –query=”select * from /vets.entrySet”

すると、さきほど「Row : 0」だったものが、「Row : 1」となり、かつ2つ目のコマンドでは実際のデータが格納されていることがわかるかと思います。これによって Gemfireのキャッシングが有効になったことがわかります。

データが本当にキャッシュされているかの検証

本当にキャッシュ領域が参照されているのか確認してみたいと思います。なお、ここからの操作は本来は推奨されない、あくまで検証目的の手順ですのでご注意ください。ここでは、アプリケーションの外部から直接SQLでデータベースを編集した場合になにが起きるか見てみます。

Petclinic起動時はデータはh2と呼ばれるインメモリーデータベースに保管されています。以下のURLでデータベースの管理コンソールに以下にアクセスします。

http://localhost:8080/h2-console

なお、「JDBC URL」にいれる値は編集する必要があります。ここに入れる値は、Petclinic起動のたびに変更されます。Petclinicの起動時のログに以下のようなメッセージが出力されているはずですので、起動ログを参照ください。この中の「jdbc:h2:mem:<起動のたびにかわるID>」を指定してください。それ以外はデフォルトのまま(ユーザー名：sa、パスワードは空)でログインできます。