Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants
• Deprecated Annotation Type Elements

Deprecated Interfaces

Interface and Description
org.hibernate.boot.spi.AdditionalJaxbMappingProducer Intended for Envers integration until we can migrate Envers away from XML generation for building its model.
org.hibernate.ejb.AvailableSettings Use AvailableSettings instead
org.hibernate.ejb.HibernateEntityManager Use HibernateEntityManager instead
org.hibernate.ejb.HibernateEntityManagerFactory Use HibernateEntityManagerFactory instead
org.hibernate.ejb.HibernateEntityManagerImplementor Use HibernateEntityManagerImplementor instead.
org.hibernate.ejb.HibernateQuery Use HibernateQuery instead
org.hibernate.ejb.cfg.spi.IdentifierGeneratorStrategyProvider Use IdentifierGeneratorStrategyProvider instead
org.hibernate.cfg.NamingStrategy A org.hibernate.cfg.naming.NamingStrategyDelegator should be used instead.
org.hibernate.hql.internal.ast.tree.ParameterContainer See entire discussion above
org.hibernate.tuple.Property Use the direct Attribute hierarchy
org.hibernate.cache.RegionFactory Moved, but still need this definition for ehcache
org.hibernate.ejb.packaging.Scanner Use Scanner instead
org.hibernate.integrator.spi.ServiceContributingIntegrator A separate ServiceContributor should be used instead.

Deprecated Classes

Class and Description
org.hibernate.ejb.AbstractEntityManagerImpl Use AbstractEntityManagerImpl instead
org.hibernate.ejb.AbstractQueryImpl Use AbstractQueryImpl instead
org.hibernate.ejb.BaseQueryImpl Use BaseQueryImpl instead
org.hibernate.internal.util.ConfigHelper Use ClassLoaderService instead
org.hibernate.dialect.DerbyDialect HHH-6073
org.hibernate.internal.util.xml.DTDEntityResolver Hibernate now uses StAX for XML processing and the role of this class is served now by LocalXmlResourceResolver
org.hibernate.property.access.spi.EnhancedGetterMethodImpl No longer used; GetterFieldImpl or GetterMethodImpl should be used instead.
org.hibernate.property.access.spi.EnhancedSetterMethodImpl No longer used; EnhancedSetterImpl should be used instead.
org.hibernate.criterion.Expression Use Restrictions instead
org.hibernate.ejb.HibernatePersistence Use HibernatePersistenceProvider instead
org.hibernate.criterion.IlikeExpression Prefer LikeExpression which now has case-insensitivity capability.
org.hibernate.tool.instrument.javassist.InstrumentTask This is the legacy Ant-task Hibernate provided historically to perform its old-school bytecode instrumentation. That has been replaced wholesale with a new approach to bytecode manipulation offering 3 build-time variations for Ant, Maven and Gradle.
org.hibernate.internal.util.jndi.JndiHelper As JNDI access should get routed through JndiService
org.hibernate.id.MultipleHiLoPerTableGenerator Use TableGenerator instead.
org.hibernate.cache.internal.OldNaturalIdCacheKey Cache implementation should provide optimized key.
org.hibernate.dialect.Oracle9Dialect Use either Oracle9iDialect or Oracle10gDialect instead
org.hibernate.dialect.OracleDialect Use Oracle8iDialect instead.
org.hibernate.dialect.PostgreSQLDialect use PostgreSQL82Dialect instead
org.hibernate.mapping.PropertyGeneration This is replaced by ValueGeneration and GenerationTiming
org.hibernate.ejb.QueryHints Use QueryHints instead
org.hibernate.lob.ReaderInputStream Should not be used anymore.
org.hibernate.id.SequenceGenerator Use SequenceStyleGenerator instead
org.hibernate.id.SequenceHiLoGenerator See deprecation discussion on SequenceGenerator
org.hibernate.id.SequenceIdentityGenerator See deprecation discussion on SequenceGenerator
org.hibernate.cfg.Settings Use SessionFactoryOptions instead.
org.hibernate.exception.internal.SQLStateConverter Use StandardSQLExceptionConverter with SQLStateConversionDelegate instead
org.hibernate.tuple.StandardProperty Use one of the Attribute-based impls instead.
org.hibernate.envers.strategy.ValidTimeAuditStrategy use ValidityAuditStrategy instead.
org.hibernate.internal.util.xml.XMLHelper Currently only used for integration with HCANN. The rest of Hibernate uses StAX now for XML processing. See org.hibernate.boot.jaxb.internal.stax

Deprecated Exceptions

