Deprecated API

Contents

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

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.jpa.boot.spi.NamedInputStream Use InputStreamAccess 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.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 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.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.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, 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, 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, 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, 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.Mappings.getNamingStrategy() Use Mappings.getNamingStrategyDelegator() instead.
org.hibernate.cfg.ObjectNameNormalizer.getNamingStrategy() Replaced by ObjectNameNormalizer.getNamingStrategyDelegator()
org.hibernate.tuple.AbstractAttribute.getNode()
org.hibernate.tuple.Property.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.EntityPersister.getPropertyInsertGenerationInclusions() Replaced internally with InMemoryValueGenerationStrategy / InDatabaseValueGenerationStrategy
org.hibernate.persister.entity.AbstractEntityPersister.getPropertyInsertGenerationInclusions()
org.hibernate.persister.entity.EntityPersister.getPropertyUpdateGenerationInclusions() Replaced internally with InMemoryValueGenerationStrategy / InDatabaseValueGenerationStrategy
org.hibernate.persister.entity.AbstractEntityPersister.getPropertyUpdateGenerationInclusions()
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.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.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.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.BatchingEntityLoader.load(Serializable, Object, SessionImplementor)
org.hibernate.loader.entity.UniqueEntityLoader.load(Serializable, Object, SessionImplementor) use UniqueEntityLoader.load(java.io.Serializable, Object, SessionImplementor, LockOptions) instead.
org.hibernate.loader.entity.plan.BatchingEntityLoader.load(Serializable, Object, SessionImplementor)
org.hibernate.loader.entity.plan.AbstractLoadPlanBasedEntityLoader.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.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.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.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, boolean, String, Integer, Integer, FlushMode, CacheMode, boolean, String, Map, boolean) Use NamedSQLQueryDefinitionBuilder instead.
org.hibernate.engine.spi.NamedSQLQueryDefinition(String, String, String, List, 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