Class OptimisticLockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

jakarta.persistence.PersistenceException

jakarta.persistence.OptimisticLockException

All Implemented Interfaces:

Serializable

public class OptimisticLockException
extends PersistenceException

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

If an OptimisticLockException 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:

1.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.merge(Object)
• EntityManager.remove(Object)
• EntityManager.flush()
• EntityAgent.update(Object)
• EntityAgent.updateMultiple(List)
• EntityAgent.upsert(Object)
• EntityAgent.upsertMultiple(List)
• EntityAgent.delete(Object)
• EntityAgent.deleteMultiple(List)
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
OptimisticLockException()	Constructs a new OptimisticLockException exception with null as its detail message.
OptimisticLockException(Object entity)	Constructs a new OptimisticLockException exception with the specified entity.
OptimisticLockException(String message)	Constructs a new OptimisticLockException exception with the specified detail message.
OptimisticLockException(String message, Throwable cause)	Constructs a new OptimisticLockException exception with the specified detail message and cause.
OptimisticLockException(String message, Throwable cause, Object entity)	Constructs a new OptimisticLockException exception with the specified detail message, cause, and entity.
OptimisticLockException(Throwable cause)	Constructs a new OptimisticLockException 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

OptimisticLockException

public OptimisticLockException()

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

OptimisticLockException

public OptimisticLockException(String message)

Constructs a new OptimisticLockException exception with the specified detail message.

Parameters:

message - the detail message.

OptimisticLockException

public OptimisticLockException(String message,
 Throwable cause)

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

Parameters:

message - the detail message.

cause - the cause.

OptimisticLockException

public OptimisticLockException(Throwable cause)

Constructs a new OptimisticLockException exception with the specified cause.

Parameters:

cause - the cause.

OptimisticLockException

public OptimisticLockException(Object entity)

Constructs a new OptimisticLockException exception with the specified entity.

Parameters:

entity - the entity.

OptimisticLockException

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

Constructs a new OptimisticLockException 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.