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

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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>
   

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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");
   

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap