143 words

refresh(entity, properties) - JPA EntityManager's method

Method
javax.persistence.EntityManager
void refresh(
  Object entity,
  Map<String,Object> properties
)

Refresh the state of the instance from the database, using the specified properties, and overwriting changes made to the entity, if any.

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

Parameters:
entity - entity instance
properties - standard and vendor-specific properties and hints
Throws:
IllegalArgumentException - if the instance is not an entity or the entity is not managed
TransactionRequiredException - if invoked on a container-managed entity manager of type PersistenceContextType.TRANSACTION and there is no transaction
EntityNotFoundException - if the entity no longer exists in the database
Since:
JPA 2.0

This documentation page is derived (with some adjustments) from the open source JPA 2 RI (EclipseLink)
and is available under the terms of the Eclipse Public License, v. 1.0 and Eclipse Distribution License, v. 1.0.
Object Relational Mapping (ORM) JPA 2 providers include Hibernate, EclipseLink, TopLink, OpenJPA and DataNucleus.
Object DB is not an ORM JPA implementation but an Object Database for Java with built in JPA 2 support.