Deprecated API

Contents

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

Deprecated Interfaces

org.hibernate.type.AbstractComponentType
in favor of CompositeType

org.hibernate.cfg.ExtendedMappings
All functionality has been moved up to Mappings

org.hibernate.jmx.HibernateServiceMBean
See HHH-6190 for details

org.hibernate.hql.internal.ast.tree.ParameterContainer

org.hibernate.cache.RegionFactory
Moved, but still need this definition for ehcache

org.hibernate.jmx.StatisticsServiceMBean
See HHH-6190 for details

Deprecated Classes

org.hibernate.type.AbstractBynaryType
Use the AbstractStandardBasicType approach instead

org.hibernate.type.AbstractCharArrayType
Use the AbstractStandardBasicType approach 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.cfg.AnnotationConfiguration
All functionality has been moved to Configuration

org.hibernate.cfg.AnnotationConfiguration.ExtendedMappingsImpl

org.hibernate.type.ByteArrayBlobType
replaced by WrappedMaterializedBlobType

org.hibernate.type.CharBooleanType
Use the AbstractStandardBasicType approach instead

org.hibernate.dialect.DerbyDialect
HHH-6073

org.hibernate.ejb.Ejb3Configuration
Direct usage of this class has never been supported. Instead, the application should obtain reference to the EntityManagerFactory as outlined in the JPA specification, section 7.3 Obtaining an Entity Manager Factory based on runtime environment. Additionally this class will be removed in Hibernate release 5.0 for the same reasoning outlined on Configuration due to move towards new SessionFactory building methodology. See HHH-6181 and HHH-6159 for details

org.hibernate.criterion.Expression
Use Restrictions.

org.hibernate.jmx.HibernateService
See HHH-6190 for details

org.hibernate.criterion.IlikeExpression

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.type.MutableType
Use the AbstractStandardBasicType approach 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.dialect.PostgreSQLDialect
use PostgreSQL82Dialect instead

org.hibernate.type.PrimitiveByteArrayBlobType
replaced by MaterializedBlobType

org.hibernate.lob.ReaderInputStream
Should not be used anymore.

org.hibernate.jmx.SessionFactoryStub
See HHH-6190 for details

org.hibernate.exception.internal.SQLStateConverter
Use StandardSQLExceptionConverter with SQLStateConversionDelegate instead

org.hibernate.jmx.StatisticsService
See HHH-6190 for details

org.hibernate.type.StringClobType
replaced by MaterializedClobType

org.hibernate.dialect.SybaseDialect
use AbstractTransactSQLDialect, SybaseASE15Dialect or SQLServerDialect instead depending on need.

org.hibernate.envers.strategy.ValidTimeAuditStrategy
use ValidityAuditStrategy instead.

Deprecated Exceptions

org.hibernate.OptimisticLockException
Use OptimisticEntityLockException instead

Deprecated Annotation Types

org.hibernate.annotations.Entity
See individual attributes for intended replacements. To be removed in 4.1

Deprecated Fields

org.hibernate.FetchMode.EAGER
use FetchMode.JOIN

org.hibernate.internal.util.collections.CollectionHelper.EMPTY_COLLECTION

org.hibernate.internal.util.collections.CollectionHelper.EMPTY_LIST

org.hibernate.internal.util.collections.CollectionHelper.EMPTY_MAP

org.hibernate.sql.JoinFragment.FULL_JOIN
use JoinType.FULL_JOIN instead.

org.hibernate.criterion.CriteriaSpecification.FULL_JOIN
use JoinType.FULL_JOIN

org.hibernate.id.enhanced.OptimizerFactory.HILO
Use OptimizerFactory.StandardOptimizerDescriptor.getExternalName() via OptimizerFactory.StandardOptimizerDescriptor.HILO

org.hibernate.ejb.QueryHints.HINT_TIMEOUT
HINT_TIMEOUT (org.hibernate.timeout), instead use SPEC_HINT_TIMEOUT (javax.persistence.query.timeout)

org.hibernate.ejb.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.ejb.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 OptimizerFactory.StandardOptimizerDescriptor.getExternalName() via OptimizerFactory.StandardOptimizerDescriptor.LEGACY_HILO

org.hibernate.id.enhanced.OptimizerFactory.NONE
Use OptimizerFactory.StandardOptimizerDescriptor.getExternalName() via OptimizerFactory.StandardOptimizerDescriptor.NONE

org.hibernate.id.enhanced.OptimizerFactory.POOL
Use OptimizerFactory.StandardOptimizerDescriptor.getExternalName() via OptimizerFactory.StandardOptimizerDescriptor.POOLED

org.hibernate.id.enhanced.OptimizerFactory.POOL_LO
Use OptimizerFactory.StandardOptimizerDescriptor.getExternalName() via OptimizerFactory.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.sql.JoinFragment.RIGHT_OUTER_JOIN
use JoinType.RIGHT_OUTER_JOIN instead.

org.hibernate.cfg.AvailableSettings.TRANSACTION_MANAGER_STRATEGY
See AvailableSettings.JTA_PLATFORM

org.hibernate.cfg.AvailableSettings.USER_TRANSACTION
See AvailableSettings.JTA_PLATFORM

Deprecated Methods

org.hibernate.cfg.Mappings.addUniqueConstraints(Table, List)
Use Mappings.addUniqueConstraintHolders(org.hibernate.mapping.Table, java.util.List) instead

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.ejb.metamodel.MetamodelImpl.buildMetamodel(Iterator, SessionFactoryImplementor)
use MetamodelImpl.buildMetamodel(java.util.Iterator,org.hibernate.engine.spi.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.cfg.annotations.TableBinder.buildUniqueConstraints(UniqueConstraint[])
Use TableBinder.buildUniqueConstraintHolders(javax.persistence.UniqueConstraint[]) instead

org.hibernate.StatelessSession.connection()
just missed when deprecating same method from Session

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.ejb.Ejb3Configuration.createEntityManagerFactory()

org.hibernate.ejb.Ejb3Configuration.createEntityManagerFactory(Map)
use the Java Persistence API

org.hibernate.ejb.HibernatePersistence.createEntityManagerFactory(Map)

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.customComponent(Class, Properties, TypeFactory.TypeScope)
Only for use temporary use by Hibernate

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, java.lang.String, org.hibernate.mapping.Table, org.hibernate.cfg.Mappings, java.lang.String) 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.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.engine.spi.SessionImplementor.getEnabledFilters()
use #getLoadQueryInfluencers instead

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.metadata.ClassMetadata.getIdentifier(Object)
Use ClassMetadata.getIdentifier(Object,SessionImplementor) 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.engine.spi.Mapping.getIdentifierGeneratorFactory()
temporary solution

org.hibernate.sql.Select.getLockMode()
Instead use getLockOptions

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.tuple.entity.EntityTuplizer.instantiate(Serializable)
Use EntityTuplizer.instantiate(Serializable, SessionImplementor) instead.

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.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.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.Session.refresh(Object, LockMode)
LockMode parameter should be replaced with LockOptions

org.hibernate.sql.Template.renderOrderByStringTemplate(String, Dialect, SQLFunctionRegistry)
Use Template.renderOrderByStringTemplate(String,ColumnMapper,SessionFactoryImplementor,Dialect,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.tuple.ElementWrapper.setAttributeValue(QName, String)

org.hibernate.proxy.dom4j.Dom4jProxy.setAttributeValue(QName, String)

org.hibernate.tuple.ElementWrapper.setAttributeValue(String, String)

org.hibernate.proxy.dom4j.Dom4jProxy.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.engine.spi.SessionImplementor.setFetchProfile(String)
use SessionImplementor.getLoadQueryInfluencers() instead

org.hibernate.ejb.packaging.PersistenceMetadata.setHbmfiles(List)
use getHbmfiles() rather

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.impl.AbstractAuditQuery.setLockMode(LockMode)
Instead use setLockOptions

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)

Deprecated Constructors

org.hibernate.DuplicateMappingException(String, String)

org.hibernate.DuplicateMappingException(String, String, String)

org.hibernate.engine.spi.NamedSQLQueryDefinition(String, String, List, boolean, String, Integer, Integer, FlushMode, Map, boolean)

org.hibernate.tool.hbm2ddl.SchemaExport(Configuration, Properties)
properties may be specified via the Configuration object

Deprecated Enum Constants

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

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