Deprecated API

Contents

• Terminally Deprecated
• Enum Classes
• Annotation Interfaces
• Methods
• Annotation Interface Elements

Terminally Deprecated Elements

Element	Description
jakarta.persistence.EntityManager.createEntityGraph(String)	Use EntityHandler.getEntityGraph(String) instead.
jakarta.persistence.EntityManager.createQuery(CriteriaStatement<?>)	Use EntityHandler.createStatement(CriteriaStatement).
jakarta.persistence.Query.executeUpdate()	Use Statement.execute().
jakarta.persistence.Query.getCacheRetrieveMode()	Use TypedQuery.getCacheRetrieveMode()
jakarta.persistence.Query.getCacheStoreMode()	Use TypedQuery.getCacheStoreMode()
jakarta.persistence.Query.getFirstResult()	Use TypedQuery.getFirstResult()
jakarta.persistence.Query.getLockMode()	Use TypedQuery.getLockMode()
jakarta.persistence.Query.getMaxResults()	Use TypedQuery.getMaxResults()
jakarta.persistence.Query.getResultList()	This method returns a raw type. Use TypedQuery.getResultList() to execute queries.
jakarta.persistence.Query.getResultStream()	This method returns a raw type. Use TypedQuery.getResultStream() to execute queries
jakarta.persistence.Query.getSingleResult()	Use TypedQuery.getSingleResult() to execute queries
jakarta.persistence.Query.getSingleResultOrNull()	Use TypedQuery.getSingleResult() to execute queries
jakarta.persistence.Query.setCacheRetrieveMode(CacheRetrieveMode)	Use TypedQuery.setCacheRetrieveMode(CacheRetrieveMode)
jakarta.persistence.Query.setCacheStoreMode(CacheStoreMode)	Use TypedQuery.setCacheStoreMode(CacheStoreMode)
jakarta.persistence.Query.setFirstResult(int)	Use TypedQuery.setFirstResult(int)
jakarta.persistence.Query.setLockMode(LockModeType)	Use TypedQuery.setLockMode(LockModeType)
jakarta.persistence.Query.setMaxResults(int)	Use TypedQuery.setMaxResults(int)
jakarta.persistence.StoredProcedureQuery.getResultList()	This method returns a raw List. Use StoredProcedureQuery.getResultList(Class) instead.
jakarta.persistence.TypedQuery.executeUpdate()	This operation should never be called on a TypedQuery. Any DELETE or UPDATE query should be represented by an untyped instance of Query or, preferably, by an instance of Statement.

Deprecated Enum Classes

Enum Class	Description
jakarta.persistence.TemporalType	Newly written code should use the date/time types defined in java.time.

Deprecated Annotation Interfaces

Annotation Interface	Description
jakarta.persistence.MapKeyTemporal	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Temporal	Newly written code should use the date/time types defined in java.time.

Deprecated Methods

Method	Description
jakarta.persistence.criteria.CriteriaQuery.multiselect(Selection<?>...)	Since this method is not typesafe, the use of CriteriaBuilder.array(Selection...) or CriteriaBuilder.tuple(Selection...) with CriteriaQuery.select(Selection) is strongly preferred.
jakarta.persistence.criteria.CriteriaQuery.multiselect(List<Selection<?>>)	Since this method is not typesafe, the use of CriteriaBuilder.array(Selection...) or CriteriaBuilder.tuple(Selection...) with CriteriaQuery.select(Selection) is strongly preferred.
jakarta.persistence.EntityManager.createEntityGraph(String)	Use EntityHandler.getEntityGraph(String) instead.
jakarta.persistence.EntityManager.createQuery(CriteriaStatement<?>)	Use EntityHandler.createStatement(CriteriaStatement).
jakarta.persistence.EntityManager.getDelegate()	Use EntityHandler.unwrap(Class) instead.
jakarta.persistence.MapKey.name()	Use MapKey.value() instead
jakarta.persistence.Query.executeUpdate()	Use Statement.execute().
jakarta.persistence.Query.getCacheRetrieveMode()	Use TypedQuery.getCacheRetrieveMode()
jakarta.persistence.Query.getCacheStoreMode()	Use TypedQuery.getCacheStoreMode()
jakarta.persistence.Query.getFirstResult()	Use TypedQuery.getFirstResult()
jakarta.persistence.Query.getLockMode()	Use TypedQuery.getLockMode()
jakarta.persistence.Query.getMaxResults()	Use TypedQuery.getMaxResults()
jakarta.persistence.Query.getResultList()	This method returns a raw type. Use TypedQuery.getResultList() to execute queries.
jakarta.persistence.Query.getResultStream()	This method returns a raw type. Use TypedQuery.getResultStream() to execute queries
jakarta.persistence.Query.getSingleResult()	Use TypedQuery.getSingleResult() to execute queries
jakarta.persistence.Query.getSingleResultOrNull()	Use TypedQuery.getSingleResult() to execute queries
jakarta.persistence.Query.setCacheRetrieveMode(CacheRetrieveMode)	Use TypedQuery.setCacheRetrieveMode(CacheRetrieveMode)
jakarta.persistence.Query.setCacheStoreMode(CacheStoreMode)	Use TypedQuery.setCacheStoreMode(CacheStoreMode)
jakarta.persistence.Query.setFirstResult(int)	Use TypedQuery.setFirstResult(int)
jakarta.persistence.Query.setLockMode(LockModeType)	Use TypedQuery.setLockMode(LockModeType)
jakarta.persistence.Query.setMaxResults(int)	Use TypedQuery.setMaxResults(int)
jakarta.persistence.Query.setParameter(int, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Query.setParameter(int, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Query.setParameter(Parameter<Calendar>, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Query.setParameter(Parameter<Date>, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Query.setParameter(String, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Query.setParameter(String, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Statement.setParameter(int, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Statement.setParameter(int, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Statement.setParameter(Parameter<Calendar>, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Statement.setParameter(Parameter<Date>, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Statement.setParameter(String, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.Statement.setParameter(String, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.StoredProcedureQuery.getResultList()	This method returns a raw List. Use StoredProcedureQuery.getResultList(Class) instead.
jakarta.persistence.StoredProcedureQuery.setParameter(int, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.StoredProcedureQuery.setParameter(int, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.StoredProcedureQuery.setParameter(Parameter<Calendar>, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.StoredProcedureQuery.setParameter(Parameter<Date>, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.StoredProcedureQuery.setParameter(String, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.StoredProcedureQuery.setParameter(String, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.TypedQuery.executeUpdate()	This operation should never be called on a TypedQuery. Any DELETE or UPDATE query should be represented by an untyped instance of Query or, preferably, by an instance of Statement.
jakarta.persistence.TypedQuery.setParameter(int, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.TypedQuery.setParameter(int, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.TypedQuery.setParameter(Parameter<Calendar>, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.TypedQuery.setParameter(Parameter<Date>, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.TypedQuery.setParameter(String, Calendar, TemporalType)	Newly written code should use the date/time types defined in java.time.
jakarta.persistence.TypedQuery.setParameter(String, Date, TemporalType)	Newly written code should use the date/time types defined in java.time.

Deprecated Annotation Interface Elements

Annotation Interface Element	Description
jakarta.persistence.MapKey.name()	Use MapKey.value() instead