Exceptions and Description
org.hibernate.MappingNotFoundException Use MappingNotFoundException instead.
org.hibernate.OptimisticLockException Use OptimisticEntityLockException instead
org.hibernate.cfg.RecoverableException Was only ever referenced in a single place, in an extremely dubious way.
org.hibernate.internal.util.xml.UnsupportedOrmXsdVersionException Migrating to boot package; all usages will eventually be replaced by UnsupportedOrmXsdVersionException

Deprecated Fields

Field and Description
org.hibernate.cfg.AvailableSettings.APP_CLASSLOADER Use AvailableSettings.CLASSLOADERS instead
org.hibernate.jpa.AvailableSettings.AUTODETECTION Use AvailableSettings.SCANNER_DISCOVERY instead
org.hibernate.jpa.AvailableSettings.CLASS_NAMES Was never intended for external use
org.hibernate.jpa.AvailableSettings.CONFIGURATION_JNDI_NAME Configuration going away.
org.hibernate.cache.infinispan.InfinispanRegionFactory.DEF_IMMUTABLE_ENTITY_RESOURCE InfinispanRegionFactory.DEF_ENTITY_RESOURCE is now the default for the InfinispanRegionFactory.IMMUTABLE_ENTITY_CACHE_RESOURCE_PROP property.
org.hibernate.FetchMode.EAGER use FetchMode.JOIN
org.hibernate.internal.util.collections.CollectionHelper.EMPTY_COLLECTION use Collections.EMPTY_LIST or Collections.emptyList() instead
org.hibernate.internal.util.collections.CollectionHelper.EMPTY_LIST use Collections.EMPTY_LIST or Collections.emptyList() instead
org.hibernate.internal.util.collections.CollectionHelper.EMPTY_MAP use Collections.EMPTY_MAP or Collections.emptyMap() instead
org.hibernate.cfg.AvailableSettings.ENVIRONMENT_CLASSLOADER Use AvailableSettings.CLASSLOADERS instead
org.hibernate.sql.JoinFragment.FULL_JOIN use JoinType.FULL_JOIN instead.
org.hibernate.criterion.CriteriaSpecification.FULL_JOIN use JoinType.FULL_JOIN
org.hibernate.cfg.AvailableSettings.HIBERNATE_CLASSLOADER Use AvailableSettings.CLASSLOADERS instead
org.hibernate.id.enhanced.OptimizerFactory.HILO Use StandardOptimizerDescriptor.getExternalName() via StandardOptimizerDescriptor.HILO
org.hibernate.jpa.QueryHints.HINT_TIMEOUT use QueryHints.SPEC_HINT_TIMEOUT instead
org.hibernate.jpa.AvailableSettings.IDENTIFIER_GENERATOR_STRATEGY_PROVIDER if possible wait of Hibernate 4.1 and theService registry (MutableIdentifierGeneratorStrategy service)
org.hibernate.sql.JoinFragment.INNER_JOIN use JoinType.INNER_JOIN instead.
org.hibernate.criterion.CriteriaSpecification.INNER_JOIN use JoinType.INNER_JOIN
org.hibernate.jpa.AvailableSettings.JACC_CONTEXT_ID Use AvailableSettings.JACC_CONTEXT_ID instead
org.hibernate.jpa.AvailableSettings.JACC_ENABLED Use AvailableSettings.JACC_ENABLED instead
org.hibernate.jpa.AvailableSettings.JACC_PREFIX Use AvailableSettings.JACC_PREFIX instead
org.hibernate.jpa.AvailableSettings.JPA_METAMODEL_GENERATION use AvailableSettings.JPA_METAMODEL_POPULATION instead.
org.hibernate.FetchMode.LAZY use FetchMode.SELECT
org.hibernate.criterion.CriteriaSpecification.LEFT_JOIN use JoinType.LEFT_OUTER_JOIN
org.hibernate.sql.JoinFragment.LEFT_OUTER_JOIN use JoinType.LEFT_OUTER_JOIN instead.
org.hibernate.id.enhanced.OptimizerFactory.LEGACY_HILO Use StandardOptimizerDescriptor.getExternalName() via StandardOptimizerDescriptor.LEGACY_HILO
org.hibernate.jpa.AvailableSettings.NAMING_STRATEGY Use AvailableSettings.IMPLICIT_NAMING_STRATEGY or AvailableSettings.PHYSICAL_NAMING_STRATEGY instead
org.hibernate.id.enhanced.OptimizerFactory.NONE Use StandardOptimizerDescriptor.getExternalName() via StandardOptimizerDescriptor.NONE
org.hibernate.jpa.AvailableSettings.PACKAGE_NAMES Was never intended for external use
org.hibernate.id.SequenceGenerator.PARAMETERS No longer supported. To specify initial-value or increment use the org.hibernate.id.enhanced.SequenceStyleGenerator generator instead.
org.hibernate.id.enhanced.OptimizerFactory.POOL Use StandardOptimizerDescriptor.getExternalName() via StandardOptimizerDescriptor.POOLED
org.hibernate.id.enhanced.OptimizerFactory.POOL_LO Use StandardOptimizerDescriptor.getExternalName() via StandardOptimizerDescriptor.POOLED_LO
org.hibernate.cfg.AvailableSettings.PREFER_POOLED_VALUES_LO Use AvailableSettings.PREFERRED_POOLED_OPTIMIZER instead
org.hibernate.cfg.AvailableSettings.PROXOOL_PREFIX Use AvailableSettings.PROXOOL_CONFIG_PREFIX instead
org.hibernate.cfg.AvailableSettings.QUERY_PLAN_CACHE_MAX_SOFT_REFERENCES in favor of AvailableSettings.QUERY_PLAN_CACHE_MAX_SIZE
org.hibernate.cfg.AvailableSettings.QUERY_PLAN_CACHE_MAX_STRONG_REFERENCES in favor of AvailableSettings.QUERY_PLAN_CACHE_PARAMETER_METADATA_MAX_SIZE
org.hibernate.cfg.AvailableSettings.RESOURCES_CLASSLOADER Use AvailableSettings.CLASSLOADERS instead
org.hibernate.sql.JoinFragment.RIGHT_OUTER_JOIN use JoinType.RIGHT_OUTER_JOIN instead.
org.hibernate.jpa.AvailableSettings.SCANNER Prefer AvailableSettings.SCANNER instead
org.hibernate.jpa.AvailableSettings.USE_CLASS_ENHANCER Split into multiple 'hibernate.enhancer.enable[]' properties

