Module jakarta.persistence

Package jakarta.persistence

Class EntityNotFoundException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

jakarta.persistence.PersistenceException

jakarta.persistence.EntityNotFoundException

All Implemented Interfaces:

Serializable

public class EntityNotFoundException
extends PersistenceException

Thrown by the persistence provider when:

• EntityHandler.get(java.lang.Class<T>, java.lang.Object) cannot return an instance of the requested entity type because there is no matching record in the database,
• an entity reference obtained by calling EntityManager.getReference(java.lang.Class<T>, java.lang.Object) is accessed but the reference has no corresponding record in the database,
• an entity is passed to EntityManager.refresh(java.lang.Object) or EntityAgent.refresh(java.lang.Object) and its record no longer exists in the database,
• an entity is passed to EntityManager.lock(java.lang.Object, jakarta.persistence.LockModeType), a pessimistic lock mode is requested, and the record no longer exists in the database.

If the persistence context is joined to an active transaction, the transaction is automatically marked for rollback when this exception is thrown.

Since:

1.0

See Also:

• EntityHandler.get(Class, Object)
• EntityHandler.get(Class, Object, LockModeType)
• EntityHandler.get(Class, Object, FindOption...)
• EntityHandler.get(EntityGraph, Object, FindOption...)
• EntityHandler.getMultiple(Class, List, FindOption...)
• EntityHandler.getMultiple(EntityGraph, List, FindOption...)
• EntityManager.getReference(Class,Object)
• EntityManager.getReference(Object)
• EntityManager.refresh(Object)
• EntityManager.refresh(Object, LockModeType)
• EntityManager.refresh(Object, RefreshOption...)
• EntityManager.refresh(Object, java.util.Map)
• EntityManager.refresh(Object, LockModeType, java.util.Map)
• EntityManager.lock(Object, LockModeType)
• EntityManager.lock(Object, LockModeType, LockOption...)
• EntityManager.lock(Object, LockModeType, java.util.Map)
• EntityAgent.refresh(Object)
• EntityAgent.refresh(Object, LockModeType)
• EntityAgent.refreshMultiple(List)
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
EntityNotFoundException()	Constructs a new EntityNotFoundException exception with null as its detail message.
EntityNotFoundException(Exception cause)	Constructs a new EntityNotFoundException exception with null as its detail message.
EntityNotFoundException(String message)	Constructs a new EntityNotFoundException exception with the specified detail message.
EntityNotFoundException(String message, Exception cause)	Constructs a new EntityNotFoundException exception with the specified detail message.

Method Summary

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

EntityNotFoundException

public EntityNotFoundException()

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

EntityNotFoundException

public EntityNotFoundException(Exception cause)

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

EntityNotFoundException

public EntityNotFoundException(String message)

Constructs a new EntityNotFoundException exception with the specified detail message.

Parameters:

message - the detail message.

EntityNotFoundException

public EntityNotFoundException(String message,
 Exception cause)

Constructs a new EntityNotFoundException exception with the specified detail message.

Parameters:

message - the detail message.