第7章 永続性 SPI

プログラムを使用したキャッシュストアの設定

1. ConfigurationBuilder を使用して、新規の設定オブジェクトを作成します。
2. passivation 要素は Red Hat JBoss Data Grid がストアと通信する方法に影響を与えます。パッシベーションは、インメモリーキャッシュからオブジェクトを削除し、システムやデータベースなどの 2 次データストアに書き込みます。2 次データストアがない場合、オブジェクトはインメモリーキャッシュから削除されるのみです。パッシベーションはデフォルトで false です。
3. addSingleFileStore() 要素は、この設定用のキャッシュストアとして SingleFileStore を追加します。addStore メソッドを使用して追加できる、JDBC キャッシュストアなどの他のストアを作成することができます。
4. shared パラメーターは、キャッシュストアが異なるキャッシュインスタンスによって共有されていることを示します。たとえば、クラスター内のすべてのインスタンスが、同じリモートの共有データベースと通信するために同じ JDBC 設定を使用する場合があります。shared は、デフォルトで false になります。true に設定すると、異なるキャッシュインスタンスによって重複データがキャッシュストアに書き込まれないようにすることができます。
5. preload 要素はデフォルトでは false に設定されます。true に設定されると、キャッシュストアに保存されたデータは、キャッシュの起動時にメモリーにプリロードされます。これにより、キャッシュストアのデータが起動後すぐに利用できるようになり、データをレイジーにロードしたことによるキャッシュ操作の遅延を防ぐことができます。プリロードされたデータは、ノード上でローカルのみに保存され、プリロードされたデータのレプリケーションや分散は行われません。JBoss Data Grid は、エビクションのエントリーの最大設定数までの数をプリロードします。
6. fetchPersistentState 要素は、キャッシュの永続状態をフェッチするかどうかを決定し、クラスターに参加する際にこれをローカルキャッシュストアに適用します。キャッシュストアが共有される場合、キャッシュが同じキャッシュストアにアクセスするためフェッチ永続状態は無視されます。複数のキャッシュストアでこのプロパティーが true に設定された場合にキャッシュサービスを起動すると、設定の例外が発生します。fetchPersistentState プロパティーはデフォルトでは false です。
7. purgeOnStartup要素は、キャッシュストアの起動時にキャッシュストアをパージするかどうかを制御し、デフォルトでは false になります。
8. location 設定要素は、ストアが書き込みできるディスクの場所を設定します。
9. これらの属性は、それぞれのキャッシュストアに固有の内容を設定します。たとえば、location 属性は、SingleFileStore がデータが含まれるファイルを維持する場所を指します。他のストアには、さらに複雑な設定が必要な場合があります。
10. singleton 要素を使用すると、クラスター内の 1 つのノードのみで変更を保存できます。このノードはコーディネーターと呼ばれます。コーディネーターは、インメモリー状態のキャッシュをディスクにプッシュします。この機能は、すべてのノードの enabled 属性を true に設定することによりアクティベートされます。shared パラメーターは、singleton を同時に有効にした状態で定義することはできません。enabled 属性はデフォルトでは false です。
11. pushStateWhenCoordinator 要素はデフォルトでは true に設定されます。true の場合、このプロパティーにより、コーディネーターになったノードがインメモリー状態を基礎となるキャッシュストアに転送します。このパラメーターは、コーディネーターがクラッシュし、新規のコーディネーターが選択される場合に役に立ちます。

LevelDB キャッシュストアのプログラムを使用した設定

1. ConfigurationBuilder を使用して、新規の設定オブジェクトを作成します。
2. LevelDBCacheStoreConfigurationBuilder クラスを使用してストアを追加し、その設定を構築します。
3. LevelDB キャッシュストアのロケーションパスを設定します。指定したパスは、主なキャッシュストアデータを保存します。ディレクトリーがない場合は自動的に作成されます。
4. LevelDB ストアの expiredLocation パラメーターを使用して、期限切れデータの場所を指定します。指定されたパスは、パージされる前に期限切れデータを保存します。ディレクトリーがない場合は自動的に作成されます。