Deprecated Methods

Method and Description
org.hibernate.cfg.Configuration.add(XmlDocument) No longer supported.
org.hibernate.boot.MetadataSources.addClass(Class) hbm.xml is a legacy mapping format now considered deprecated.
org.hibernate.cfg.Configuration.addDocument(Document) Use addURL, addResource, addFile, etc. instead
org.hibernate.boot.MetadataSources.addDocument(Document) since 5.0. Use one of the other methods for passing mapping source(s).
org.hibernate.cfg.Configuration.addResource(String, ClassLoader) This form (accepting a ClassLoader) is no longer supported. Instead, add the ClassLoader to the ClassLoaderService on the ServiceRegistry associated with this Configuration
org.hibernate.cfg.Configuration.addXML(String) No longer supported
org.hibernate.dialect.Dialect.appendIdentitySelectToInsert(String) Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().appendIdentitySelectToInsert(String) does not delegate to this method, then this method is ignored.
org.hibernate.dialect.Dialect.appendLockHint(LockMode, String) use appendLockHint(LockOptions,String) instead
org.hibernate.boot.SessionFactoryBuilder.applyDefaultEntityMode(EntityMode) Different entity modes per entity is soon to be removed as a feature.
org.hibernate.boot.SessionFactoryBuilder.applyQuerySubstitutions(Map) This is a legacy feature and should never be needed anymore...
org.hibernate.boot.MetadataBuilder.applyReflectionManager(ReflectionManager) Deprecated (with no replacement) to indicate that this will go away as we migrate away from Hibernate Commons Annotations to Jandex for annotation handling and XMl->annotation merging.
org.hibernate.SharedSessionBuilder.autoClose() For same reasons as SessionBuilder.autoClose(boolean) was deprecated. However, shared session builders can use SharedSessionBuilder.autoClose(boolean) since they do not "inherit" the owner.
org.hibernate.SessionBuilder.autoClose(boolean) Only integrations can specify autoClosing behavior of individual sessions. See SessionOwner
org.hibernate.dialect.Dialect.bindLimitParametersFirst() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.dialect.Dialect.bindLimitParametersInReverseOrder() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.cfg.Configuration.buildMappings() Does nothing
org.hibernate.jpa.internal.metamodel.MetamodelImpl.buildMetamodel(Iterator<PersistentClass>, SessionFactoryImplementor) use MetamodelImpl.buildMetamodel(Iterator, Set, SessionFactoryImplementor, boolean) instead
org.hibernate.id.enhanced.OptimizerFactory.buildOptimizer(String, Class, int) Use OptimizerFactory.buildOptimizer(String, Class, int, long) instead
org.hibernate.dialect.Dialect.buildSQLExceptionConverter() Dialect.buildSQLExceptionConversionDelegate() should be overridden instead.
org.hibernate.tuple.PropertyFactory.buildStandardProperty(Property, boolean) See mainly PropertyFactory.buildEntityBasedAttribute(org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SessionFactoryImplementor, int, org.hibernate.mapping.Property, boolean)
org.hibernate.boot.archive.scan.spi.ScanOptions.canDetectHibernateMappingFiles() With move to unified schema, this setting is now deprecated and will be removed once support for reading hbm.xml files is fully removed.
org.hibernate.engine.config.spi.ConfigurationService.cast(Class<T>, Object) No idea why this is exposed here...
org.hibernate.internal.util.ReflectHelper.classForName(String) Depending on context, either ClassLoaderService or ClassLoaderAccess should be preferred
org.hibernate.c3p0.internal.C3P0ConnectionProvider.close() Use C3P0ConnectionProvider.stop() instead
org.hibernate.proxool.internal.ProxoolConnectionProvider.close() Use ProxoolConnectionProvider.stop() instead
org.hibernate.cfg.Configuration.configure(Document) No longer supported.
org.hibernate.StatelessSession.connection() just missed when deprecating same method from Session
org.hibernate.dialect.Dialect.convertToFirstRowValue(int) Dialect.getLimitHandler() should be overridden instead.
org.hibernate.criterion.ProjectionList.create() an instance factory method does not make sense
org.hibernate.hql.internal.ast.util.ASTUtil.create(ASTFactory, int, String) silly
org.hibernate.Criteria.createAlias(String, String, int) use Criteria.createAlias(String, String, org.hibernate.sql.JoinType)
org.hibernate.criterion.DetachedCriteria.createAlias(String, String, int) use DetachedCriteria.createAlias(String, String, JoinType)
org.hibernate.Criteria.createAlias(String, String, int, Criterion) use Criteria.createAlias(String, String, JoinType, Criterion)
org.hibernate.criterion.DetachedCriteria.createAlias(String, String, int, Criterion) use DetachedCriteria.createAlias(String, String, JoinType, Criterion)
org.hibernate.Criteria.createCriteria(String, int) use Criteria.createAlias(String, String, org.hibernate.sql.JoinType)
org.hibernate.criterion.DetachedCriteria.createCriteria(String, int) use DetachedCriteria.createCriteria(String, JoinType)
org.hibernate.Criteria.createCriteria(String, String, int) use Criteria.createCriteria(String, org.hibernate.sql.JoinType)
org.hibernate.criterion.DetachedCriteria.createCriteria(String, String, int) use DetachedCriteria.createCriteria(String, String, JoinType)
org.hibernate.Criteria.createCriteria(String, String, int, Criterion) use Criteria.createCriteria(String, String, org.hibernate.sql.JoinType, org.hibernate.criterion.Criterion)
org.hibernate.criterion.DetachedCriteria.createCriteria(String, String, int, Criterion) use DetachedCriteria.createCriteria(String, String, JoinType, Criterion)
org.hibernate.id.IdentifierGeneratorHelper.createNumber(long, Class) Use the holders instead.
org.hibernate.type.TypeFactory.custom(Class<UserType>, Properties, TypeFactory.TypeScope) Only for use temporary use by Hibernate
org.hibernate.type.TypeFactory.customComponent(Class<CompositeUserType>, Properties, TypeFactory.TypeScope) Only for use temporary use by Hibernate
org.hibernate.internal.CoreMessageLogger.deprecatedManyToManyFetch() Use DeprecationLogger.deprecatedManyToManyFetch() instead
org.hibernate.internal.CoreMessageLogger.deprecatedManyToManyOuterJoin() Use DeprecationLogger.deprecatedManyToManyOuterJoin() instead
org.hibernate.persister.collection.AbstractCollectionPersister.doProcessQueuedOps(PersistentCollection, Serializable, int, SessionImplementor) Use AbstractCollectionPersister.doProcessQueuedOps(org.hibernate.collection.spi.PersistentCollection, java.io.Serializable, org.hibernate.engine.spi.SessionImplementor)
org.hibernate.bytecode.enhance.spi.Enhancer.enhanceComposite(String, byte[]) Should use enhance(String, byte[]) and a proper EnhancementContext
org.hibernate.dialect.Dialect.forceLimitUsage() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.boot.registry.classloading.internal.ClassLoaderServiceImpl.fromConfigSettings(Map) No longer used/supported!
org.hibernate.usertype.EnhancedUserType.fromXMLString(String) To be removed in 5. Implement StringRepresentableType.fromStringValue(String) instead. See HHH-7776 for details
org.hibernate.dialect.Dialect.getAddUniqueConstraintString(String) Dialect.getUniqueDelegate() should be overridden instead.
org.hibernate.type.BinaryType.getComparator() use RowVersionType for binary entity versions/timestamps
org.hibernate.hql.internal.ast.util.ASTUtil.getConstantName(Class, int) Use #getTokenTypeName instead
org.hibernate.dialect.Dialect.getCreateSequenceStrings(String) Use Dialect.getCreateSequenceString(String, int, int) instead
org.hibernate.hql.internal.ast.tree.ConstructorNode.getDataType() (tell clover to ignore this method)
org.hibernate.cache.ehcache.management.impl.HibernateStatsImpl.getDBSQLExecutionSample() DO NOT USE, WILL ONLY THROW AT YOU!
org.hibernate.action.internal.EntityIdentityInsertAction.getDelayedEntityKey() No Hibernate code currently uses this method
org.hibernate.engine.spi.PersistenceContext.getEntityEntries() Due to the introduction of EntityEntryContext and bytecode enhancement; only valid really for sizing, see PersistenceContext.getNumberOfManagedEntities(). For iterating the entity/EntityEntry combos, see PersistenceContext.reentrantSafeEntityEntries()
org.hibernate.metadata.ClassMetadata.getIdentifier(Object) Use ClassMetadata.getIdentifier(Object,SessionImplementor) instead
org.hibernate.persister.entity.EntityPersister.getIdentifier(Object) Use EntityPersister.getIdentifier(Object,SessionImplementor) instead
org.hibernate.tuple.entity.EntityTuplizer.getIdentifier(Object) Use EntityTuplizer.getIdentifier(Object,SessionImplementor) instead.
org.hibernate.engine.spi.Mapping.getIdentifierGeneratorFactory() temporary solution
org.hibernate.dialect.Dialect.getIdentityColumnString() use Dialect.getIdentityColumnString(int) instead
org.hibernate.dialect.Dialect.getIdentityColumnString(int) Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().getIdentityColumnString(int) does not delegate to this method, then this method is ignored.
org.hibernate.dialect.Dialect.getIdentityInsertString() Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().getIdentityInsertString() does not delegate to this method, then this method is ignored.
org.hibernate.dialect.Dialect.getIdentitySelectString() use Dialect.getIdentitySelectString(String, String, int) instead
org.hibernate.dialect.Dialect.getIdentitySelectString(String, String, int) Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().getIdentitySelectString(String,String,int) does not delegate to this method, then this method is ignored.
org.hibernate.engine.spi.SessionFactoryImplementor.getJdbcServices() since 5.0; use SessionFactoryImplementor.getServiceRegistry() instead to locate the JdbcServices
org.hibernate.dialect.Dialect.getKeywords() These are only ever used (if at all) from the code that handles identifier quoting. So see Dialect.buildIdentifierHelper(org.hibernate.engine.jdbc.env.spi.IdentifierHelperBuilder, java.sql.DatabaseMetaData) instead
org.hibernate.dialect.Dialect.getLimitString(String, boolean) Dialect.getLimitHandler() should be overridden instead.
org.hibernate.dialect.Dialect.getLimitString(String, int, int) Dialect.getLimitHandler() should be overridden instead.
org.hibernate.sql.Select.getLockMode() Instead use getLockOptions
org.hibernate.engine.query.spi.ParameterMetadata.getNamedParameterExpectedType(String) Use NamedParameterDescriptor.getExpectedType() from the ParameterMetadata.getNamedParameterDescriptor(java.lang.String) return instead
org.hibernate.engine.query.spi.ParameterMetadata.getNamedParameterSourceLocations(String) Use NamedParameterDescriptor.getSourceLocations() from the ParameterMetadata.getNamedParameterDescriptor(java.lang.String) return instead
org.hibernate.tuple.Property.getNode() DOM4j entity mode is no longer supported
org.hibernate.mapping.PersistentClass.getOptimisticLockMode() prefer PersistentClass.getOptimisticLockStyle()
org.hibernate.engine.query.spi.ParameterMetadata.getOrdinalParameterExpectedType(int) Use OrdinalParameterDescriptor.getExpectedType() from the ParameterMetadata.getOrdinalParameterDescriptor(int) return instead
org.hibernate.engine.query.spi.ParameterMetadata.getOrdinalParameterSourceLocation(int) Use OrdinalParameterDescriptor.getSourceLocation() from the ParameterMetadata.getOrdinalParameterDescriptor(int) return instead
org.hibernate.InstantiationException.getPersistentClass() Use InstantiationException.getUninstantiatableClass() instead
org.hibernate.persister.entity.AbstractEntityPersister.getPropertyInsertGenerationInclusions() no simple, direct replacement
org.hibernate.persister.entity.EntityPersister.getPropertyInsertGenerationInclusions() Replaced internally with InMemoryValueGenerationStrategy / InDatabaseValueGenerationStrategy
org.hibernate.persister.entity.AbstractEntityPersister.getPropertyUpdateGenerationInclusions() no simple, direct replacement
org.hibernate.persister.entity.EntityPersister.getPropertyUpdateGenerationInclusions() Replaced internally with InMemoryValueGenerationStrategy / InDatabaseValueGenerationStrategy
org.hibernate.mapping.Table.getQualifiedName(Dialect, String, String) Should use QualifiedObjectNameFormatter.format(org.hibernate.boot.model.relational.QualifiedTableName, org.hibernate.dialect.Dialect) on QualifiedObjectNameFormatter obtained from JdbcEnvironment
org.hibernate.jpa.spi.AbstractEntityManagerImpl.getRawSession() Deprecated in favor of AbstractEntityManagerImpl.getRawSession()
org.hibernate.engine.spi.SessionFactoryImplementor.getSettings() since 5.0; use SessionFactory.getSessionFactoryOptions() instead
org.hibernate.boot.registry.StandardServiceRegistryBuilder.getSettings() Temporarily exposed since Configuration is still around and much code still uses Configuration. This allows code to configure the builder and access that to configure Configuration object.
org.hibernate.event.spi.AbstractPreDatabaseOperationEvent.getSource() Use AbstractEvent.getSession() instead
org.hibernate.engine.spi.SessionFactoryImplementor.getSQLExceptionConverter() since 5.0; use JdbcServices.getSqlExceptionHelper() -> SqlExceptionHelper.getSqlExceptionConverter() instead as obtained from SessionFactoryImplementor.getServiceRegistry()
org.hibernate.engine.spi.SessionFactoryImplementor.getSQLExceptionHelper() since 5.0; use JdbcServices.getSqlExceptionHelper() instead as obtained from SessionFactoryImplementor.getServiceRegistry()
org.hibernate.boot.archive.spi.ArchiveDescriptorFactory.getURLFromPath(String) Not used!
org.hibernate.engine.jdbc.WrappedNClob.getWrappedClob() Use WrappedNClob.getWrappedNClob() instead
org.hibernate.dialect.Dialect.hasDataTypeInIdentityColumn() Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().hasDataTypeInIdentityColumn() does not delegate to this method, then this method is ignored.
org.hibernate.jpa.event.spi.jpa.CallbackRegistry.hasPostCreateCallbacks(Class) Use CallbackRegistry.hasRegisteredCallbacks(Class, CallbackType) instead passing CallbackType.POST_PERSIST
org.hibernate.jpa.event.spi.jpa.CallbackRegistry.hasPostRemoveCallbacks(Class) Use CallbackRegistry.hasRegisteredCallbacks(Class, CallbackType) instead passing CallbackType.POST_REMOVE
org.hibernate.jpa.event.spi.jpa.CallbackRegistry.hasPostUpdateCallbacks(Class) Use CallbackRegistry.hasRegisteredCallbacks(Class, CallbackType) instead passing CallbackType.POST_UPDATE
org.hibernate.jpa.event.spi.jpa.CallbackRegistry.hasRegisteredCallbacks(Class, Class) Use CallbackRegistry.hasRegisteredCallbacks(Class, CallbackType) instead.
org.hibernate.tuple.entity.EntityTuplizer.instantiate(Serializable) Use EntityTuplizer.instantiate(Serializable, SessionImplementor) instead.
org.hibernate.jpa.event.spi.jpa.Callback.isActive() I can actually find no usages of this method and have no idea why it is here :)
org.hibernate.internal.util.collections.ArrayHelper.isEquals(byte[], byte[]) Use Arrays.equals(byte[], byte[]) instead
org.hibernate.internal.util.collections.ArrayHelper.isEquals(char[], char[]) Use Arrays.equals(char[], char[]) instead
org.hibernate.internal.util.collections.ArrayHelper.isEquals(Object[], Object[]) Use Arrays.equals(Object[], Object[]) instead
org.hibernate.FlushMode.isManualFlushMode(FlushMode) Just use equality check against FlushMode.MANUAL. Legacy from before this was an enum
org.hibernate.engine.jdbc.SerializableNClobProxy.isNClob(Clob) ORM baselines on JDK 1.6, so optional support for NClob (JDK 1,6 addition) is no longer needed.
org.hibernate.cfg.Environment.isolationLevelToString(int) Use ConnectionProviderInitiator.toIsolationNiceName(java.lang.Integer) instead
org.hibernate.loader.entity.UniqueEntityLoader.load(Serializable, Object, SessionImplementor) use UniqueEntityLoader.load(java.io.Serializable, Object, SessionImplementor, LockOptions) instead.
org.hibernate.type.TypeFactory.manyToOne(String, String, boolean, boolean, boolean, boolean) Use TypeFactory.manyToOne(String, boolean, String, boolean, boolean, boolean, boolean) instead.
org.hibernate.type.BinaryType.next(byte[], SessionImplementor) use RowVersionType for binary entity versions/timestamps
org.hibernate.envers.internal.tools.Tools.objectsEqual(Object, Object) (since 5.2), use EqualsHelper.areEqual(Object, Object).
org.hibernate.Interceptor.onPrepareStatement(String) Supply a StatementInspector instead, if you wish to inspect and alter SQL statements.
org.hibernate.mapping.Table.qualify(String, String, String) Should use QualifiedObjectNameFormatter.format(org.hibernate.boot.model.relational.QualifiedTableName, org.hibernate.dialect.Dialect) on QualifiedObjectNameFormatter obtained from JdbcEnvironment
org.hibernate.sql.Template.renderOrderByStringTemplate(String, Dialect, SQLFunctionRegistry) Use Template.translateOrderBy(java.lang.String, org.hibernate.sql.ordering.antlr.ColumnMapper, org.hibernate.engine.spi.SessionFactoryImplementor, org.hibernate.dialect.Dialect, org.hibernate.dialect.function.SQLFunctionRegistry) instead
org.hibernate.sql.Template.renderWhereStringTemplate(String, String, Dialect) Only intended for annotations usage; use Template.renderWhereStringTemplate(String, String, Dialect, SQLFunctionRegistry) instead
org.hibernate.tuple.entity.EntityTuplizer.resetIdentifier(Object, Serializable, Object) Use EntityTuplizer.resetIdentifier(Object, Serializable, Object, SessionImplementor) instead
org.hibernate.type.BinaryType.seed(SessionImplementor) use RowVersionType for binary entity versions/timestamps
org.hibernate.id.factory.IdentifierGeneratorFactory.setDialect(Dialect) The intention is that Dialect should be required to be specified up-front and it would then get ctor injected.
org.hibernate.tuple.entity.EntityTuplizer.setIdentifier(Object, Serializable) Use EntityTuplizer.setIdentifier(Object, Serializable, SessionImplementor) instead.
org.hibernate.sql.Select.setLockMode(LockMode) Instead use setLockOptions
org.hibernate.envers.query.internal.impl.AbstractAuditQuery.setLockMode(LockMode) Instead use setLockOptions
org.hibernate.tool.hbm2ddl.SchemaExportTask.setNamingStrategy(String) Use SchemaExportTask.setImplicitNamingStrategy(java.lang.String) or SchemaExportTask.setPhysicalNamingStrategy(java.lang.String) instead
org.hibernate.mapping.PersistentClass.setOptimisticLockMode(int) prefer PersistentClass.setOptimisticLockStyle(org.hibernate.engine.OptimisticLockStyle)
org.hibernate.mapping.Collection.setOwner(PersistentClass) Inject the owner into constructor.
org.hibernate.criterion.Expression.sql(String) use Restrictions.sqlRestriction(String)
org.hibernate.criterion.Expression.sql(String, Object[], Type[]) use Restrictions.sqlRestriction(String, Object[], Type[])
org.hibernate.criterion.Expression.sql(String, Object, Type) use Restrictions.sqlRestriction(String, Object, Type)
org.hibernate.id.PersistentIdentifierGenerator.sqlCreateStrings(Dialect) Utilize the ExportableProducer contract instead
org.hibernate.id.PersistentIdentifierGenerator.sqlDropStrings(Dialect) Utilize the ExportableProducer contract instead
org.hibernate.dialect.Dialect.supportsIdentityColumns() Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().supportsIdentityColumns() does not delegate to this method, then this method is ignored.
org.hibernate.dialect.Dialect.supportsInsertSelectIdentity() Dialect.getIdentityColumnSupport() should be overridden instead; if getIdentityColumnSupport().supportsInsertSelectIdentity() does not delegate to this method, then this method is ignored.
org.hibernate.dialect.Dialect.supportsLimit() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.dialect.Dialect.supportsLimitOffset() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.dialect.Dialect.supportsNotNullUnique() Dialect.getUniqueDelegate() should be overridden instead.
org.hibernate.dialect.Dialect.supportsUnique() Dialect.getUniqueDelegate() should be overridden instead.
org.hibernate.dialect.Dialect.supportsUniqueConstraintInCreateAlterTable() Dialect.getUniqueDelegate() should be overridden instead.
org.hibernate.dialect.Dialect.supportsVariableLimit() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.loader.plan.exec.process.spi.ResultSetProcessor.toOnDemandForm() Going away!
org.hibernate.usertype.EnhancedUserType.toXMLString(Object) To be removed in 5. Implement StringRepresentableType.toString(Object) instead. See HHH-7776 for details
org.hibernate.dialect.Dialect.useMaxForLimit() Dialect.getLimitHandler() should be overridden instead.
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.with(ClassLoader) Use BootstrapServiceRegistryBuilder.applyClassLoader(java.lang.ClassLoader) instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.with(ClassLoaderService) Use BootstrapServiceRegistryBuilder.applyClassLoaderService(org.hibernate.boot.registry.classloading.spi.ClassLoaderService) instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.with(Integrator) Use BootstrapServiceRegistryBuilder.applyIntegrator(org.hibernate.integrator.spi.Integrator) instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.withStrategySelector(Class<T>, String, Class<? extends T>) Use BootstrapServiceRegistryBuilder.applyStrategySelector(java.lang.Class<T>, java.lang.String, java.lang.Class<? extends T>) instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.withStrategySelectors(StrategyRegistrationProvider) Use BootstrapServiceRegistryBuilder.applyStrategySelectors(org.hibernate.boot.registry.selector.StrategyRegistrationProvider) instead

