23.2. トランザクションの設定

手順23.1 ライブラリーモードでのトランザクションの設定 (XML 設定)

1. トランザクションモードを設定します。

   以下のテーブルで、利用可能なルックアップクラスのリストについての手順を確認します。

   <namedCache ...>
   	<transaction transactionMode="{TRANSACTIONAL,NON_TRANSACTIONAL}">
           ...
   </namedCache>
   

2. トランザクションマネージャーを設定します。

   transactionMode 要素は、キャッシュがトランザクションであるかどうかを設定します。

   <namedCache ...>
   	<transaction transactionMode="TRANSACTIONAL"
   		     transactionManagerLookupClass="{TransactionManagerLookupClass}">
   </namedCache>
   

3. ロックモードを設定します。

   lockingMode パラメーターは、楽観的ロックまたは悲観的ロックのメソッドが使用されるかどうかを決定します。キャッシュが非トランザクションの場合、ロックモードは無視されます。このパラメーターのデフォルト値は OPTIMISTIC です。

   <namedCache ...>
   	<transaction transactionMode="TRANSACTIONAL"
   		     transactionManagerLookupClass="{TransactionManagerLookupClass}"
   		     lockingMode="{OPTIMISTIC,PESSIMISTIC}">
   </namedCache>
   

4. 同期化を指定します。

   useSynchronization 要素は、トランザクションマネージャーを使って同期化を登録するようにキャッシュを設定するか、またはキャッシュ自体を XA リソースとして登録するようにキャッシュを設定します。この要素のデフォルト値は true (同期化の使用) です。

   <namedCache ...>
   	<transaction transactionMode="TRANSACTIONAL"
   		     transactionManagerLookupClass="{TransactionManagerLookupClass}"
   		     lockingMode="{OPTIMISTIC,PESSIMISTIC}"
   		     useSynchronization="{true,false}">
   </namedCache>
   

5. リカバリーを設定します。

   recovery 要素は、true に設定されるとキャッシュのリカバリーを有効にします。
   recoveryInfoCacheName パラメーターは、リカバリー情報が保持されるキャッシュの名前を設定します。キャッシュのデフォルト名は __recoveryInfoCacheName__ です。

   <namedCache ...>
   	<transaction transactionMode="TRANSACTIONAL"
   		     transactionManagerLookupClass="{TransactionManagerLookupClass}"
   		     lockingMode="{OPTIMISTIC,PESSIMISTIC}"
   		     useSynchronization="{true,false}">
   		<recovery enabled="true" 
   			  recoveryInfoCacheName="{CacheName}" />
   </namedCache>
   

6. 書き込みスキューチェックを設定します。

   writeSkew チェックは、異なるトランザクションからのエントリーに対する変更によりトランザクションがロールバックされるべきかどうかを判別します。true に設定された書き込みスキューにより、isolation_level を REPEATABLE_READ に設定する必要があります。writeSkew および isolation_level のデフォルト値はそれぞれ false と READ_COMMITTED です。

   <namedCache ...>   
   	<transaction ...>
   	<locking isolation_level="{READ_COMMITTED,REPEATABLE_READ}" 
   	 	 writeSkew="{true,false}" />
           ...
   </namedCache>
   

7. エントリーのバージョン管理を設定します。

   クラスター化されたキャッシュについては、エントリーのバージョン管理を有効にし、その値を SIMPLE に設定することにより書き込みスキューのチェックを有効にします。

   <namedCache ...>
   	<transaction ...>
   	<locking ...>
   	<versioning enabled="{true,false}" 
   		    versioningScheme="{NONE|SIMPLE}"/>
           ...
   </namedCache>
   

手順23.2 ライブラリーモード (プログラムを用いた設定) でトランザクションを設定します。

1. トランザクションモードを設定します。

   以下のようにトランザクションモードを設定します。

   Configuration config = new ConfigurationBuilder()/* ... */.transaction()
           .transactionMode(TransactionMode.TRANSACTIONAL);
   

2. トランザクションマネージャーを設定します。

   以下のテーブルで、利用可能なルックアップクラスのリストについての手順を確認します。

   Configuration config = new ConfigurationBuilder()/* ... */.transaction()
           .transactionMode(TransactionMode.TRANSACTIONAL)
           .transactionManagerLookup(new GenericTransactionManagerLookup());
   

3. ロックモードを設定します。

   lockingMode 値は、楽観的または悲観的ロックを使用するかどうかを決定します。キャッシュが非トランザクションの場合、ロックモードは無視されます。デフォルト値は OPTIMISTIC です。

   Configuration config = new ConfigurationBuilder()/* ... */.transaction()
           .transactionMode(TransactionMode.TRANSACTIONAL)
           .transactionManagerLookup(new GenericTransactionManagerLookup());
           .lockingMode(LockingMode.OPTIMISTIC);
   

4. 同期化を指定します。

   useSynchronization 値は、トランザクションマネージャーを使って同期化を登録するようにキャッシュを設定するか、またはキャッシュ自体を XA リソースとして登録するようにキャッシュを設定します。デフォルト値は true (同期の使用) です。

   Configuration config = new ConfigurationBuilder()/* ... */.transaction()
           .transactionMode(TransactionMode.TRANSACTIONAL)
           .transactionManagerLookup(new GenericTransactionManagerLookup());
           .lockingMode(LockingMode.OPTIMISTIC)
           .useSynchronization(true);
   

5. リカバリーを設定します。

   recovery パラメーターは、true に設定されるとキャッシュのリカバリーを有効にします。
   recoveryInfoCacheName は、リカバリー情報が保持されるキャッシュの名前を設定します。キャッシュのデフォルト名は RecoveryConfiguration.DEFAULT_RECOVERY_INFO_CACHE によって指定されます。

   Configuration config = new ConfigurationBuilder()/* ... */.transaction()
           .transactionMode(TransactionMode.TRANSACTIONAL)
           .transactionManagerLookup(new GenericTransactionManagerLookup());
           .lockingMode(LockingMode.OPTIMISTIC)
           .useSynchronization(true)
           .recovery()
               .recoveryInfoCacheName("anotherRecoveryCacheName");
   

6. 書き込みスキューチェックを設定します。

   writeSkew チェックは、異なるトランザクションからのエントリーに対する変更によりトランザクションがロールバックされるべきかどうかを判別します。true に設定された書き込みスキューにより、isolation_level を REPEATABLE_READ に設定する必要があります。writeSkew および isolation_level のデフォルト値はそれぞれ false と READ_COMMITTED です。

   Configuration config = new ConfigurationBuilder()/* ... */.locking()
           .isolationLevel(IsolationLevel.REPEATABLE_READ).writeSkewCheck(true);
   

7. エントリーのバージョン管理を設定します。

   クラスター化されたキャッシュについては、エントリーのバージョン管理を有効にし、その値を SIMPLE に設定することにより書き込みスキューのチェックを有効にします。

   Configuration config = new ConfigurationBuilder()/* ... */.versioning()
           .enable()
           .scheme(VersioningScheme.SIMPLE);