JdbcBinaryStore のプログラムを使用した設定 (ライブラリーモード)

1. ConfigurationBuilder を使用して、新規の設定オブジェクトを作成します。
2. JdbcBinaryStore 設定ビルダーを追加して、このストアに関連する固有の設定を構築します。
3. fetchPersistentState 要素は、キャッシュの永続状態をフェッチするかどうかを決定し、クラスターに参加する際にこれをローカルキャッシュストアに適用します。キャッシュストアが共有される場合、キャッシュが同じキャッシュストアにアクセスするためフェッチ永続状態は無視されます。複数のキャッシュローダーでこのプロパティーが true に設定された場合にキャッシュサービスを起動すると、設定の例外が発生します。fetchPersistentState プロパティーはデフォルトでは false です。
4. ignoreModifications 要素は、書き込み操作を共有キャッシュローダーではなく、ローカルファイルキャッシュローダーに許可することで、書き込みメソッドを特定のキャッシュローダーにプッシュするかどうかを決定します。場合によっては、一時的なアプリケーションデータが、インメモリーキャッシュと同じサーバー上のファイルベースのキャッシュローダーにのみ存在する必要があります。たとえば、これはネットワーク内のすべてのサーバーによって使用される追加の JDBC ベースのキャッシュローダーで適用されます。ignoreModifications はデフォルトでは false になります。
5. purgeOnStartup 要素は、初回起動時にキャッシュがパージされるかどうかを指定します。

6. テーブルを以下のように設定します。

   1. dropOnExit は、キャッシュストアが停止している際にテーブルを破棄するかどうかを決定します。これは、デフォルトでは false に設定されます。
   2. createOnStart は、現在テーブルが存在しない場合にキャッシュストアの起動時にテーブルを作成します。このメソッドはデフォルトでは true です。
   3. tableNamePrefix は、データが保存されるテーブルの名前に接頭辞を設定します。
   4. idColumnName プロパティーは、キャッシュキーまたはバケット ID が保存される列を定義します。
   5. dataColumnName プロパティーは、キャッシュエントリーまたはバケットが保存される列を指定します。
   6. timestampColumnName 要素は、キャッシュエントリーまたはバケットのタイムスタンプが保存される列を指定します。

7. The connectionPool 要素は、次のパラメーターを使用して JDBC ドライバーの接続プールを指定します。

   1. connectionUrl パラメーターは、JDBC ドライバー固有の接続 URL を指定します。
   2. username パラメーターには、connectionUrl 経由で接続するために使用されるユーザー名が含まれます。
   3. driverClass パラメーターは、データベースへの接続に使用されるドライバーのクラス名を指定します。

JdbcStringBasedStore のプログラムを使用した設定

1. ConfigurationBuilder を使用して、新規の設定オブジェクトを作成します。
2. JdbcStringBasedStore 設定ビルダーを追加して、このストアに関連する固有の設定を構築します。
3. fetchPersistentState パラメーターは、キャッシュの永続状態をフェッチするかどうかを決定し、クラスターに参加する際にこれをローカルキャッシュストアに適用します。キャッシュストアが共有される場合、キャッシュが同じキャッシュストアにアクセスするためフェッチ永続状態は無視されます。複数のキャッシュローダーでこのプロパティーが true に設定された場合にキャッシュサービスを起動すると、設定の例外が発生します。fetchPersistentState プロパティーはデフォルトでは false です。
4. ignoreModifications パラメーターは、書き込み操作を共有キャッシュローダーではなく、ローカルファイルキャッシュローダーに許可することで、書き込みメソッドを特定のキャッシュローダーにプッシュするかどうかを決定します。場合によっては、一時的なアプリケーションデータが、インメモリーキャッシュと同じサーバー上のファイルベースのキャッシュローダーにのみ存在する必要があります。たとえば、これはネットワーク内のすべてのサーバーによって使用される追加の JDBC ベースのキャッシュローダーで適用されます。ignoreModifications はデフォルトでは false になります。
5. purgeOnStartup パラメーターは、初回起動時にキャッシュがパージされるかどうかを指定します。

