okuyamaでのアプリ開発で押さえておきたい機能

はじめに

これまで2回にわたり、okuyamaの導入前と、運用のためのTipsを紹介させていただきましたが、いかがだったでしょうか。

最終回となる今回では、開発で利用するクライアントの機能を主に解説させていただきます。

今回の内容

今回はタイトルのとおり、アプリ開発で押さえておきたいokuyama用のクライアントが持つ機能を以下の6つの項目に絞って解説していきます。今回はJava版のバージョン0.9.0以上のOkuyamaClientを対象として説明を進めていきます。

1. 2つのMasterNodeへの接続設定
2. 有効期限の設定と延長
3. 複数データの同時取得
4. アトミックな更新処理
5. オブジェクトの保存
6. Tagを使ったデータ操作

それでは早速1の「2つのMasterNodeへの接続」から見ていきましょう。

1. 2つのMasterNodeへの接続設定

この機能は読んだままの機能ですが、OkuyamaClientでMasterNodeへ接続する際に複数のMasterNodeを指定する事で、接続中のMasterNodeに障害が発生した際に別のMasterNodeへ自動的に再接続して処理を続行する処理です。1台のMasterNodeで運用する際は利用できませんが、複数台の場合はこちらの接続方法を利用する事をおすすめします。また接続するノードは正常なノードからランダムに選択されます。

この機能を利用するためのOkuyamaClientのメソッド名は、接続先のMasterNodeを指定するメソッドがsetConnectionInfosとなり、接続がautoConnectになります。

コード1（クリックで拡大）

2. 有効期限の設定と延長

次の機能は保存するデータの有効期限を設定する機能です。有効期限は秒数で指定する事が可能で、有効期限が切れたデータは取得できなくなります。そして有効期限が設定されたデータを取得する際に、有効期限を取得した時間から設定した秒数分延長する事が可能です。例えばWebなどのセッション情報をokuyamaに保存する場合に、セッションデータにアクセスする毎に有効期限を延長したい場合などに有効活用してもらえると思います。

この機能を利用するためのOkuyamaClientのメソッド名は有効期限を設定できるメソッドがsetValue、setNewValue、setByteValue、setObjectValueとなり、有効期限を延長するメソッドが、getValueAndUpdateExpireTime、getObjectValueAndUpdateExpireTimeになります。

コード2（クリックで拡大）