javax.persistence

列挙型 PessimisticLockScope

java.lang.Object

java.lang.Enum<PessimisticLockScope>

javax.persistence.PessimisticLockScope

すべての実装されたインタフェース:

java.io.Serializable, java.lang.Comparable<PessimisticLockScope>

public enum PessimisticLockScope
extends java.lang.Enum<PessimisticLockScope>

悲観ロックのためのjavax.persistence.lock.scopeプロパティの値を定義します。 このプロパティはEntityManagerやQuery、TypedQueryインターフェースのメソッドでロックモードを指定するために引数として渡したり、 NamedQueryアノテーションと同時に使用することができます。

導入されたバージョン:

Java Persistence 2.0

列挙型定数のサマリー

列挙型定数

列挙型定数と説明
EXTENDED javax.persistence.lock.scopeプロパティの値としてPessimisticLockScope.EXTENDEDが指定されている場合、 PessimisticLockScope.NORMALの振る舞いに加えて要素コレクションやエンティティが所有する結合テーブルに含まれるリレーションシップはロックされます。
NORMAL この値は悲観ロックのデフォルトの動作を定義します。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static PessimisticLockScope	valueOf(java.lang.String name) 指定した名前を持つこの型の列挙型定数を返します。
static PessimisticLockScope[]	values() この列挙型の定数を含む配列を宣言されている順序で返します。

クラスから継承されたメソッド java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

クラスから継承されたメソッド java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

列挙型定数の詳細

NORMAL

public static final PessimisticLockScope NORMAL

この値は悲観ロックのデフォルトの動作を定義します。

永続化プロバイダはそのインスタンスのコレクションの値を除いた永続性状態に対応するデータベース行をロックするべきです。 テーブル結合をする継承ストラテジーが使用されている場合やエンティティがセカンダリーテーブルも使用してマッピングされている場合は、 必然的に追加のテーブルの行をエンティティのインスタンスのためにロックします。 ロックされたエンティティの外部キーを含むエンティティのリレーションシップもロックされますが、参照されているエンティティの状態は(エンティティが明示的にロックされている場合を除いて)ロックされません。 エンティティが外部キーを含まない要素コレクションやリレーションシップ (結合テーブルにマッピングされたリレーションシップや、ターゲットのエンティティが外部キーを含む一方向の一対多のリレーションシップなど)はデフォルトではロックされません。

EXTENDED

public static final PessimisticLockScope EXTENDED

javax.persistence.lock.scopeプロパティの値としてPessimisticLockScope.EXTENDEDが指定されている場合、 PessimisticLockScope.NORMALの振る舞いに加えて要素コレクションやエンティティが所有する結合テーブルに含まれるリレーションシップはロックされます。 そのようなリレーションシップによって参照されるエンティティの状態は(エンティティが明示的にロックされている場合を除いて)ロックされません。 一般に、そのようなリレーションシップや要素コレクションをロックすると、そのリレーションシップやコレクションの結合テーブルまたはコレクションテーブルの行のみがロックされます。 これはファントムリードが発生する可能性があることを意味します。

訳注：OneToMeny等でエンティティの関連を作成すると、JoinColumnを指定しない場合は結合テーブル(中間テーブルと呼ばれることも多い)が作成されますが、中間テーブルまでしかロックされません。

メソッドの詳細

values

public static PessimisticLockScope[] values()

この列挙型の定数を含む配列を宣言されている順序で返します。 このメソッドは次のようにして定数を反復するために 使用できます:

for(PessimisticLockScope c: PessimisticLockScope.values())
  System.out.println(c);

戻り値:

この列挙型の定数を含む、宣言されている順序での配列

valueOf

public static PessimisticLockScope valueOf(java.lang.String name)

指定した名前を持つこの型の列挙型定数を返します。 文字列は、この型の列挙型定数を宣言するのに使用した識別子と正確に 一致している必要があります。 (余分な空白文字を含めることはできません。)

パラメータ:

name - 返される列挙型定数の名前。

戻り値:

指定した名前の列挙型定数

例外:

java.lang.IllegalArgumentException - この列挙型に、指定した名前の定数がない場合

java.lang.NullPointerException - 引数がnullの場合