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

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

<namedCache <!-- Additional configuration information here -->>
	<transaction <!-- Additional configuration information here --> >
	<locking <!-- Additional configuration information here --> >
	<versioning enabled="{true,false}" 
		    versioningScheme="{NONE|SIMPLE}"/>
        <!-- Additional configuration information here -->
</namedCache>

1. versioning パラメーターの enabled パラメーターを true に設定します。
2. versioningScheme パラメーターを NONE または SIMPLE のいずれかに設定して、使用するバージョン管理スキームを設定します。

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

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

   1. トランザクションモードを設定します。
   2. ルックアップクラスを選択し、設定します。利用可能なルックアップクラスのリストについては、この手順の下にある表を参照してください。
   3. lockingMode 値は、楽観的または悲観的ロックを使用するかどうかを決定します。キャッシュが非トランザクションの場合、ロックモードは無視されます。デフォルト値は OPTIMISTIC です。
   4. useSynchronization 値は、トランザクションマネージャーを使って同期化を登録するようにキャッシュを設定するか、またはキャッシュ自体を XA リソースとして登録するようにキャッシュを設定します。デフォルト値は true (同期の使用) です。
   5. recovery パラメーターは、true に設定されるとキャッシュのリカバリーを有効にします。
      recoveryInfoCacheName は、リカバリー情報が保持されるキャッシュの名前を設定します。キャッシュのデフォルト名は RecoveryConfiguration.DEFAULT_RECOVERY_INFO_CACHE によって指定されます。

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

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

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

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

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

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