6. テーブルの設定

   1. dropOnExit は、キャッシュストアが停止している際にテーブルを破棄するかどうかを決定します。これは、デフォルトでは false に設定されます。
   2. createOnStart は、現在テーブルが存在しない場合にキャッシュストアの起動時にテーブルを作成します。このメソッドはデフォルトでは true です。
   3. tableNamePrefix は、データが保存されるテーブルの名前に接頭辞を設定します。
   4. idColumnName プロパティーは、キャッシュキーまたはバケット ID が保存される列を定義します。
   5. dataColumnName プロパティーは、キャッシュエントリーまたはバケットが保存される列を指定します。
   6. timestampColumnName 要素は、キャッシュエントリーまたはバケットのタイムスタンプが保存される列を指定します。

7. dataSource 要素は、以下のパラメーターを使用してデータソースを指定します。

   • jndiUrl は、既存の JDBC への JNDI URL を指定します。

JdbcMixedStore のプログラムを使用した設定

1. ConfigurationBuilder を使用して、新規の設定オブジェクトを作成します。
2. JdbcMixedStore 設定ビルダーを追加して、このストアに関連する固有の設定を構築します。
3. fetchPersistentState パラメーターは、キャッシュの永続状態をフェッチするかどうかを決定し、クラスターに参加する際にこれをローカルキャッシュストアに適用します。キャッシュストアが共有される場合、キャッシュが同じキャッシュストアにアクセスするためフェッチ永続状態は無視されます。複数のキャッシュローダーでこのプロパティーが true に設定された場合にキャッシュサービスを起動すると、設定の例外が発生します。fetchPersistentState プロパティーはデフォルトでは false です。
4. ignoreModifications パラメーターは、書き込み操作を共有キャッシュローダーではなく、ローカルファイルキャッシュローダーに許可することで、書き込みメソッドを特定のキャッシュローダーにプッシュするかどうかを決定します。場合によっては、一時的なアプリケーションデータが、インメモリーキャッシュと同じサーバー上のファイルベースのキャッシュローダーにのみ存在する必要があります。たとえば、これはネットワーク内のすべてのサーバーによって使用される追加の JDBC ベースのキャッシュローダーで適用されます。ignoreModifications はデフォルトでは false になります。
5. purgeOnStartup パラメーターは、初回起動時にキャッシュがパージされるかどうかを指定します。

6. テーブルを以下のように設定します。

   1. dropOnExit は、キャッシュストアが停止している際にテーブルを破棄するかどうかを決定します。これは、デフォルトでは false に設定されます。
   2. createOnStart は、現在テーブルが存在しない場合にキャッシュストアの起動時にテーブルを作成します。このメソッドはデフォルトでは true です。
   3. tableNamePrefix は、データが保存されるテーブルの名前に接頭辞を設定します。
   4. idColumnName プロパティーは、キャッシュキーまたはバケット ID が保存される列を定義します。
   5. dataColumnName プロパティーは、キャッシュエントリーまたはバケットが保存される列を指定します。
   6. timestampColumnName 要素は、キャッシュエントリーまたはバケットのタイムスタンプが保存される列を指定します。

7. The connectionPool 要素は、次のパラメーターを使用して JDBC ドライバーの接続プールを指定します。

   1. connectionUrl パラメーターは、JDBC ドライバー固有の接続 URL を指定します。
   2. username パラメーターには、connectionUrl 経由で接続するために使用されるユーザー名が含まれます。
   3. driverClass パラメーターは、データベースへの接続に使用されるドライバーのクラス名を指定します。