Deprecated List (Hibernate Parent 4.3.11.Final API)

Deprecated Interfaces
Interface and Description
org.hibernate.type.AbstractComponentType in favor of `CompositeType`
org.hibernate.ejb.AvailableSettings Use `AvailableSettings` instead
org.hibernate.service.BootstrapServiceRegistry Use `BootstrapServiceRegistry` instead
org.hibernate.cfg.ExtendedMappings All functionality has been moved up to `Mappings`
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.naming.LegacyNamingStrategyDelegate
org.hibernate.cfg.NamingStrategy A `NamingStrategyDelegator` should be used instead.
org.hibernate.hql.internal.ast.tree.ParameterContainer See entire discussion above
org.hibernate.tuple.Property
org.hibernate.cache.RegionFactory Moved, but still need this definition for ehcache
org.hibernate.ejb.packaging.Scanner Use `Scanner` instead
org.hibernate.type.XmlRepresentableType To be removed in 5. Use `StringRepresentableType` instead. See Jira issues HHH-7777 and HHH-7776 for details.

Deprecated Classes
Class and Description
org.hibernate.type.AbstractBynaryType Use the `AbstractStandardBasicType` approach instead
org.hibernate.type.AbstractCharArrayType Use the `AbstractStandardBasicType` approach instead
org.hibernate.ejb.AbstractEntityManagerImpl Use `AbstractEntityManagerImpl` instead
org.hibernate.type.AbstractLobType
org.hibernate.type.AbstractLongBinaryType Use the `AbstractStandardBasicType` approach instead
org.hibernate.type.AbstractLongStringType Use the `AbstractStandardBasicType` approach instead
org.hibernate.ejb.AbstractQueryImpl Use `AbstractQueryImpl` instead
org.hibernate.cfg.AnnotationConfiguration All functionality has been moved to `Configuration`
org.hibernate.cfg.AnnotationConfiguration.ExtendedMappingsImpl
org.hibernate.ejb.BaseQueryImpl Use `BaseQueryImpl` instead
org.hibernate.service.BootstrapServiceRegistryBuilder Use `BootstrapServiceRegistryBuilder` instead
org.hibernate.type.ByteArrayBlobType replaced by `WrappedMaterializedBlobType`
org.hibernate.type.CharBooleanType Use the `AbstractStandardBasicType` approach instead
org.hibernate.dialect.function.ClassicAvgFunction Use `StandardAnsiSqlAggregationFunctions.AvgFunction` or `AvgWithArgumentCastFunction` instead.
org.hibernate.dialect.function.ClassicCountFunction Use `StandardAnsiSqlAggregationFunctions.CountFunction` instead.
org.hibernate.dialect.function.ClassicSumFunction Use `StandardAnsiSqlAggregationFunctions.SumFunction` instead.
org.hibernate.dialect.DerbyDialect HHH-6073
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.type.ImmutableType Use the `AbstractStandardBasicType` approach instead
org.hibernate.internal.util.jndi.JndiHelper As JNDI access should get routed through `JndiService`
org.hibernate.cfg.naming.LegacyHbmNamingStrategyDelegate
org.hibernate.cfg.naming.LegacyJpaNamingStrategyDelegate
org.hibernate.cfg.naming.LegacyNamingStrategyDelegateAdapter
org.hibernate.cfg.naming.LegacyNamingStrategyDelegator Needed as a transitory implementation until the deprecated NamingStrategy contract can be removed.
org.hibernate.type.MutableType Use the `AbstractStandardBasicType` approach instead
org.hibernate.ejb.packaging.NamedInputStream Doubly deprecated actually :) Moved to `NamedInputStream` due to package renaming (org.hibernate.ejb -> org.hibernate.jpa). But also, the role fulfilled by this class was moved to the new `InputStreamAccess` contract.
org.hibernate.jpa.boot.spi.NamedInputStream Use `InputStreamAccess` instead.
org.hibernate.type.NullableType Use the `AbstractStandardBasicType` approach instead
org.hibernate.dialect.Oracle9Dialect Use either Oracle9iDialect or Oracle10gDialect instead
org.hibernate.dialect.OracleDialect Use Oracle8iDialect instead.
org.hibernate.envers.query.internal.property.OriginalIdPropertyName To be removed together with `AuditId.count(String)` in version 5.0.
org.hibernate.collection.internal.PersistentElementHolder To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issues HHH-7782 and HHH-7783 for more information.
org.hibernate.collection.internal.PersistentIndexedElementHolder To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issues HHH-7782 and HHH-7783 for more information.
org.hibernate.collection.internal.PersistentListElementHolder To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issues HHH-7782 and HHH-7783 for more information.
org.hibernate.collection.internal.PersistentMapElementHolder To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issues HHH-7782 and HHH-7783 for more information.
org.hibernate.dialect.PostgreSQLDialect use `PostgreSQL82Dialect` instead
org.hibernate.type.PrimitiveByteArrayBlobType replaced by `MaterializedBlobType`
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.service.ServiceRegistryBuilder Use `StandardServiceRegistryBuilder` instead
org.hibernate.exception.internal.SQLStateConverter Use `StandardSQLExceptionConverter` with `SQLStateConversionDelegate` instead
org.hibernate.tuple.StandardProperty
org.hibernate.type.StringClobType replaced by `MaterializedClobType`
org.hibernate.id.TableGenerator use `SequenceStyleGenerator` instead.
org.hibernate.id.TableHiLoGenerator use `SequenceStyleGenerator` instead.
org.hibernate.envers.strategy.ValidTimeAuditStrategy use `ValidityAuditStrategy` instead.

