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(Class, 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(Class, Object) is accessed but the reference has no corresponding record in the database,
• an entity is passed to EntityManager.refresh(Object) or EntityAgent.refresh(Object) and its record no longer exists in the database,
• an entity is passed to EntityManager.lock(Object, LockModeType), a pessimistic lock mode is requested, and the record no longer exists in the database.

If an EntityNotFoundException 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.get(Class, Object)
• 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, 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 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

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.