JPA Method
in jakarta.persistence.EntityManager

T getReference(
  Class<T> entityClass, 
  Object primaryKey
)


Obtain a reference to an instance of the given entity class with the given primary key, whose state may be lazily fetched.

If the requested instance does not exist in the database, the EntityNotFoundException is thrown when the instance state is first accessed. (The persistence provider runtime is permitted but not required to throw the EntityNotFoundException when getReference() is called.)

This operation allows the application to create an association to an entity without loading its state from the database.

The application should not expect the instance state to be available upon detachment, unless it was accessed by the application while the entity manager was open.

Parameters:
entityClass - entity class
primaryKey - primary key
Return:
a reference to the entity instance
Throws:
IllegalArgumentException - if the first argument does not denote an entity type or the second argument is not a valid type for that entity's primary key or is null
EntityNotFoundException - if the entity state cannot be accessed
Since:
JPA 1.0