Deprecated API

Contents

• Terminally Deprecated
• Enum Classes
• Annotation Interfaces
• Fields
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
jakarta.persistence.EntityGraph.addSubclassSubgraph(Class<? extends T>)	use EntityGraph.addTreatedSubgraph(Class)
jakarta.persistence.Graph.addKeySubgraph(Attribute<? super T, X>)	use Graph.addMapKeySubgraph(MapAttribute)
jakarta.persistence.Graph.addKeySubgraph(Attribute<? super T, X>, Class<? extends X>)	use Graph.addTreatedMapKeySubgraph(MapAttribute, Class)
jakarta.persistence.Graph.addSubgraph(Attribute<? super T, X>, Class<? extends X>)	use Graph.addTreatedSubgraph(Attribute, Class)
jakarta.persistence.Persistence()	This class is not intended to be extended nor instantiated, it is going to be marked final when this constructor becomes hidden.
jakarta.persistence.Persistence.PERSISTENCE_PROVIDER	TODO: Either change TCK reference to PERSISTENCE_PROVIDER field to expect "jakarta.persistence.spi.PersistenceProvider" or remove PERSISTENCE_PROVIDER field and also update TCK signature tests.
jakarta.persistence.Persistence.providers
jakarta.persistence.spi.PersistenceUnitTransactionType	replaced by PersistenceUnitTransactionType

Deprecated Enum Classes

Enum Class	Description
jakarta.persistence.spi.PersistenceUnitTransactionType	replaced by PersistenceUnitTransactionType
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 Fields

Field	Description
jakarta.persistence.Persistence.PERSISTENCE_PROVIDER	TODO: Either change TCK reference to PERSISTENCE_PROVIDER field to expect "jakarta.persistence.spi.PersistenceProvider" or remove PERSISTENCE_PROVIDER field and also update TCK signature tests.
jakarta.persistence.Persistence.providers

Deprecated Methods

Method	Description
jakarta.persistence.criteria.CriteriaQuery.multiselect(Selection<?>...)	Since this method is not typesafe, the use of CriteriaBuilder.array(jakarta.persistence.criteria.Selection<?>...) or CriteriaBuilder.tuple(jakarta.persistence.criteria.Selection<?>...) with CriteriaQuery.select(jakarta.persistence.criteria.Selection<? extends T>) is strongly preferred.
jakarta.persistence.criteria.CriteriaQuery.multiselect(List<Selection<?>>)	Since this method is not typesafe, the use of CriteriaBuilder.array(jakarta.persistence.criteria.Selection<?>...) or CriteriaBuilder.tuple(jakarta.persistence.criteria.Selection<?>...) with CriteriaQuery.select(jakarta.persistence.criteria.Selection<? extends T>) is strongly preferred.
jakarta.persistence.EntityGraph.addSubclassSubgraph(Class<? extends T>)	use EntityGraph.addTreatedSubgraph(Class)
jakarta.persistence.Graph.addKeySubgraph(Attribute<? super T, X>)	use Graph.addMapKeySubgraph(MapAttribute)
jakarta.persistence.Graph.addKeySubgraph(Attribute<? super T, X>, Class<? extends X>)	use Graph.addTreatedMapKeySubgraph(MapAttribute, Class)
jakarta.persistence.Graph.addSubgraph(Attribute<? super T, X>, Class<? extends X>)	use Graph.addTreatedSubgraph(Attribute, Class)
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.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.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 Constructors

Constructor	Description
jakarta.persistence.Persistence()	This class is not intended to be extended nor instantiated, it is going to be marked final when this constructor becomes hidden.