useAttributeAccessor.strategy()

Use the JPA-definedCascadeType

Use the JPA-definedCascadeType. This enumeration will be removed to alleviate the duplication in naming.

UseQueryFlushMode. This enumeration will be removed to alleviate the duplication in naming withFlushModeType.

UseColumn.secondPrecision() which was introduced in JPA 3.2

Use the new approach based onIdGeneratorType.

useGenericGenerator.type() for typesafety

sinceGenericGenerator is deprecated.

useNamedNativeQuery.flush()

useNamedQuery.flush()

Use anExpectation class instead.

useCurrentTimestamp instead

useSQLDelete.verify() with anExpectation class

useSQLDeleteAll.verify() with anExpectation class

useSQLInsert.verify() with anExpectation class

useSQLUpdate.verify() with anExpectation class

Just implementSessionEventListener directly.

UsePhysicalNamingStrategySnakeCaseImpl.

No longer used

Internal code should use the internal implementation classTypeDefinitionRegistryStandardImpl. This class will be removed.

UseNamedStrategyContributor instead

UseNamedStrategyContributor instead

This enumeration is currently unused and will be removed. UseAction instead.

This has no effect and will be removed.

No longer has any effect.

since"hibernate.discard_pc_on_close" is deprecated

with no replacement.

Use settings,TypeContributor,FunctionContributor orAdditionalMappingContributor instead depending on need

no longer called

with no replacement.

This operation is a layer-breaker, exposing an internal type. It will be removed. UseSessionFactoryOptions.buildSessionEventListeners() instead.

This is unused and will be removed.

with no replacement.

This is no longer used

since"hibernate.discard_pc_on_close" is deprecated

Will be removed without replacement. See HHH-15641

Will be removed without replacement. See HHH-15641

UseByteBuddyState.loadProxy(Class, String, BiFunction) instead.

Register aBytecodeProvider through Javaservices.

UseBytecodeProvider.getReflectionOptimizer(Class, Map) insstead

This setting no longer has any effect.

This is no longer useful and will be removed.

Will be removed, Hibernate ORM will use the BytecodeProvider implementation it finds on the classpath loading it via the standard ServiceLoader mechanism. Currently, there is only a single implementation which is included in Hibernate ORM, so it's not possible to override this. See HHH-17643

Will be removed without replacement. See HHH-15641

Will be removed without replacement. See HHH-15641

It's not necessary to set this explicitly

UseGlobalTemporaryTableStrategy.CREATE_ID_TABLES.

UseGlobalTemporaryTableStrategy.DROP_ID_TABLES.

UseLocalTemporaryTableStrategy.DROP_ID_TABLES.

UsePersistentTableStrategy.CREATE_ID_TABLES.

UsePersistentTableStrategy.DROP_ID_TABLES.

This setting is now ignored. Enable the log categoryorg.hibernate.session.metrics to automatically collect and log session-level metrics.

UsePersistentBag.bagAsList() orPersistentBag.collection instead.

UsePersistentIdentifierBag.bagAsList() orPersistentIdentifierBag.collection instead.

useDialect.getCheckCondition(String, Long[]) instead

UseDialect.getNativeValueGenerationStrategy() instead

UseDialect.getSelectClauseNullString(SqlTypedMapping, TypeConfiguration) instead

Moved toDialect

Moved toDialect

UseIdentityColumnSupport.appendIdentitySelectToInsert(String, String) instead.

UseNullability.checkNullability(Object[], EntityPersister)

in favor ofSize(Integer, Integer, Long)

in favor ofSize(Integer, Integer, Long)

UseSchemaNameResolver instead.

This class is no longer used and will be removed

UseCascadingActions.REMOVE

becauseCascadeType.LOCK is deprecated

No longer used

Use anExpectation class

UseSqlAstCreationContext.getFetchProfile(String)

Only used in one place, will be removed

No longer useful, since Java made downcasting safer

No longer useful, since Java made downcasting safer

No longer used, replaced bySharedSessionContractImplementor.instantiate(EntityPersister, Object)

No longer useful, since Java made downcasting safer

No longer useful, since Java made downcasting safer

This is no longer needed

RenamedEventMonitor.

RenamedDiagnosticEvent.

Graph.addElementSubgraph(PluralAttribute) was added in JPA 3.2, and so this method is no longer needed

This will be removed

This will be removed

Planned for removal in JPA 4

Subclasses should now directly inheritPostInsertIdentifierGenerator andBulkInsertionCapableIdentifierGenerator, or even better, simply implementOnExecutionGenerator directly.

replaced byAssigned

UseConfigurable.configure(GeneratorCreationContext, Properties) instead

This remains around as an implementation detail ofhbm.xml mappings.

since it overrides a deprecated method

This is not an elegant way to do anything

UseGeneratedValuesMutationDelegate instead.

no longer set, useJdbcEnvironment.getIdentifierHelper()

Use one ofIdentifierLoadAccess.with(LockMode),IdentifierLoadAccess.with(LockMode, PessimisticLockScope) and/orIdentifierLoadAccess.with(Timeout) instead.

This class is no longer needed and will be removed.

use the default constructor instead

useStandardStack(Object) instead.

No longer used

No longer used

No longer used

No longer used

No longer used

No longer used

Usediscovery instead.

Consider usingdiscovery instead to dynamically locatecontributors.

sincePersistenceUnitTransactionType will be removed in JPA 4

Consider usingdiscovery instead to dynamically locatecontributors.

UseBatchLoaderFactory.createEntityBatchLoader(int, EntityMappingType, LoadQueryInfluencers) instead

UseLoadable.isAffectedByEnabledFilters(LoadQueryInfluencers, boolean) instead

UseLoadable.isAffectedByInfluencers(LoadQueryInfluencers, boolean) instead

As LockOptions will become an SPI, this method will be removed with no replacement

Since JPA 3.2 and Hibernate 7, aLockMode,Timeout, orPessimisticLockScope may be passed directly as an option tofind(),refresh(), orlock(). Therefore, this class is obsolete as an API and will be moved to an SPI package.

For HQL/JPQL queries, locking should be controlled via operations of theSelectionQuery interface:

• A timeout may be set viaCommonQueryContract.setTimeout(Timeout)
• ThePessimisticLockScope may be set usingSelectionQuery.setLockScope(PessimisticLockScope)
• Alias-specific lock modes may be specified usingSelectionQuery.setLockMode(String, LockMode)
• Use of follow-on locking may be enabled viaSelectionQuery.setFollowOnLocking(boolean)

The interfaceTimeouts provides several operations to simplify migration.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

No longer called, except from tests. UseKeyValue.createGenerator(Dialect, RootClass, Property, GeneratorSettings)

No longer supported

becauseTable.ForeignKeyKey should be private.

UseDiscriminable.getDiscriminatorMapping() instead.

UseFilterRestrictable.applyFilterRestrictions(Consumer, TableGroup, boolean, Map, boolean, SqlAstCreationState) instead