Deprecated Enums
Enum and Description

org.hibernate.annotations.SortType
Since Sort is deprecated.

Deprecated Enums
Enum and Description
org.hibernate.annotations.SortType Since `Sort` is deprecated.

Deprecated Exceptions
Exceptions and Description
org.hibernate.OptimisticLockException Use `OptimisticEntityLockException` instead
org.hibernate.cfg.RecoverableException Was only ever referenced in a single place, in an extremely dubious way.

Deprecated Annotation Types
Annotation Type and Description
org.hibernate.annotations.AccessType Use `AttributeAccessor` instead; renamed to avoid confusion with the JPA `AccessType` enum.
org.hibernate.annotations.Entity See individual attributes for intended replacements. To be removed in 4.1
org.hibernate.annotations.ForeignKey Prefer the JPA 2.1 introduced `ForeignKey` instead.
org.hibernate.annotations.Index Using `Index` instead.
org.hibernate.annotations.IndexColumn Prefer the standard JPA `OrderColumn` annotation and the Hibernate specific `ListIndexBase` (for replacing `IndexColumn.base()`).
org.hibernate.annotations.Sort Use `SortComparator` or `SortNatural` instead depending on need.

Deprecated Fields
Field and Description
org.hibernate.cfg.AvailableSettings.APP_CLASSLOADER Use `AvailableSettings.CLASSLOADERS` 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.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.criterion.CriteriaSpecification.FULL_JOIN use `JoinType.FULL_JOIN`
org.hibernate.sql.JoinFragment.FULL_JOIN use `JoinType.FULL_JOIN` instead.
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.criterion.CriteriaSpecification.INNER_JOIN use `JoinType.INNER_JOIN`
org.hibernate.sql.JoinFragment.INNER_JOIN use `JoinType.INNER_JOIN` instead.
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.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.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.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.

