jdbc.exclusive-connection.mode

eclipselink.jdbc.exclusive-connection.modeを使用して、TopLinkでいつ書込み接続による読取りを実行するかを指定します。

値

表5-45は、この永続性プロパティの値を説明しています。

表5-45 jdbc.exclusive-connection.modeの有効値

Value 説明

Value	説明
`Transactional`	(デフォルト)一部またはすべてのエンティティで独立キャッシュが必要な場合には独立クライアント・セッションを作成し、それ以外の場合にはクライアント・セッションを作成します。注意: TopLinkでは、トランザクションの継続期間中、接続を排他的に維持します。トランザクション内部では、TopLinkによって、すべての書込みおよび読取りが排他接続を介して実行されます。 TopLinkトランザクション外部では、読取りごとに新しい接続が接続プールから取得され、問合せが実行されると即時に解放されます。
`Isolated`	独立エンティティを読み取る場合には排他独立クライアント・セッションを作成し、それ以外の場合にはエラーが発生します。注意: TopLinkでは、所有する`EntityManager`の存続期間中、接続を排他的に維持します。トランザクション内部では、TopLinkによって、すべての書込みおよび読取りが排他接続を介して実行されます。 TopLinkトランザクション外部では、独立エンティティのみが排他接続によって読み取られます。非独立エンティティの場合、TopLinkでは、読取りごとに新しい接続が接続プールから取得され、問合せが実行されると即時に接続が解放されます。
`Always`	独立エンティティを読み取る場合には排他独立クライアント・セッションを作成し、それ以外の場合には排他クライアント・セッションを作成します。注意: TopLinkでは、所有する`EntityManager`の存続期間中、接続を排他的に維持し、すべての書込みおよび読取りを排他接続を介して実行します。

Transactional

(デフォルト)一部またはすべてのエンティティで独立キャッシュが必要な場合には独立クライアント・セッションを作成し、それ以外の場合にはクライアント・セッションを作成します。

注意:

TopLinkでは、トランザクションの継続期間中、接続を排他的に維持します。
トランザクション内部では、TopLinkによって、すべての書込みおよび読取りが排他接続を介して実行されます。
TopLinkトランザクション外部では、読取りごとに新しい接続が接続プールから取得され、問合せが実行されると即時に解放されます。

Isolated

独立エンティティを読み取る場合には排他独立クライアント・セッションを作成し、それ以外の場合にはエラーが発生します。

注意:

TopLinkでは、所有するEntityManagerの存続期間中、接続を排他的に維持します。
トランザクション内部では、TopLinkによって、すべての書込みおよび読取りが排他接続を介して実行されます。
TopLinkトランザクション外部では、独立エンティティのみが排他接続によって読み取られます。非独立エンティティの場合、TopLinkでは、読取りごとに新しい接続が接続プールから取得され、問合せが実行されると即時に接続が解放されます。

Always

独立エンティティを読み取る場合には排他独立クライアント・セッションを作成し、それ以外の場合には排他クライアント・セッションを作成します。

注意: TopLinkでは、所有するEntityManagerの存続期間中、接続を排他的に維持し、すべての書込みおよび読取りを排他接続を介して実行します。

使用方法

このプロパティは、EntityManagerFactoryを作成するときに(createEntityManagerFactoryメソッドに渡すマップまたはpersistence.xmlファイルのいずれかに)設定するか、またはEntityManagerを作成するときに(createEntityManagerメソッドに渡すマップに)設定できます。前者は後者によってオーバーライドされることに注意してください。

例

例5-40 persitence.xmlでのjdbc.exclusive-connection.modeの使用

property name="eclipselink.jdbc.exclusive-connection.mode" value="Always"/>

例5-41 プロパティ・マップでのjdbc.exclusive-connection.modeの使用

import org.eclipse.persistence.config.PersistenceUnitProperties;
propertiesMap.put(PersistenceUnitProperties.EXCLUSIVE_CONNECTION_MODE, "Always");