void refresh(
  Object entity,
  Map<String,Object> properties
)

Refresh the state of the given managed entity instance from the database, using the specified properties, and overwriting unflushed changes made to the entity, if any. This operation cascades to every entity related by an association marked cascade=REFRESH.

If a vendor-specific property or hint is not recognized, it is silently ignored.

Parameters:

entity - a managed entity instance

properties - standard and vendor-specific properties and hints

Throws:

EntityNotFoundException - if the entity no longer exists in the database.

IllegalArgumentException - if the instance is not an entity or the entity is not managed.

TransactionRequiredException - if there is no transaction when invoked on a container-managed entity manager of type PersistenceContextType.TRANSACTION.

Since:

Jakarta Persistence (JPA) 2.0