- java.lang.Object
-
- java.lang.Enum<PessimisticLockScope>
-
- javax.persistence.PessimisticLockScope
-
- All Implemented Interfaces:
- Serializable, Comparable<PessimisticLockScope>
public enum PessimisticLockScope extends Enum<PessimisticLockScope>
Defines the values of thejavax.persistence.lock.scope
property for pessimistic locking. This property may be passed as an argument to the methods of theEntityManager
,Query
, andTypedQuery
interfaces that allow lock modes to be specified or used with theNamedQuery
annotation.- Since:
- Java Persistence 2.0
-
-
Enum Constant Summary
Enum Constants Enum Constant and Description EXTENDED
In addition to the behavior forPessimisticLockScope.NORMAL
, element collections and relationships owned by the entity that are contained in join tables will be locked if thejavax.persistence.lock.scope
property is specified with a value ofPessimisticLockScope.EXTENDED
.NORMAL
This value defines the default behavior for pessimistic locking.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method and Description static PessimisticLockScope
valueOf(String name)
Returns the enum constant of this type with the specified name.static PessimisticLockScope[]
values()
Returns an array containing the constants of this enum type, in the order they are declared.
-
-
-
Enum Constant Detail
-
NORMAL
public static final PessimisticLockScope NORMAL
This value defines the default behavior for pessimistic locking.The persistence provider must lock the database row(s) that correspond to the non-collection-valued persistent state of that instance. If a joined inheritance strategy is used, or if the entity is otherwise mapped to a secondary table, this entails locking the row(s) for the entity instance in the additional table(s). Entity relationships for which the locked entity contains the foreign key will also be locked, but not the state of the referenced entities (unless those entities are explicitly locked). Element collections and relationships for which the entity does not contain the foreign key (such as relationships that are mapped to join tables or unidirectional one-to-many relationships for which the target entity contains the foreign key) will not be locked by default.
-
EXTENDED
public static final PessimisticLockScope EXTENDED
In addition to the behavior forPessimisticLockScope.NORMAL
, element collections and relationships owned by the entity that are contained in join tables will be locked if thejavax.persistence.lock.scope
property is specified with a value ofPessimisticLockScope.EXTENDED
. The state of entities referenced by such relationships will not be locked (unless those entities are explicitly locked). Locking such a relationship or element collection generally locks only the rows in the join table or collection table for that relationship or collection. This means that phantoms will be possible.
-
-
Method Detail
-
values
public static PessimisticLockScope[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:for (PessimisticLockScope c : PessimisticLockScope.values()) System.out.println(c);
- Returns:
- an array containing the constants of this enum type, in the order they are declared
-
valueOf
public static PessimisticLockScope valueOf(String name)
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)- Parameters:
name
- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is null
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 17:02:08 Cette version de la page est en cache (à la date du 21/08/2025 17:02:08) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/persistence/PessimisticLockScope.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.