UseRestrictable.applyBaseRestrictions(Consumer, TableGroup, boolean, Map, boolean, Set, SqlAstCreationState) instead

No longer used

Higly inefficient - do not use; this exists to support other deprecated methods and will be removed.

UseManagedDomainType.findAttribute(String)

Only called from tests

Only called from tests

No longer called

No longer called

Use one ofMultiIdentifierLoadAccess.with(LockMode),MultiIdentifierLoadAccess.with(LockMode, PessimisticLockScope) and/orMultiIdentifierLoadAccess.with(Timeout) instead.

Use one ofNaturalIdLoadAccess.with(LockMode),NaturalIdLoadAccess.with(LockMode, PessimisticLockScope) and/orNaturalIdLoadAccess.with(Timeout) instead.

Use one ofNaturalIdMultiLoadAccess.with(LockMode),NaturalIdMultiLoadAccess.with(LockMode, PessimisticLockScope) and/orNaturalIdMultiLoadAccess.with(Timeout) instead.

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here (generally),PluralAttributeMapping

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getElementDescriptor()

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getIdentifierDescriptor()

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getIndexDescriptor()

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getKeyDescriptor()

The functionality of DiscriminatorMetadata,DiscriminatorType andMetaType have been consolidated intoEntityDiscriminatorMapping andDiscriminatorConverter

The functionality of DiscriminatorType,DiscriminatorMetadata andMetaType have been consolidated intoEntityDiscriminatorMapping andDiscriminatorConverter

UseDeleteCoordinator.delete(java.lang.Object, java.lang.Object, java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor) instead.

No longer used

SeeManagedMappingType.findAttributeMapping(String)

No longer called

SinceDiscriminatorMetadata is deprecated

UseInsertCoordinator.insert(Object, Object[], SharedSessionContractImplementor) instead.

UseInsertCoordinator.insert(Object, Object, Object[], SharedSessionContractImplementor) instead.

UseUpdateCoordinator.update(java.lang.Object, java.lang.Object, java.lang.Object, java.lang.Object[], java.lang.Object, java.lang.Object[], int[], boolean, org.hibernate.engine.spi.SharedSessionContractImplementor) instead.

UseEntityPersister.processInsertGeneratedProperties(Object, Object, Object[], GeneratedValues, SharedSessionContractImplementor) instead.

UseEntityPersister.processUpdateGeneratedProperties(Object, Object, Object[], GeneratedValues, SharedSessionContractImplementor) instead.

No longer used in ORM core

UseUpdateCoordinator.update(java.lang.Object, java.lang.Object, java.lang.Object, java.lang.Object[], java.lang.Object, java.lang.Object[], int[], boolean, org.hibernate.engine.spi.SharedSessionContractImplementor) instead.

UseModelPartContainer,TableGroupProducer and/orTableGroupJoinProducer instead depending on need

useEntityMutationTarget.getInsertDelegate() instead

No longer used.

UseHibernateHints.HINT_CALLABLE_FUNCTION_RETURN_TYPE.