Deprecated Methods
Method and Description
org.hibernate.cfg.Mappings.addUniqueConstraints(Table, List) Use `Mappings.addUniqueConstraintHolders(org.hibernate.mapping.Table, java.util.List<org.hibernate.cfg.UniqueConstraintHolder>)` instead
org.hibernate.dialect.Dialect.appendLockHint(LockMode, String) use `appendLockHint(LockOptions,String)` instead
org.hibernate.type.TypeFactory.array(String, String, boolean, Class) Use `TypeFactory.array(String, String, Class)` instead. See Jira issue: HHH-7771
org.hibernate.jpa.boot.spi.InputStreamAccess.asNamedInputStream() Needed until we can remove NamedInputStream
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.type.TypeFactory.bag(String, String, boolean) Use `TypeFactory.bag(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.dialect.Dialect.bindLimitParametersFirst() `Dialect.buildLimitHandler(String, RowSelection)` should be overridden instead.
org.hibernate.dialect.Dialect.bindLimitParametersInReverseOrder() `Dialect.buildLimitHandler(String, RowSelection)` should be overridden instead.
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.cfg.Configuration.buildSessionFactory() Use `Configuration.buildSessionFactory(ServiceRegistry)` instead
org.hibernate.dialect.Dialect.buildSQLExceptionConverter() `Dialect.buildSQLExceptionConversionDelegate()` should be overridden instead.
org.hibernate.tuple.PropertyFactory.buildStandardProperty(Property, boolean)
org.hibernate.cfg.annotations.TableBinder.buildUniqueConstraints(UniqueConstraint[]) Use `TableBinder.buildUniqueConstraintHolders(javax.persistence.UniqueConstraint[])` instead
org.hibernate.engine.config.spi.ConfigurationService.cast(Class<T>, Object) No idea why this is exposed here...
org.hibernate.c3p0.internal.C3P0ConnectionProvider.close() Use `C3P0ConnectionProvider.stop()` instead
org.hibernate.proxool.internal.ProxoolConnectionProvider.close() Use `ProxoolConnectionProvider.stop()` instead
org.hibernate.StatelessSession.connection() just missed when deprecating same method from `Session`
org.hibernate.dialect.Dialect.convertToFirstRowValue(int) `Dialect.buildLimitHandler(String, RowSelection)` should be overridden instead.
org.hibernate.envers.query.criteria.AuditId.count(String) Use `AuditProperty.count()`.
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.customCollection(String, Properties, String, String, boolean) Use `TypeFactory.customCollection(String, java.util.Properties, String, String)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.customComponent(Class<CompositeUserType>, Properties, TypeFactory.TypeScope) Only for use temporary use by `Hibernate`
org.hibernate.cfg.ObjectNameNormalizer.NamingStrategyHelper.determineImplicitName(NamingStrategy)
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.SessionFactory.evict(Class) Use `Cache.evictEntityRegion(Class)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evict(Class, Serializable) Use `Cache.containsEntity(Class, Serializable)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evictCollection(String) Use `Cache.evictCollectionRegion(String)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evictCollection(String, Serializable) Use `Cache.evictCollection(String,Serializable)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evictEntity(String) Use `Cache.evictEntityRegion(String)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evictEntity(String, Serializable) Use `Cache.evictEntity(String,Serializable)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evictQueries() Use `Cache.evictQueryRegions()` accessed through `SessionFactory.getCache()` instead.
org.hibernate.SessionFactory.evictQueries(String) Use `Cache.evictQueryRegion(String)` accessed through `SessionFactory.getCache()` instead.
org.hibernate.cfg.annotations.TableBinder.fillTable(String, String, String, String, boolean, List, String, Table, Mappings) Use `TableBinder.buildAndFillTable(java.lang.String, java.lang.String, org.hibernate.cfg.ObjectNameSource, org.hibernate.cfg.ObjectNameNormalizer.NamingStrategyHelper, boolean, java.util.List<org.hibernate.cfg.UniqueConstraintHolder>, java.util.List<org.hibernate.cfg.JPAIndexHolder>, java.lang.String, org.hibernate.mapping.Table, org.hibernate.cfg.Mappings, java.lang.String)` instead.
org.hibernate.dialect.Dialect.forceLimitUsage() `Dialect.buildLimitHandler(String, RowSelection)` should be overridden instead.
org.hibernate.boot.registry.classloading.internal.ClassLoaderServiceImpl.fromConfigSettings(Map) No longer used/supported!
org.hibernate.type.Type.fromXMLNode(Node, Mapping) To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.usertype.EnhancedUserType.fromXMLString(String) To be removed in 5. Implement `StringRepresentableType.fromStringValue(String)` instead. See HHH-7776 for details
org.hibernate.cfg.Configuration.generateSchemaUpdateScript(Dialect, DatabaseMetadata) Use `Configuration.generateSchemaUpdateScriptList(Dialect, DatabaseMetadata)` instead
org.hibernate.Session.get(Class, Serializable, LockMode) LockMode parameter should be replaced with LockOptions
org.hibernate.Session.get(String, Serializable, LockMode) LockMode parameter should be replaced with LockOptions
org.hibernate.dialect.Dialect.getAddUniqueConstraintString(String) `Dialect.getUniqueDelegate()` should be overridden instead.
org.hibernate.engine.spi.SessionFactoryImplementor.getConnectionProvider() Access to connections via `JdbcConnectionAccess` should be preferred over access via `ConnectionProvider`, whenever possible. `JdbcConnectionAccess` is tied to the Hibernate Session to properly account for contextual information. See `SessionImplementor.getJdbcConnectionAccess()`
org.hibernate.engine.jdbc.spi.JdbcServices.getConnectionProvider() See deprecation notice on `SessionFactoryImplementor.getConnectionProvider()` for details
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.SessionImplementor.getEnabledFilters() use #getLoadQueryInfluencers instead
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.type.CharBooleanType.getFalseString() Pass the true/false values into constructor instead.
org.hibernate.metamodel.binding.AssociationAttributeBinding.getFetchMode()
org.hibernate.engine.spi.SessionImplementor.getFetchProfile() use #getLoadQueryInfluencers instead
org.hibernate.engine.spi.SessionImplementor.getFilterParameterType(String) use #getLoadQueryInfluencers instead
org.hibernate.engine.spi.SessionImplementor.getFilterParameterValue(String) use #getLoadQueryInfluencers instead
org.hibernate.tuple.entity.EntityTuplizer.getIdentifier(Object) Use `EntityTuplizer.getIdentifier(Object,SessionImplementor)` instead.
org.hibernate.persister.entity.EntityPersister.getIdentifier(Object) Use `EntityPersister.getIdentifier(Object,SessionImplementor)` instead
org.hibernate.metadata.ClassMetadata.getIdentifier(Object) Use `ClassMetadata.getIdentifier(Object,SessionImplementor)` instead
org.hibernate.engine.spi.Mapping.getIdentifierGeneratorFactory() temporary solution
org.hibernate.dialect.Dialect.getLimitString(String, boolean) `Dialect.buildLimitHandler(String, RowSelection)` should be overridden instead.
org.hibernate.dialect.Dialect.getLimitString(String, int, int) `Dialect.buildLimitHandler(String, RowSelection)` 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.cfg.ObjectNameNormalizer.getNamingStrategy() Replaced by `ObjectNameNormalizer.getNamingStrategyDelegator()`
org.hibernate.cfg.Mappings.getNamingStrategy() Use `Mappings.getNamingStrategyDelegator()` instead.
org.hibernate.tuple.Property.getNode()
org.hibernate.tuple.AbstractAttribute.getNode()
org.hibernate.mapping.PersistentClass.getOptimisticLockMode()
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()
org.hibernate.persister.entity.EntityPersister.getPropertyInsertGenerationInclusions() Replaced internally with InMemoryValueGenerationStrategy / InDatabaseValueGenerationStrategy
org.hibernate.persister.entity.AbstractEntityPersister.getPropertyUpdateGenerationInclusions()
org.hibernate.persister.entity.EntityPersister.getPropertyUpdateGenerationInclusions() Replaced internally with InMemoryValueGenerationStrategy / InDatabaseValueGenerationStrategy
org.hibernate.jpa.spi.AbstractEntityManagerImpl.getRawSession() Deprecated in favor of `AbstractEntityManagerImpl.getRawSession()`
org.hibernate.cfg.Ejb3Column.getSecondaryTableName() Use `Ejb3Column.getExplicitTableName()` 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 (used from HEM atm).
org.hibernate.event.spi.AbstractPreDatabaseOperationEvent.getSource() Use `AbstractEvent.getSession()` instead
org.hibernate.cfg.Mappings.getTableUniqueConstraints() Use `Mappings.getUniqueConstraintHoldersByTable()` instead
org.hibernate.type.CharBooleanType.getTrueString() Pass the true/false values into constructor instead.
org.hibernate.jpa.boot.archive.spi.ArchiveDescriptorFactory.getURLFromPath(String) Not used!
org.hibernate.engine.jdbc.WrappedNClob.getWrappedClob() Use `WrappedNClob.getWrappedNClob()` instead
org.hibernate.cfg.ObjectNameNormalizer.NamingStrategyHelper.handleExplicitName(NamingStrategy, String) Replaced by `ObjectNameNormalizer.NamingStrategyHelper.determineImplicitName(org.hibernate.cfg.naming.NamingStrategyDelegator)`.
org.hibernate.type.TypeFactory.idbag(String, String, boolean) Use `TypeFactory.idbag(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.tuple.entity.EntityTuplizer.instantiate(Serializable) Use `EntityTuplizer.instantiate(Serializable, SessionImplementor)` instead.
org.hibernate.mapping.ToOne.isEmbedded() To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.mapping.Collection.isEmbedded() To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.mapping.OneToMany.isEmbedded() To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.type.AssociationType.isEmbeddedInXML() To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
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.type.EntityType.isNotEmbedded(SessionImplementor) To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.type.Type.isXMLElement() To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.cfg.Mappings.iterateAuxliaryDatabaseObjects() To fix misspelling; use `Mappings.iterateAuxiliaryDatabaseObjects()` instead
org.hibernate.cfg.Mappings.iterateAuxliaryDatabaseObjectsInReverse() To fix misspelling; use `Mappings.iterateAuxiliaryDatabaseObjectsInReverse()` instead
org.hibernate.type.TypeFactory.list(String, String, boolean) Use `TypeFactory.list(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.Session.load(Class, Serializable, LockMode) LockMode parameter should be replaced with LockOptions
org.hibernate.loader.entity.UniqueEntityLoader.load(Serializable, Object, SessionImplementor) use `UniqueEntityLoader.load(java.io.Serializable, Object, SessionImplementor, LockOptions)` instead.
org.hibernate.loader.entity.BatchingEntityLoader.load(Serializable, Object, SessionImplementor)
org.hibernate.loader.entity.plan.AbstractLoadPlanBasedEntityLoader.load(Serializable, Object, SessionImplementor)
org.hibernate.loader.entity.plan.BatchingEntityLoader.load(Serializable, Object, SessionImplementor)
org.hibernate.Session.load(String, Serializable, LockMode) LockMode parameter should be replaced with LockOptions
org.hibernate.Session.lock(Object, LockMode) instead call buildLockRequest(LockMode).lock(object)
org.hibernate.Session.lock(String, Object, LockMode) instead call buildLockRequest(LockMode).lock(entityName, object)
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.TypeFactory.manyToOne(String, String, boolean, boolean, boolean, boolean, boolean) Use `TypeFactory.manyToOne(String, boolean, String, boolean, boolean, boolean, boolean)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.map(String, String, boolean) Use `TypeFactory.map(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.oneToOne(String, ForeignKeyDirection, String, boolean, boolean, boolean, String, String) Use `#oneToOne(String, ForeignKeyDirection, String, boolean, boolean, String, String, boolean)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.oneToOne(String, ForeignKeyDirection, String, boolean, boolean, String, String) Use `#oneToOne(String, ForeignKeyDirection, String, boolean, boolean, String, String, boolean)` instead.
org.hibernate.type.TypeFactory.orderedMap(String, String, boolean) Use `TypeFactory.orderedMap(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.orderedSet(String, String, boolean) Use `TypeFactory.orderedSet(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.Session.refresh(Object, LockMode) LockMode parameter should be replaced with LockOptions
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.TypeFactory.set(String, String, boolean) Use `TypeFactory.set(String, String)` instead. See Jira issue: HHH-7771
org.hibernate.tuple.ElementWrapper.setAttributeValue(QName, String)
org.hibernate.tuple.ElementWrapper.setAttributeValue(String, String)
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.mapping.ToOne.setEmbedded(boolean) To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.mapping.Collection.setEmbedded(boolean) To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.mapping.OneToMany.setEmbedded(boolean) To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.engine.spi.SessionImplementor.setFetchProfile(String) use `SessionImplementor.getLoadQueryInfluencers()` instead
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.cfg.Mappings.setNamingStrategy(NamingStrategy) Use `Mappings.setNamingStrategyDelegator(org.hibernate.cfg.naming.NamingStrategyDelegator)` instead.
org.hibernate.mapping.PersistentClass.setOptimisticLockMode(int)
org.hibernate.mapping.Collection.setOwner(PersistentClass) Inject the owner into constructor.
org.hibernate.cfg.Ejb3Column.setSecondaryTableName(String) Use `Ejb3Column.setExplicitTableName(java.lang.String)` instead
org.hibernate.type.Type.setToXMLNode(Node, Object, SessionFactoryImplementor) To be removed in 5. Removed as part of removing the notion of DOM entity-mode. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.sortedMap(String, String, boolean, Comparator) Use `TypeFactory.sortedMap(String, String, java.util.Comparator)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.sortedSet(String, String, boolean, Comparator) Use `TypeFactory.sortedSet(String, String, java.util.Comparator)` instead. See Jira issue: HHH-7771
org.hibernate.type.TypeFactory.specialOneToOne(String, ForeignKeyDirection, String, boolean, boolean, String, String) Use `#specialOneToOne(String, ForeignKeyDirection, String, boolean, boolean, String, String, boolean)` instead.
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.dialect.Dialect.supportsLimit() `Dialect.buildLimitHandler(String, RowSelection)` should be overridden instead.
org.hibernate.dialect.Dialect.supportsLimitOffset() `Dialect.buildLimitHandler(String, RowSelection)` 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.buildLimitHandler(String, RowSelection)` 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.buildLimitHandler(String, RowSelection)` should be overridden instead.
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.withApplicationClassLoader(ClassLoader) Use `BootstrapServiceRegistryBuilder.with(ClassLoader)` instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.withEnvironmentClassLoader(ClassLoader) Use `BootstrapServiceRegistryBuilder.with(ClassLoader)` instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.withHibernateClassLoader(ClassLoader) Use `BootstrapServiceRegistryBuilder.with(ClassLoader)` instead
org.hibernate.boot.registry.BootstrapServiceRegistryBuilder.withResourceClassLoader(ClassLoader) Use `BootstrapServiceRegistryBuilder.with(ClassLoader)` instead

Deprecated Constructors
Constructor and Description
org.hibernate.type.ArrayType(TypeFactory.TypeScope, String, String, Class, boolean) Use `ArrayType.ArrayType(TypeFactory.TypeScope, String, String, Class )` instead. See Jira issue: HHH-7771
org.hibernate.type.BagType(TypeFactory.TypeScope, String, String, boolean) Use `BagType.BagType(TypeFactory.TypeScope, String, String )` See Jira issue: HHH-7771
org.hibernate.type.CollectionType(TypeFactory.TypeScope, String, String, boolean) Use `CollectionType.CollectionType(TypeFactory.TypeScope, String, String)` instead See Jira issue: HHH-7771
org.hibernate.type.CustomCollectionType(TypeFactory.TypeScope, Class, String, String, boolean) Use `CustomCollectionType.CustomCollectionType(TypeFactory.TypeScope, Class, String, String )` instead. See Jira issue: HHH-7771
org.hibernate.tool.hbm2ddl.DatabaseMetadata(Connection, Dialect) Use `DatabaseMetadata.DatabaseMetadata(Connection, Dialect, Configuration)` instead
org.hibernate.tool.hbm2ddl.DatabaseMetadata(Connection, Dialect, boolean) Use `DatabaseMetadata.DatabaseMetadata(Connection, Dialect, Configuration, boolean)` instead
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.engine.spi.EntityEntry(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.EntityType(TypeFactory.TypeScope, String, String, boolean, boolean) Use `EntityType.EntityType(org.hibernate.type.TypeFactory.TypeScope, String, boolean, String, boolean, boolean)` instead.
org.hibernate.type.EntityType(TypeFactory.TypeScope, String, String, boolean, boolean, boolean) Use `EntityType.EntityType(org.hibernate.type.TypeFactory.TypeScope, String, boolean, String, boolean, boolean)` instead. See Jira issue: HHH-7771
org.hibernate.type.IdentifierBagType(TypeFactory.TypeScope, String, String, boolean) Use `IdentifierBagType.IdentifierBagType(org.hibernate.type.TypeFactory.TypeScope, String, String)` See Jira issue: HHH-7771
org.hibernate.type.ListType(TypeFactory.TypeScope, String, String, boolean) Use `ListType.ListType(org.hibernate.type.TypeFactory.TypeScope, String, String)` See Jira issue: HHH-7771
org.hibernate.type.ManyToOneType(TypeFactory.TypeScope, String, String, boolean, boolean, boolean, boolean) Use `ManyToOneType.ManyToOneType(TypeFactory.TypeScope, String, boolean, String, boolean, boolean, boolean, boolean )` instead. See Jira issue: HHH-7771
org.hibernate.type.ManyToOneType(TypeFactory.TypeScope, String, String, boolean, boolean, boolean, boolean, boolean) Use `ManyToOneType.ManyToOneType(TypeFactory.TypeScope, String, boolean, String, boolean, boolean, boolean, boolean )` instead.
org.hibernate.type.MapType(TypeFactory.TypeScope, String, String, boolean) Use `MapType.MapType(TypeFactory.TypeScope, String, String )` instead. See Jira issue: HHH-7771
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, boolean, String, String) Use `OneToOneType.OneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, boolean, String, boolean, boolean, String, String)` instead. See Jira issue: HHH-7771
org.hibernate.type.OneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, String, boolean, boolean, String, String) Use `OneToOneType.OneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, boolean, String, boolean, boolean, String, String)` instead.
org.hibernate.type.OrderedMapType(TypeFactory.TypeScope, String, String, boolean) Use `OrderedMapType.OrderedMapType(TypeFactory.TypeScope, String, String)` instead. instead. See Jira issue: HHH-7771
org.hibernate.type.OrderedSetType(TypeFactory.TypeScope, String, String, boolean) Use `OrderedSetType.OrderedSetType(org.hibernate.type.TypeFactory.TypeScope, String, String)` instead. See Jira issue: HHH-7771
org.hibernate.tool.hbm2ddl.SchemaExport(Configuration, Properties) properties may be specified via the Configuration object
org.hibernate.type.SetType(TypeFactory.TypeScope, String, String, boolean) Use `SetType.SetType(org.hibernate.type.TypeFactory.TypeScope, String, String)` instead. See Jira issue: HHH-7771
org.hibernate.type.SortedMapType(TypeFactory.TypeScope, String, String, Comparator, boolean) Use `SortedMapType.SortedMapType(org.hibernate.type.TypeFactory.TypeScope, String, String, java.util.Comparator)` instead. See Jira issue: HHH-7771
org.hibernate.type.SortedSetType(TypeFactory.TypeScope, String, String, Comparator, boolean) Use `SortedSetType.SortedSetType(org.hibernate.type.TypeFactory.TypeScope, String, String, java.util.Comparator)` instead. See Jira issue: HHH-7771
org.hibernate.type.SpecialOneToOneType(TypeFactory.TypeScope, String, ForeignKeyDirection, String, boolean, boolean, String, String) Use `SpecialOneToOneType.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.annotations.CascadeType.DELETE_ORPHAN use @OneToOne(orphanRemoval=true) or @OneToMany(orphanRemoval=true)
org.hibernate.annotations.CascadeType.EVICT use javax.persistence.CascadeType.DETACH
org.hibernate.LockMode.FORCE instead use PESSIMISTIC_FORCE_INCREMENT
org.hibernate.FlushMode.NEVER use `FlushMode.MANUAL` instead.
org.hibernate.annotations.FlushModeType.NEVER use MANUAL, will be removed in a subsequent release
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.
org.hibernate.annotations.Entity.dynamicInsert use `DynamicInsert` instead
org.hibernate.annotations.Entity.dynamicUpdate Use `DynamicUpdate` instead
org.hibernate.annotations.Tuplizer.entityMode should use #entityModeType instead
org.hibernate.annotations.Entity.mutable use `Immutable`
org.hibernate.annotations.Entity.optimisticLock use `OptimisticLocking` instead.
org.hibernate.annotations.Entity.persister use `Persister` instead
org.hibernate.annotations.Entity.polymorphism use `Polymorphism` instead
org.hibernate.annotations.Entity.selectBeforeUpdate Use `SelectBeforeUpdate` instead

Deprecated API

Contents