Class PessimisticLockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

jakarta.persistence.PersistenceException

jakarta.persistence.PessimisticLockException

All Implemented Interfaces:

Serializable

public class PessimisticLockException
extends PersistenceException

Thrown by the persistence provider when a pessimistic locking conflict occurs. This exception may be thrown by an API call, during flush, or when the transaction commits.

If a PessimisticLockException is thrown by an EntityManager with a persistence context joined to an active transaction, the transaction is automatically marked for rollback when the exception is thrown.

Since:

2.0

See Also:

• EntityHandler.find(Class, Object, FindOption...)
• EntityHandler.find(EntityGraph, Object, FindOption...)
• EntityHandler.findMultiple(Class, List, FindOption...)
• EntityHandler.findMultiple(EntityGraph, List, FindOption...)
• EntityManager.find(Class, Object, LockModeType, java.util.Map)
• EntityManager.lock(Object, LockModeType)
• EntityManager.lock(Object, LockModeType, LockOption...)
• EntityManager.lock(Object, LockModeType, java.util.Map)
• EntityManager.refresh(Object, RefreshOption...)
• EntityManager.refresh(Object, LockModeType, java.util.Map)
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
PessimisticLockException()	Constructs a new PessimisticLockException exception with null as its detail message.
PessimisticLockException(Object entity)	Constructs a new PessimisticLockException exception with the specified entity.
PessimisticLockException(String message)	Constructs a new PessimisticLockException exception with the specified detail message.
PessimisticLockException(String message, Throwable cause)	Constructs a new PessimisticLockException exception with the specified detail message and cause.
PessimisticLockException(String message, Throwable cause, Object entity)	Constructs a new PessimisticLockException exception with the specified detail message, cause, and entity.
PessimisticLockException(Throwable cause)	Constructs a new PessimisticLockException exception with the specified cause.

Method Summary

Modifier and Type	Method	Description
Object	getEntity()	Returns the entity that caused this exception.

Methods inherited from class Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

PessimisticLockException

public PessimisticLockException()

Constructs a new PessimisticLockException exception with null as its detail message.

PessimisticLockException

public PessimisticLockException(String message)

Constructs a new PessimisticLockException exception with the specified detail message.

Parameters:

message - the detail message.

PessimisticLockException

public PessimisticLockException(String message,
 Throwable cause)

Constructs a new PessimisticLockException exception with the specified detail message and cause.

Parameters:

message - the detail message.

cause - the cause.

PessimisticLockException

public PessimisticLockException(Throwable cause)

Constructs a new PessimisticLockException exception with the specified cause.

Parameters:

cause - the cause.

PessimisticLockException

public PessimisticLockException(Object entity)

Constructs a new PessimisticLockException exception with the specified entity.

Parameters:

entity - the entity.

PessimisticLockException

public PessimisticLockException(String message,
 Throwable cause,
 Object entity)

Constructs a new PessimisticLockException exception with the specified detail message, cause, and entity.

Parameters:

message - the detail message.

cause - the cause.

entity - the entity.

Method Details

getEntity

public Object getEntity()

Returns the entity that caused this exception.

Returns:

the entity.