Replaced withHibernateCriteriaBuilder.arrayIncludes(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIncludes(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIncludes(Object[], Expression)

Replaced withHibernateCriteriaBuilder.arrayIncludesNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIncludesNullable(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIncludesNullable(Object[], Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersects(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersects(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIntersects(Object[], Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersectsNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersectsNullable(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIntersectsNullable(Object[], jakarta.persistence.criteria.Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludes(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludes(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIncludes(Collection, Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludesNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludesNullable(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIncludesNullable(Collection, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersects(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersects(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIntersects(Collection, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersectsNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersectsNullable(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIntersectsNullable(Collection, Expression)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(Subquery, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(Subquery, org.hibernate.query.common.JoinType, boolean)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(Class, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(EntityDomainType, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(JpaCteCriteria, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.joinLateral(Subquery, org.hibernate.query.common.JoinType)

No longer called

SinceLockOptions is transitioning to a new role as an SPI.

Use one ofQuery.setLockMode(LockModeType),SelectionQuery.setHibernateLockMode(org.hibernate.LockMode),Query.setLockScope(jakarta.persistence.PessimisticLockScope) and/orQuery.setTimeout(jakarta.persistence.Timeout) instead.

SinceLockOptions is transitioning to a new role as an SPI.

This enumeration will be removed, and replaced with a simpler boolean-valued switch.

SinceImmutableEntityUpdateQueryHandlingMode is deprecated. UseQueryEngineOptions.allowImmutableEntityUpdate() instead.

UseQueryParameterBindings.empty() instead. Currently unused and can be safely removed.

This interface is no longer needed and will be removed.

UseFunctionRenderer.render(SqlAppender, List, ReturnableType, SqlAstTranslator) instead

UseSqmUtil.isFkOptimizationAllowed(SqmPath, EntityAssociationMapping) instead

this constructor does not carry information about the query which caused the failure

This enum still has exactly one member, and was placed in a package from which it has no usages. It will be removed or moved.

ImplementArgumentsValidator.validate(List, String, BindingContext) instead

UseFunctionArgumentTypeResolver.resolveFunctionArgumentType(List, int, SqmToSqlAstConverter) instead

UseFunctionReturnTypeResolver.resolveFunctionReturnType(ReturnableType, SqmToSqlAstConverter, List, TypeConfiguration) instead

UseSqmSortSpecification(SqmExpression, SortDirection, Nulls) instead

was previously used for HQL. UseSqmUpdateStatement(NodeBuilder) instead

was previously used for Criteria. UseSqmUpdateStatement(Class, SqmCriteriaNodeBuilder) instead.

UseJdbcSessionOwner.getEventMonitor().

UseScrollableResults.getPosition()

UseScrollableResults.position(int)

Because the semantics of this method may change in a future release. UseSession.find(Class, Object) instead.

UseEntityManager.find(Class, Object, FindOption...) instead.

This method will be removed. UseEntityManager.find(Class, Object, FindOption...) instead.

The semantics of this method may change in a future release. UseSessionFactory.createGraphForDynamicEntity(String) together withEntityManager.find(EntityGraph, Object, FindOption...) to loaddynamic entities.

The semantics of this method may change in a future release.

This method will be removed. UseSessionFactory.createGraphForDynamicEntity(String) together withEntityManager.find(EntityGraph, Object, FindOption...) to loaddynamic entities.

This method will be removed. UseEntityManager.lock(Object, LockModeType, LockOption...) instead

This method will be removed. UseEntityManager.refresh(Object, RefreshOption...) instead

UseSessionBuilder.tenantIdentifier(Object) instead

Use one ofSimpleNaturalIdLoadAccess.with(LockMode),SimpleNaturalIdLoadAccess.with(LockMode, PessimisticLockScope) and/orSimpleNaturalIdLoadAccess.with(Timeout) instead.

UseSearchClauseSpecification(CteColumn,SortDirection,Nulls) instead

UseSortSpecification(Expression, SortDirection, Nulls) instead

No longer called

Will be removed. Use the other methods to visit each operation.

Will be removed. Use the other methods to visit each operation.

UseQueryCachePutManager.finishUp(int, SharedSessionContractImplementor) instead

The existence of this method encourages people to pass around references to the SessionFactoryImplementor when they don't need it

in favor ofScrollableResultsConsumer.instance()

UseStatelessSessionBuilder.tenantIdentifier(Object) instead

No direct replacement.

No direct replacement.

Replaced byAttributeMapping

No direct replacement, though seeAttributeMapping andAttributeMetadata

No direct replacement

No direct replacement

No direct replacement

No direct replacement

No direct replacement

Replaced byEntityMappingType. EntityMetamodel was a first attempt at what has becomeEntityMappingType

Replaced byEntityVersionMapping

Replaced byEventType as id-generation has been redefined using the new broadergeneration approach. For 7.0, this is kept around to supporthbm.xml mappings and will be removed in 8.0 once we finally drophbm.xml support.

No direct replacement; seeEntityIdentifierMapping

No direct replacement; seeEntityIdentifierMapping

No direct replacement

No direct replacement

Replaced byAttributeMapping

UseDateTimeUtils.adjustToDefaultPrecision(Temporal, Dialect) instead

in favor ofImmutability.instance()

in favor ofImmutableMutabilityPlan.instance()

UseH2JsonJdbcType instead

UseTimestampUtcAsJdbcTimestampJdbcType

UseTimestampUtcAsOffsetDateTimeJdbcType

UseDdlType.getCastTypeName(Size, SqlExpressible, DdlTypeRegistry) instead

UseDdlType.getCastTypeName(Size, SqlExpressible, DdlTypeRegistry) instead

UseDdlType.getCastTypeName(Size, SqlExpressible, DdlTypeRegistry) instead

No longer used

Is not called anymore

This very old approach was never properly implemented in all contexts, and never actually achieved the type safety it aimed for. Just useParameterizedType for now.

ImplementUserType.nullSafeGet(ResultSet, int, WrapperOptions)

ImplementUserType.nullSafeSet(PreparedStatement, Object, int, WrapperOptions)

Use settings,TypeContributor,FunctionContributor orAdditionalMappingContributor instead depending on need

Prefer the form of these methods defined onBytecodeLazyAttributeInterceptor instead

Moved, but still need this definition for ehcache

Moved toDialect

UseSchemaNameResolver instead.

No longer used

This is no longer needed

useAuditStrategy instead.

This is no longer implemented by any listener

RenamedEventMonitor.

RenamedDiagnosticEvent.

sinceSession.replicate(java.lang.Object, org.hibernate.ReplicationMode) is deprecated

UseGeneratedValuesMutationDelegate instead.

seeUUIDGenerator

Consider usingdiscovery instead to dynamically locatecontributors.

Use theSpecHints form instead

The functionality of DiscriminatorMetadata,DiscriminatorType andMetaType have been consolidated intoEntityDiscriminatorMapping andDiscriminatorConverter

UseModelPartContainer,TableGroupProducer and/orTableGroupJoinProducer instead depending on need

This interface is no longer needed and will be removed.

SpatialDialects are no longer needed since Hibernate 6.0

Will be removed in 6

UseTupleTransformer and/orResultListTransformer instead

Replaced byAttributeMapping

No direct replacement; seeEntityIdentifierMapping

No direct replacement

This very old approach was never properly implemented in all contexts, and never actually achieved the type safety it aimed for. Just useParameterizedType for now.

Just implementSessionEventListener directly.

UsePhysicalNamingStrategySnakeCaseImpl.

Internal code should use the internal implementation classTypeDefinitionRegistryStandardImpl. This class will be removed.

Moved toDialect

This class is no longer used and will be removed

useDefaultAuditStrategy instead.

useValidityAuditStrategy instead.

sinceSession.replicate(java.lang.Object, org.hibernate.ReplicationMode) is deprecated

because bothSource andhbm.xml are deprecated, though this implementation is instructive

Subclasses should now directly inheritPostInsertIdentifierGenerator andBulkInsertionCapableIdentifierGenerator, or even better, simply implementOnExecutionGenerator directly.

sinceUUIDHexGenerator is deprecated

replaced byAssigned

This remains around as an implementation detail ofhbm.xml mappings.

useUuidGenerator

useUuidGenerator andUuidGenerator instead

This remains around as an implementation detail ofhbm.xml mappings.

This class is no longer needed and will be removed.

UseClassLoaderService instead

This is a legacy of very ancient versions of Hibernate.

Hibernate now uses StAX for XML processing and the role of this class is served now byLocalXmlResourceResolver

The JPA specification does not require that we allow entity lifecycle callbacks on embeddable classes, and this is a misfeature since:

• an embeddable objects doesn't have a well-defined lifecycle,
• it's difficult to understand what this means for composite collection elements, and
• currently, thePreUpdate/PostUpdate callbacks get called when the embeddable object is not itself being updated.

It would be OK to simply remove this capability, since fortunately we never documented it.

UseAvailableHints instead

Since JPA 3.2 and Hibernate 7, aLockMode,Timeout, orPessimisticLockScope may be passed directly as an option tofind(),refresh(), orlock(). Therefore, this class is obsolete as an API and will be moved to an SPI package.

For HQL/JPQL queries, locking should be controlled via operations of theSelectionQuery interface:

• A timeout may be set viaCommonQueryContract.setTimeout(Timeout)
• ThePessimisticLockScope may be set usingSelectionQuery.setLockScope(PessimisticLockScope)
• Alias-specific lock modes may be specified usingSelectionQuery.setLockMode(String, LockMode)
• Use of follow-on locking may be enabled viaSelectionQuery.setFollowOnLocking(boolean)

The interfaceTimeouts provides several operations to simplify migration.

Please get rid of it: such collections should be immutable.

The functionality of DiscriminatorType,DiscriminatorMetadata andMetaType have been consolidated intoEntityDiscriminatorMapping andDiscriminatorConverter

Spatial Dialects are no longer needed. Use the standard CockroachDB dialects

Spatial dialects are no longer needed

Use "hibernate.dialect.storage_engine=innodb" environment variable or JVM system property instead.

Spatial Dialects are no longer needed

Use "hibernate.dialect.storage_engine=innodb" environment variable or JVM system property instead.

Spatial Dialects are no longer needed

SpatialDialects are no longer needed in Hibernate 6

A SpatialDialect is no longer required. Use the standard Dialect for this database.

A SpatialDialect is no longer required. Use the standard Dialect for this database.

A SpatialDialect is no longer required. Use the standard Dialect for this database.

A SpatialDialect is no longer required. Use the standard Dialect for this database.

A SpatialDialect is no longer required. Use the standard Dialect for this database.

A SpatialDialect is no longer required. Use the standard Dialect for this database.

UseGeolatteSpatialCriteriaBuilder instead

UseGeolatteSpatialCriteriaBuilder instead

UseJTSSpatialCriteriaBuilder instead

sinceResultTransformer is deprecated

sinceResultTransformer is deprecated

sinceResultTransformer is deprecated

sinceResultTransformer is deprecated

sinceResultTransformer is deprecated

No direct replacement.

No direct replacement.

No direct replacement, though seeAttributeMapping andAttributeMetadata

No direct replacement

No direct replacement

No direct replacement

No direct replacement

No direct replacement

Replaced byEntityMappingType. EntityMetamodel was a first attempt at what has becomeEntityMappingType

Replaced byEntityVersionMapping

No direct replacement; seeEntityIdentifierMapping

No direct replacement

Replaced byAttributeMapping

UseImmutableObjectArrayMutabilityPlan.get() for object arrays, or implement a dedicated mutability plan for primitive arrays (see for exampleShortPrimitiveArrayJavaType's mutability plan).

UseH2JsonJdbcType instead

UseTimestampUtcAsJdbcTimestampJdbcType

UseTimestampUtcAsOffsetDateTimeJdbcType

useFloatJdbcType

Use the JPA-definedCascadeType. This enumeration will be removed to alleviate the duplication in naming.

UseQueryFlushMode. This enumeration will be removed to alleviate the duplication in naming withFlushModeType.

Use anExpectation class instead.

This enumeration is currently unused and will be removed. UseAction instead.

All dialects currently useTempTableDdlTransactionHandling.NONE, so it's obsolete.

Use anExpectation class

Use Jakarta PersistenceNulls instead.

This enumeration will be removed, and replaced with a simpler boolean-valued switch.

This enum still has exactly one member, and was placed in a package from which it has no usages. It will be removed or moved.

sinceSession.replicate(Object, ReplicationMode) is deprecated

To be replaced byCommonSpatialFunction

Replaced byEventType as id-generation has been redefined using the new broadergeneration approach. For 7.0, this is kept around to supporthbm.xml mappings and will be removed in 8.0 once we finally drophbm.xml support.

It would be nice to be able to eliminate this completely

Methods ofInterceptor are no longer required to throw this exception type.

Use the JPA-definedCascadeType

PreferTable.check(),Column.check(), etc., with@CheckConstraint.

sinceCheck is deprecated.

PreferTable.comment(),Column.comment(), etc.

PerComment, preferTable.comment()

UseColumn.secondPrecision() which was introduced in JPA 3.2

Use the new approach based onIdGeneratorType.

sinceGenericGenerator is deprecated.

useCurrentTimestamp instead

Register aBytecodeProvider through Javaservices.

This setting no longer has any effect.

This is no longer useful and will be removed.

UseAvailableSettings.JAKARTA_LOCK_SCOPE instead

UseAvailableSettings.JAKARTA_LOCK_TIMEOUT instead

UseBatchSettings.BUILDER instead

Will be removed, Hibernate ORM will use the BytecodeProvider implementation it finds on the classpath loading it via the standard ServiceLoader mechanism. Currently, there is only a single implementation which is included in Hibernate ORM, so it's not possible to override this. See HHH-17643

Will be removed without replacement. See HHH-15641

Will be removed without replacement. See HHH-15641

this is only honored forhibernate-infinispan

UseCacheSettings.JAKARTA_SHARED_CACHE_MODE instead

UseCacheSettings.JAKARTA_SHARED_CACHE_RETRIEVE_MODE instead

UseCacheSettings.JAKARTA_SHARED_CACHE_STORE_MODE instead

This setting is only supported byC3P0ConnectionProvider andDriverManagerConnectionProviderImpl.

The JPA-standard"jakarta.persistence.jtaDataSource" or"jakarta.persistence.nonJtaDataSource" setting are now preferred.

UseJdbcSettings.JAKARTA_HBM2DDL_DB_MAJOR_VERSION instead

UseJdbcSettings.JAKARTA_HBM2DDL_DB_MINOR_VERSION instead

UseJdbcSettings.JAKARTA_HBM2DDL_DB_NAME instead

UseJdbcSettings.JAKARTA_HBM2DDL_DB_VERSION instead

The JPA-standard settingJdbcSettings.JAKARTA_JDBC_DRIVER is now preferred.

UseJdbcSettings.JAKARTA_HBM2DDL_CONNECTION instead

UseJdbcSettings.JAKARTA_JDBC_DRIVER instead

UseJdbcSettings.JAKARTA_JDBC_PASSWORD instead

UseJdbcSettings.JAKARTA_JDBC_URL instead

UseJdbcSettings.JAKARTA_JDBC_USER instead

UseJdbcSettings.JAKARTA_JTA_DATASOURCE instead

UseJdbcSettings.JAKARTA_NON_JTA_DATASOURCE instead

The JPA-standard settingJdbcSettings.JAKARTA_JDBC_PASSWORD is now preferred.

The JPA-standard settingJdbcSettings.JAKARTA_JDBC_URL is now preferred.

It's not necessary to set this explicitly

The JPA-standard settingJdbcSettings.JAKARTA_JDBC_USER is now preferred.

No longer has any effect. Since 7.0 (and removal of save/update processing), Hibernate always cascadesPERSIST

PreferJpaComplianceSettings.JPA_QUERY_COMPLIANCE

UseManagedBeanSettings.JAKARTA_CDI_BEAN_MANAGER instead

UsePersistenceSettings.JAKARTA_PERSISTENCE_PROVIDER instead

UsePersistenceSettings.JAKARTA_TRANSACTION_TYPE instead

this setting is not currently used

UseGlobalTemporaryTableStrategy.CREATE_ID_TABLES.

UseGlobalTemporaryTableStrategy.DROP_ID_TABLES.

UseLocalTemporaryTableStrategy.DROP_ID_TABLES.

UsePersistentTableStrategy.CREATE_ID_TABLES.

UsePersistentTableStrategy.DROP_ID_TABLES.

The JPA-standard settingSchemaToolingSettings.JAKARTA_HBM2DDL_CREATE_SCHEMAS is now preferred.

UseSchemaToolingSettings.JAKARTA_HBM2DDL_CREATE_SCHEMAS instead

Migrate toSchemaToolingSettings.JAKARTA_HBM2DDL_CREATE_SCRIPT_SOURCE

Migrate toSchemaToolingSettings.JAKARTA_HBM2DDL_CREATE_SOURCE instead

UseSchemaToolingSettings.JAKARTA_HBM2DDL_DATABASE_ACTION instead

Migrate toSchemaToolingSettings.JAKARTA_HBM2DDL_DROP_SCRIPT_SOURCE

Migrate toSchemaToolingSettings.JAKARTA_HBM2DDL_DROP_SOURCE.

The JPA-standard settingSchemaToolingSettings.JAKARTA_HBM2DDL_LOAD_SCRIPT_SOURCE is now preferred.

UseSchemaToolingSettings.JAKARTA_HBM2DDL_LOAD_SCRIPT_SOURCE instead

UseSchemaToolingSettings.JAKARTA_HBM2DDL_SCRIPTS_ACTION instead

Migrate toSchemaToolingSettings.JAKARTA_HBM2DDL_SCRIPTS_CREATE_TARGET

Migrate toSchemaToolingSettings.JAKARTA_HBM2DDL_SCRIPTS_DROP_TARGET

This setting is now ignored. Enable the log categoryorg.hibernate.session.metrics to automatically collect and log session-level metrics.

UseValidationSettings.JAKARTA_PERSIST_VALIDATION_GROUP instead

UseValidationSettings.JAKARTA_REMOVE_VALIDATION_GROUP instead

UseValidationSettings.JAKARTA_UPDATE_VALIDATION_GROUP instead

UseValidationSettings.JAKARTA_VALIDATION_FACTORY instead

UseValidationSettings.JAKARTA_VALIDATION_MODE instead

UsePersistentBag.bagAsList() orPersistentBag.collection instead.

UsePersistentIdentifierBag.bagAsList() orPersistentIdentifierBag.collection instead.

UseCascadingActions.REMOVE

becauseCascadeType.LOCK is deprecated

UseGraphLanguageLexer.VOCABULARY instead.

UseGraphLanguageParser.VOCABULARY instead.

UseHqlLexer.VOCABULARY instead.

UseHqlParser.VOCABULARY instead.

UseSqlScriptLexer.VOCABULARY instead.

UseSqlScriptParser.VOCABULARY instead.

UseOrderingLexer.VOCABULARY instead.

UseOrderingParser.VOCABULARY instead.

This is not an elegant way to do anything

no longer set, useJdbcEnvironment.getIdentifierHelper()

UseExpectation.RowCount

UseExpectation.None

UseExpectation.OutParameter

Usediscovery instead.

Consider usingdiscovery instead to dynamically locatecontributors.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

This, and the other constants on this class, will be removed.

this feature of HQL is now deprecated

UseHibernateHints.HINT_CALLABLE_FUNCTION_RETURN_TYPE.

UseQueryParameterBindings.empty() instead. Currently unused and can be safely removed.

in favor ofScrollableResultsConsumer.instance()

in favor ofImmutability.instance()

in favor ofImmutableMutabilityPlan.instance()

useAttributeAccessor.strategy()

useGenericGenerator.type() for typesafety

useNamedNativeQuery.flush()

useNamedQuery.flush()

useSQLDelete.verify() with anExpectation class

useSQLDeleteAll.verify() with anExpectation class

useSQLInsert.verify() with anExpectation class

useSQLUpdate.verify() with anExpectation class

(since 7.0) Not used; no replacement.

With move to unified schema, this setting is now deprecated and will be removed once support for readinghbm.xml files is fully removed.

Set thehibernate-models settinghibernate.models.jandex.index instead. This method has no effect.

PreferMetadataSources.getMappingXmlBindings() and/orMetadataSources.getHbmXmlBindings()

User should useNamedStoredProcedureQuery instead

No longer used

See discussion ofTypeContributor in User Guide.

UseTypeContributions.contributeType(BasicType) instead.

UseTypeContributions.contributeType(BasicType) instead.

UseNamedStrategyContributor instead

UseNamedStrategyContributor instead

This has no effect and will be removed.

No longer has any effect.

since"hibernate.discard_pc_on_close" is deprecated

with no replacement.

hbm.xml mapping file support is deprecated. Useextended orm.xml bindings instead.

Set via thehibernate-models settinghibernate.models.jandex.index instead

No longer supported

useInFlightMetadataCollector.getConverterRegistry()

useInFlightMetadataCollector.getConverterRegistry()

useInFlightMetadataCollector.getConverterRegistry()

UseInFlightMetadataCollector.getTypeDefinitionRegistry() instead

useInFlightMetadataCollector.getConverterRegistry()

UseBootstrapContext.getModelsContext() instead.

no longer called

with no replacement.

This operation is a layer-breaker, exposing an internal type. It will be removed. UseSessionFactoryOptions.buildSessionEventListeners() instead.

This is unused and will be removed.

with no replacement.

This is no longer used

since"hibernate.discard_pc_on_close" is deprecated

Will be removed without replacement. See HHH-15641

Will be removed without replacement. See HHH-15641

UseByteBuddyState.loadProxy(Class, String, BiFunction) instead.

UseBytecodeProvider.getReflectionOptimizer(Class, Map) insstead

only because it's currently never called

In dialect implementations, preferDatabaseVersion.makeCopyOrDefault(DatabaseVersion) to gracefully default to the minimum supported version.

In dialect implementations, preferDatabaseVersion.makeCopyOrDefault(DatabaseVersion) to gracefully default to the minimum supported version.

useDialect.getCheckCondition(String, Long[]) instead

Since Hibernate now baselines on Java 17,Connection.getSchema() is always available directly. Never used internally.

No longer used

UseDialect.getForUpdateString(LockMode,Timeout) instead

UseDialect.getNativeValueGenerationStrategy() instead

Override the methodrenderInsertIntoNoColumns() on thetranslator returned by this dialect.

UseDialect.getReadLockString(Timeout) instead.

UseDialect.getReadLockString(String, Timeout) instead.

UseDialect.getSelectClauseNullString(SqlTypedMapping, TypeConfiguration) instead

No dialect currently overrides this, so it's obsolete

UseTimeouts.getTimeoutInSeconds(int) instead.

UseDialect.getWriteLockString(Timeout) instead.

UseDialect.getWriteLockString(String, Timeout) instead.

UseIdentityColumnSupport.appendIdentitySelectToInsert(String, String) instead.

UseLockingStrategy.lock(Object, Object, Object, int, SharedSessionContractImplementor)

UseMySQLServerConfiguration.fromDialectResolutionInfo(org.hibernate.engine.jdbc.dialect.spi.DialectResolutionInfo) instead.

UseNullability.checkNullability(Object[], EntityPersister)

Use a providedSqlStringGenerationContext instead.

this method should be removed; alternative methods are available that better express the intent, allowing for better optimisations. Not aggressively removing this as it's an SPI, but also useful for testing and other contexts which are not performance sensitive. N.B. This might return an immutable map: do not use for mutations!

Just as the method it overrides. Interceptors that deal with lazy state should implementBytecodeLazyAttributeInterceptor

Just as the method it overrides. Interceptors that deal with lazy state should implementBytecodeLazyAttributeInterceptor

Interceptors that deal with * lazy state should implementBytecodeLazyAttributeInterceptor

UseSqlAstCreationContext.getFetchProfile(String)

Only used in one place, will be removed

No longer useful, since Java made downcasting safer

No longer useful, since Java made downcasting safer

No longer used, replaced bySharedSessionContractImplementor.instantiate(EntityPersister, Object)

No longer useful, since Java made downcasting safer

No longer useful, since Java made downcasting safer

Use@AuditOverride(forClass=SomeEntity.class) instead.

useRevisionListener instead. While this method is being deprecated, expect a new API for this in 6.0.

Instead use setLockOptions

useAuditStrategy.perform(Session, String, Configuration, Object, Object, Object)

useAuditStrategy.performCollectionChange(Session, String, String, Configuration, PersistentCollectionChangeData, Object)

with no replacement.

UseEventListenerGroup.clearListeners() instead, which doesn't also reset the registeredDuplicationStrategys.

this is not the most efficient way for iterating the event listeners. SeeEventListenerGroup.fireEventOnEachListener(Object, BiConsumer) and its overloaded variants for better alternatives.

There is no plan to remove this operation, but its use should be avoided sinceFilterDefinition is an SPI type, and so this operation is a layer-breaker.

This operation is not properly type safe. Note thatgraph.addAttributeNode(att).makeKeySubGraph() is a synonym forgraph.addMapKeySubgraph(att).

This operation is not properly type safe. Note thatgraph.addAttributeNode(att).makeKeySubGraph(cl) is a synonym forgraph.addTreatedMapKeySubgraph(att,cl).

This operation is not properly type safe. Note thatgraph.addAttributeNode(att).makeSubGraph() is a synonym forgraph.addSubgraph(att).

This operation is not properly type safe. Note thatgraph.addAttributeNode(att).makeSubGraph(cl) is a synonym forgraph.addTreatedSubgraph(att,cl).

Since it is not type safe and returns a raw type

Since it is not type safe, returns a raw type, and accepts a string

Since it is not type safe and returns a raw type

UseEntityGraphs.setFetchGraph(TypedQuery, EntityGraph) instead

Since it accepts a string instead ofGraphSemantic

UseEntityGraphs.setGraph(TypedQuery, EntityGraph, GraphSemantic) instead

UseGraph.addKeySubgraph(String)

UseGraph.addKeySubgraph(String, Class)

UseGraph.addTreatedMapKeySubgraph(MapAttribute, Class)

Graph.addElementSubgraph(PluralAttribute) was added in JPA 3.2, and so this method is no longer needed

UseGraph.addSubgraph(String)

UseGraph.addSubgraph(String, Class)

UseGraph.addTreatedSubgraph(Attribute, Class)

UseGraph.addSubgraph(Attribute)

UseGraph.getAttributeNode(String)

UseGraph.getAttributeNode(Attribute)

This will be removed

This will be removed

UseGraphSemantic.getJakartaHintName() instead

Planned for removal in JPA 4

UseConfigurable.configure(GeneratorCreationContext, Properties) instead

Exposed for tests only.

UseDatabaseStructure.configure(Optimizer) instead.

Exposed for tests only.

since it overrides a deprecated method

Exposed for tests only.

useIdentifierLoadAccess.withLoadGraph(jakarta.persistence.EntityGraph<T>)

Use one ofIdentifierLoadAccess.with(LockMode),IdentifierLoadAccess.with(LockMode, PessimisticLockScope) and/orIdentifierLoadAccess.with(Timeout) instead.

UseInterceptor.onRemove(Object, Object, Object[], String[], Type[])

UseInterceptor.onPersist(Object, Object, Object[], String[], Type[])

useSessionFactoryImpl.configuredInterceptor(Interceptor, boolean, SessionFactoryOptions)

UseArray.newInstance(Class, int) instead.

No longer used

No longer used

No longer used

Depending on context, eitherClassLoaderService orClassLoaderAccess should be preferred

No longer used

No longer used

No longer used

sincePersistenceUnitTransactionType will be removed in JPA 4

No longer has any effect.

Always enabled. SeeJpaCompliance.isJpaCascadeComplianceEnabled()

UseBatchLoaderFactory.createEntityBatchLoader(int, EntityMappingType, LoadQueryInfluencers) instead

UseLoadable.isAffectedByEnabledFilters(LoadQueryInfluencers, boolean) instead

UseLoadable.isAffectedByInfluencers(LoadQueryInfluencers, boolean) instead

As LockOptions will become an SPI, this method will be removed with no replacement

useLockOptions.getAliasSpecificLocks()

useCheckConstraint.constraintString(Dialect) instead.

useIndex.getSelectableOrderMap()

useIndex.getSelectables()

No longer called, except from tests. UseKeyValue.createGenerator(Dialect, RootClass, Property, GeneratorSettings)

No longer supported

See discussion inEmbeddableCallback.

See discussion inEmbeddableCallback.

No longer supported

No longer supported

new read-by-position paradigm means that these generated aliases are no longer needed

new read-by-position paradigm means that these generated aliases are no longer needed

UseTable.addInitCommand(Function) instead.

becauseTable.ForeignKeyKey should be private.

Should build aQualifiedTableName then useSqlStringGenerationContext.format(QualifiedTableName).

UseDiscriminable.getDiscriminatorMapping() instead.

SeeContributable.getContributor()

No longer supported

UseFilterRestrictable.applyFilterRestrictions(Consumer, TableGroup, boolean, Map, boolean, SqlAstCreationState) instead

should be removed

UseRestrictable.applyBaseRestrictions(Consumer, TableGroup, boolean, Map, boolean, Set, SqlAstCreationState) instead

No longer used

Higly inefficient - do not use; this exists to support other deprecated methods and will be removed.

UseManagedDomainType.findAttribute(String)

Only called from tests

Only called from tests

No longer called

No longer called

useMultiIdentifierLoadAccess.withLoadGraph(jakarta.persistence.EntityGraph<T>)

Use one ofMultiIdentifierLoadAccess.with(LockMode),MultiIdentifierLoadAccess.with(LockMode, PessimisticLockScope) and/orMultiIdentifierLoadAccess.with(Timeout) instead.

Use one ofNaturalIdLoadAccess.with(LockMode),NaturalIdLoadAccess.with(LockMode, PessimisticLockScope) and/orNaturalIdLoadAccess.with(Timeout) instead.

useNaturalIdMultiLoadAccess.withLoadGraph(jakarta.persistence.EntityGraph<T>)

Use one ofNaturalIdMultiLoadAccess.with(LockMode),NaturalIdMultiLoadAccess.with(LockMode, PessimisticLockScope) and/orNaturalIdMultiLoadAccess.with(Timeout) instead.

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here (generally),PluralAttributeMapping

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getElementDescriptor()

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

useCollectionPersister.getGenerator()

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getIdentifierDescriptor()

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getIndexDescriptor()

Read-by-position makes this irrelevant. Currently still used bySQLQueryParser

Hibernate is moving away fromType. Correspondingmapping metamodel calls should be used instead - here,PluralAttributeMapping.getKeyDescriptor()

by the supertypes

Hibernate no longer uses aliases to read from result sets

Hibernate no longer uses aliases to read from result sets

Hibernate no longer uses aliases to read from result sets

Hibernate no longer uses aliases to read from result sets

This feature is no longer supported

UseDeleteCoordinator.delete(java.lang.Object, java.lang.Object, java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor) instead.

UseSelectableMapping.getSelectionExpression() instead

No longer used

useEntityPersister.getGenerator()

SeeManagedMappingType.findAttributeMapping(String)

UseEntityPersister.getValue(java.lang.Object, int) instead

UseEntityPersister.getValues(java.lang.Object) instead

No longer called

Only ever used from places where we really want to use

• SelectStatement (select generator)
• InsertSelectStatement
• UpdateStatement
• DeleteStatement

SinceDiscriminatorMetadata is deprecated

UseEntityPersister.canReadFromCache() and/orEntityPersister.canWriteToCache() depending on need

UseInsertCoordinator.insert(Object, Object[], SharedSessionContractImplementor) instead.

UseInsertCoordinator.insert(Object, Object, Object[], SharedSessionContractImplementor) instead.

UseEntityPersister.load(Object, Object, LockMode, SharedSessionContractImplementor)

UseEntityPersister.lock(Object, Object, Object, LockMode, SharedSessionContractImplementor)

UseEntityPersister.lock(Object, Object, Object, LockOptions, SharedSessionContractImplementor)

UseUpdateCoordinator.update(java.lang.Object, java.lang.Object, java.lang.Object, java.lang.Object[], java.lang.Object, java.lang.Object[], int[], boolean, org.hibernate.engine.spi.SharedSessionContractImplementor) instead.

UseEntityPersister.multiLoad(Object[], SharedSessionContractImplementor, MultiIdLoadOptions)

UseEntityPersister.processInsertGeneratedProperties(Object, Object, Object[], GeneratedValues, SharedSessionContractImplementor) instead.

UseEntityPersister.processUpdateGeneratedProperties(Object, Object, Object[], GeneratedValues, SharedSessionContractImplementor) instead.

UseEntityPersister.setValue(java.lang.Object, int, java.lang.Object) instead

UseEntityPersister.setValues(java.lang.Object, java.lang.Object[]) instead

No longer used in ORM core

UseUpdateCoordinator.update(java.lang.Object, java.lang.Object, java.lang.Object, java.lang.Object[], java.lang.Object, java.lang.Object[], int[], boolean, org.hibernate.engine.spi.SharedSessionContractImplementor) instead.

useEntityMutationTarget.getInsertDelegate() instead

UseInsertCoordinatorStandard.getBatchKey()

No longer used.

UseByteBuddyProxyHelper.buildUnloadedProxy(TypePool, TypeDefinition, Collection) instead.

useCommonQueryContract.getQueryFlushMode()

useCommonQueryContract.getQueryFlushMode()

useCommonQueryContract.setQueryFlushMode(QueryFlushMode)

useCommonQueryContract.setQueryFlushMode(QueryFlushMode)

sinceTemporalType is deprecated

sinceTemporalType is deprecated

sinceTemporalType is deprecated

sinceTemporalType is deprecated

sinceTemporalType is deprecated

sinceTemporalType is deprecated

sinceTemporalType is deprecated

sinceTemporalType is deprecated

Replaced withHibernateCriteriaBuilder.arrayIncludes(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIncludes(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIncludes(Object[], Expression)

Replaced withHibernateCriteriaBuilder.arrayIncludesNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIncludesNullable(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIncludesNullable(Object[], Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersects(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersects(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIntersects(Object[], Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersectsNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.arrayIntersectsNullable(Expression, Object[])

Replaced withHibernateCriteriaBuilder.arrayIntersectsNullable(Object[], jakarta.persistence.criteria.Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludes(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludes(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIncludes(Collection, Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludesNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIncludesNullable(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIncludesNullable(Collection, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersects(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersects(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIntersects(Collection, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersectsNullable(Expression, Expression)

Replaced withHibernateCriteriaBuilder.collectionIntersectsNullable(Expression, Collection)

Replaced withHibernateCriteriaBuilder.collectionIntersectsNullable(Collection, Expression)

UseHibernateCriteriaBuilder.sort(JpaExpression, SortDirection, Nulls) instead

UseHibernateCriteriaBuilder.sort(JpaExpression, SortDirection, Nulls, boolean) instead

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(Subquery, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(Subquery, org.hibernate.query.common.JoinType, boolean)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(Class, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(EntityDomainType, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.join(JpaCteCriteria, org.hibernate.query.common.JoinType)

This method is a layer-breaker, leaking the SQM typeSqmJoinType onto an API. It will be removed. UseJpaFrom.joinLateral(Subquery, org.hibernate.query.common.JoinType)

No longer called

UseQuery.setEntityGraph(EntityGraph, GraphSemantic) which is more type safe

UseQuery.setEntityGraph(EntityGraph, GraphSemantic) which is more type safe

UseQuery.setEntityGraph(EntityGraph, GraphSemantic) which is more type safe

SinceLockOptions is transitioning to a new role as an SPI.

Use one ofQuery.setLockMode(LockModeType),SelectionQuery.setHibernateLockMode(org.hibernate.LockMode),Query.setLockScope(jakarta.persistence.PessimisticLockScope) and/orQuery.setTimeout(jakarta.persistence.Timeout) instead.

UseQuery.setTupleTransformer(org.hibernate.query.TupleTransformer<T>) orQuery.setResultListTransformer(org.hibernate.query.ResultListTransformer<R>)

useQueryProducer.createNamedQuery(String, Class)

useQueryProducer.createNamedSelectionQuery(String, Class)

useQueryProducer.createNativeQuery(String, Class)

useQueryProducer.createNativeQuery(String, String, Class)

useQueryProducer.createMutationQuery(CriteriaDelete)

useQueryProducer.createMutationQuery(CriteriaUpdate)

The overloaded formQueryProducer.createQuery(String, Class) which takes a result type is strongly recommended in preference to this method, since it returns a typedQuery object, and because it is able to use the given result type to infer theselect list, and even sometimes thefrom clause. Alternatively,QueryProducer.createSelectionQuery(String, Class) is preferred for queries, andQueryProducer.createMutationQuery(String) for insert, update, and delete statements.

The overloaded formQueryProducer.createSelectionQuery(String, Class) which takes a result type is strongly recommended in preference to this method, since it returns a typedSelectionQuery object, and because it is able to use the given result type to infer theselect list, and even sometimes thefrom clause.

useQueryProducer.createNamedQuery(String, Class)

useQueryProducer.createNamedQuery(String, Class)

useQueryProducer.createNamedQuery(String, Class)

SinceLockOptions is transitioning to a new role as an SPI.

SinceImmutableEntityUpdateQueryHandlingMode is deprecated. UseQueryEngineOptions.allowImmutableEntityUpdate() instead.

UseFunctionRenderer.render(SqlAppender, List, ReturnableType, SqlAstTranslator) instead

UseSqmUtil.isFkOptimizationAllowed(SqmPath, EntityAssociationMapping) instead

ImplementArgumentsValidator.validate(List, String, BindingContext) instead

UseFunctionArgumentTypeResolver.resolveFunctionArgumentType(List, int, SqmToSqlAstConverter) instead

UseFunctionReturnTypeResolver.resolveFunctionReturnType(ReturnableType, SqmToSqlAstConverter, List, TypeConfiguration) instead

useTypedParameterValue.type

useTypedParameterValue.type

useTypedParameterValue.value

UseJdbcSessionOwner.getEventMonitor().

UseScrollableResults.getPosition()

UseScrollableResults.position(int)

useQueryProducer.createMutationQuery(CriteriaDelete)

useQueryProducer.createMutationQuery(CriteriaUpdate)

Because the semantics of this method may change in a future release. UseSession.find(Class, Object) instead.

UseEntityManager.find(Class, Object, FindOption...) instead.

This method will be removed. UseEntityManager.find(Class, Object, FindOption...) instead.

The semantics of this method may change in a future release. UseSessionFactory.createGraphForDynamicEntity(String) together withEntityManager.find(EntityGraph, Object, FindOption...) to loaddynamic entities.

The semantics of this method may change in a future release.

This method will be removed. UseSessionFactory.createGraphForDynamicEntity(String) together withEntityManager.find(EntityGraph, Object, FindOption...) to loaddynamic entities.

This method will be removed. UseEntityManager.lock(Object, LockModeType, LockOption...) instead

This method will be removed. UseEntityManager.refresh(Object, RefreshOption...) instead

With no real replacement. For some use cases tryStatelessSession.upsert(Object).

With no real replacement. For some use cases tryStatelessSession.upsert(Object).

This operation exposes the SPI typePhysicalConnectionHandlingMode and is therefore a layer-breaker. UseSessionBuilder.connectionHandling(ConnectionAcquisitionMode, ConnectionReleaseMode) instead.

This operation exposes the SPI typeStatementInspector and is therefore a layer-breaker. UseSessionBuilder.statementInspector(UnaryOperator) instead.

UseSessionBuilder.tenantIdentifier(Object) instead

There is no plan to remove this operation, but its use should be avoided sinceFilterDefinition is an SPI type, and so this operation is a layer-breaker.

There is no plan to remove this operation, but its use should be avoided sinceSessionFactoryOptions is an SPI type, and so this operation is a layer-breaker.

useSharedSessionBuilder.connectionHandling(org.hibernate.ConnectionAcquisitionMode, org.hibernate.ConnectionReleaseMode) instead.

Use one ofSimpleNaturalIdLoadAccess.with(LockMode),SimpleNaturalIdLoadAccess.with(LockMode, PessimisticLockScope) and/orSimpleNaturalIdLoadAccess.with(Timeout) instead.

No longer called

Will be removed. Use the other methods to visit each operation.

Will be removed. Use the other methods to visit each operation.

UseQueryCachePutManager.finishUp(int, SharedSessionContractImplementor) instead

The existence of this method encourages people to pass around references to the SessionFactoryImplementor when they don't need it

useStatistics.getStart()

This operation exposes the SPI typeStatementInspector and is therefore a layer-breaker. UseStatelessSessionBuilder.statementInspector(UnaryOperator) instead.

UseStatelessSessionBuilder.tenantIdentifier(Object) instead

UseStandardTableExporter.applyComments(Table, String, List) instead.

No longer supported

UseNonIdentifierAttribute.isDirtyCheckable() instead

useCollectionType.getElementsIterator(Object)

UseDateTimeUtils.appendAsLocalTime(SqlAppender, Calendar) instead

UseDateTimeUtils.appendAsLocalTime(SqlAppender, Date) instead

UseDateTimeUtils.adjustToDefaultPrecision(Temporal, Dialect) instead

UseDdlType.getCastTypeName(Size, SqlExpressible, DdlTypeRegistry) instead

UseDdlType.getCastTypeName(Size, SqlExpressible, DdlTypeRegistry) instead

UseDdlType.getCastTypeName(Size, SqlExpressible, DdlTypeRegistry) instead

not appropriate for named enum or array types

not appropriate for named enum or array types

not appropriate for named enum or array types, useDdlType.getTypeName(Size, Type, DdlTypeRegistry) instead

not appropriate for named enum or array types, useDdlType.getTypeName(Size, Type, DdlTypeRegistry) instead

not appropriate for named enum or array types, useDdlTypeRegistry.getTypeName(int, Size, Type) instead

not appropriate for named enum or array types, useDdlTypeRegistry.getTypeName(int, Size, Type) instead

No longer used

This operation is not very typesafe, and we're migrating away from its use

This simply isn't a very sensible place to hang theServiceRegistry

This operation is not very typesafe, and we're migrating away from its use

Is not called anymore

ImplementUserType.nullSafeGet(ResultSet, int, WrapperOptions)

ImplementUserType.nullSafeSet(PreparedStatement, Object, int, WrapperOptions)

used by Quarkus

provide aDatabaseVersion

currently used by Hibernate Reactive This version of the constructor should handle the case in which we do actually have the option to access theDatabaseMetaData, but since Hibernate Reactive is currently not making use of it we take a shortcut.

in favor ofSize(Integer, Integer, Long)

in favor ofSize(Integer, Integer, Long)

useRefreshEvent(Object, LockOptions, EventSource) instead.

use the default constructor instead

useStandardStack(Object) instead.

UseLockOptions(LockMode, Timeout) instead

UseLockOptions(LockMode, Timeout, PessimisticLockScope) instead

this constructor does not carry information about the query which caused the failure

this constructor does not carry information about the query which caused the failure

this constructor does not carry information about the query which caused the failure

UseSqmSortSpecification(SqmExpression, SortDirection, Nulls) instead

was previously used for HQL. UseSqmUpdateStatement(NodeBuilder) instead

was previously used for Criteria. UseSqmUpdateStatement(Class, SqmCriteriaNodeBuilder) instead.

this constructor does not carry information about the query which caused the failure

this constructor does not carry information about the query which caused the failure

this constructor does not carry information about the query which caused the failure

UseSearchClauseSpecification(CteColumn,SortDirection,Nulls) instead

UseSortSpecification(Expression, SortDirection, Nulls) instead

UseAnyType(TypeConfiguration, MetaType, Type, boolean) instead

sinceSession.replicate(Object, ReplicationMode) is deprecated

UseUnsupportedEnhancementStrategy.SKIP orUnsupportedEnhancementStrategy.FAIL instead.

useAttributeAccessor.strategy()

useGenericGenerator.type() for typesafety

useNamedNativeQuery.flush()

useNamedQuery.flush()

useSQLDelete.verify() with anExpectation class

useSQLDeleteAll.verify() with anExpectation class

useSQLInsert.verify() with anExpectation class

useSQLUpdate.verify() with anExpectation class

Use@AuditOverride(forClass=SomeEntity.class) instead.