Deprecated Constructors

Constructor and Description
org.hibernate.engine.internal.AbstractEntityEntry(Status, Object[], Object, Serializable, Object, LockMode, boolean, EntityPersister, EntityMode, String, boolean, boolean, PersistenceContext) the tenantId and entityMode parameters where removed: this constructor accepts but ignores them. Use the other constructor!
org.hibernate.DuplicateMappingException(String, String) Use the for taking DuplicateMappingException.Type instead.
org.hibernate.DuplicateMappingException(String, String, String) Use the for taking DuplicateMappingException.Type instead.
org.hibernate.type.EntityType(TypeFactory.TypeScope, String, String, boolean, boolean) Use EntityType(org.hibernate.type.TypeFactory.TypeScope, String, boolean, String, boolean, boolean) instead.
org.hibernate.engine.internal.ImmutableEntityEntry(Status, Object[], Object, Serializable, Object, LockMode, boolean, EntityPersister, EntityMode, String, boolean, boolean, PersistenceContext) the tenantId and entityMode parameters where removed: this constructor accepts but ignores them. Use the other constructor!
org.hibernate.type.ManyToOneType(TypeFactory.TypeScope, String, String, boolean, boolean, boolean, boolean, boolean) Use ManyToOneType(TypeFactory.TypeScope, String, boolean, String, boolean, boolean, boolean, boolean ) instead.
org.hibernate.engine.internal.MutableEntityEntry(Status, Object[], Object, Serializable, Object, LockMode, boolean, EntityPersister, EntityMode, String, boolean, boolean, PersistenceContext) the tenantId and entityMode parameters where removed: this constructor accepts but ignores them. Use the other constructor!
org.hibernate.engine.spi.NamedQueryDefinition(String, String, boolean, String, Integer, Integer, FlushMode, CacheMode, boolean, String, Map) Use NamedQueryDefinitionBuilder instead.
org.hibernate.engine.spi.NamedQueryDefinition(String, String, boolean, String, Integer, Integer, Integer, FlushMode, CacheMode, boolean, String, Map) Use NamedQueryDefinitionBuilder instead.
org.hibernate.engine.spi.NamedSQLQueryDefinition(String, String, NativeSQLQueryReturn[], List<String>, boolean, String, Integer, Integer, FlushMode, CacheMode, boolean, String, Map, boolean) Use NamedSQLQueryDefinitionBuilder instead.
org.hibernate.engine.spi.NamedSQLQueryDefinition(String, String, String, List<String>, boolean, String, Integer, Integer, FlushMode, CacheMode, boolean, String, Map, boolean) Use NamedSQLQueryDefinitionBuilder instead.
org.hibernate.type.OneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, String, boolean, boolean, String, String) Use OneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, boolean, String, boolean, boolean, String, String) instead.
org.hibernate.tool.hbm2ddl.SchemaExport(Configuration) Use one of the forms accepting MetadataImplementor, rather than Configuration, instead.
org.hibernate.tool.hbm2ddl.SchemaExport(Configuration, Connection) Use one of the forms accepting MetadataImplementor, rather than Configuration, instead.
org.hibernate.tool.hbm2ddl.SchemaExport(ServiceRegistry, Configuration) Use one of the forms accepting MetadataImplementor, rather than Configuration, instead.
org.hibernate.type.SpecialOneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, String, boolean, boolean, String, String) Use SpecialOneToOneType(org.hibernate.type.TypeFactory.TypeScope, String, ForeignKeyDirection, boolean, String, boolean, boolean, String, String) instead.
org.hibernate.engine.spi.TypedValue(Type, Object, EntityMode) explicit entity mode support is deprecated

Deprecated Enum Constants

Enum Constant and Description
org.hibernate.LockMode.FORCE instead use PESSIMISTIC_FORCE_INCREMENT
org.hibernate.FlushMode.NEVER use FlushMode.MANUAL instead.
org.hibernate.LockMode.UPGRADE instead use PESSIMISTIC_WRITE

Deprecated Annotation Type Elements

Annotation Type Element and Description
org.hibernate.envers.Audited.auditParents Use @AuditOverride(forClass=SomeEntity.class) instead.