Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Annotation Types
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Annotation Type Elements

Deprecated Interfaces

Interface and Description
org.eclipse.persistence.sessions.factories.DescriptorCustomizer replaced by org.eclipse.persistence.config.DescriptorCustomizer
org.eclipse.persistence.sessions.factories.SessionCustomizer replaced by org.eclipse.persistence.config.SessionCustomizer
javax.xml.bind.Validator since JAXB 2.0

Deprecated Classes

Class and Description
org.eclipse.persistence.queries.ANTLRQueryBuilder replaced with Hermes parser, which is the default.
org.eclipse.persistence.jpa.rs.resources.unversioned.EntityResource Use EntityResource instead.
org.eclipse.persistence.sessions.ObjectCopyingPolicy use CopyGroup instead.
org.eclipse.persistence.jpa.rs.resources.unversioned.PersistenceResource Use PersistenceResource instead.
org.eclipse.persistence.jpa.rs.resources.unversioned.PersistenceUnitResource Use PersistenceUnitResource instead.
org.eclipse.persistence.jpa.rs.resources.unversioned.QueryResource Use QueryResource instead.
org.eclipse.persistence.jpa.rs.resources.unversioned.SingleResultQueryResource Use SingleResultQueryResource instead.
org.eclipse.persistence.platform.server.sunas.SunAS9ServerPlatform since 2.5 replaced by GlassfishServerPlatform
org.eclipse.persistence.transaction.sunas.SunAS9TransactionController since 2.5 replaced by GlassfishTransactionController

Deprecated Annotation Types

Annotation Type and Description
org.eclipse.persistence.annotations.BasicCollection
org.eclipse.persistence.annotations.BasicMap
org.eclipse.persistence.annotations.CollectionTable
org.eclipse.persistence.oxm.annotations.XmlContainerProperty As of EclipseLink 2.0, replaced by XmlInverseReference.

Deprecated Fields

Field and Description
org.eclipse.persistence.config.PersistenceUnitProperties.ALLOW_ZERO_ID replaced by PersistenceUnitProperties.ID_VALIDATION property with value "NULL".
org.eclipse.persistence.jaxb.JAXBContextFactory.ANNOTATION_HELPER_KEY As of release 2.4, replaced by JAXBContextProperties.ANNOTATION_HELPER
org.eclipse.persistence.config.ParserType.ANTLR
org.eclipse.persistence.jaxb.JAXBContextFactory.DEFAULT_TARGET_NAMESPACE_KEY As of release 2.4, replaced by JAXBContextProperties.DEFAULT_TARGET_NAMESPACE
org.eclipse.persistence.sequencing.TableSequence.defaultTableName Use an empty string as a default sequence table name instead, that triggers usage of platform.getDefaultSequenceTableName() when the sequence is connected.
org.eclipse.persistence.jaxb.JAXBContextFactory.ECLIPSELINK_OXM_XML_KEY As of release 2.4, replaced by JAXBContextProperties.OXM_METADATA_SOURCE
org.eclipse.persistence.logging.SessionLog.EJB_OR_METADATA use SessionLog.METADATA
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_INITIAL as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_INITIAL
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_MAX as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MAX
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_MIN as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MIN
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_WAIT as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_WAIT
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_INITIAL as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_INITIAL
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_MAX as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MAX
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_MIN as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MIN
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_SHARED as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_SHARED
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_SEQUENCE
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_DATASOURCE as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_NON_JTA_DATA_SOURCE
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_INITIAL as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_INITIAL
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_MAX as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MAX
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_MIN as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MIN
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_WRITE_CONNECTIONS_INITIAL as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_INITIAL
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_WRITE_CONNECTIONS_MAX as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MAX
org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_WRITE_CONNECTIONS_MIN as of EclipseLink 2.2 replaced by PersistenceUnitProperties.CONNECTION_POOL_MIN
org.eclipse.persistence.Version.JDK_1_5 Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.JDK_1_6 Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.JDK_1_7 Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.JDK_1_8 Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.JDK_1_9 Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.JDK_VERSION Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.JDK_VERSION_NOT_SET Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.jpa.rs.ReservedWords.JPARS_LIST_GROUPING_NAME
org.eclipse.persistence.jpa.rs.MatrixParameters.JPARS_RELATIONSHIP_PARTNER Use QueryParameters.JPARS_RELATIONSHIP_PARTNER instead.
org.eclipse.persistence.sessions.JNDIConnector.lookupType
org.eclipse.persistence.config.EntityManagerProperties.ORDER_UPDATES since 2.6 replaced by PERSISTENCE_CONTEXT_COMMIT_ORDER
org.eclipse.persistence.config.PersistenceUnitProperties.ORDER_UPDATES as of EclipseLink 2.6 replaced by PersistenceUnitProperties.PERSISTENCE_CONTEXT_COMMIT_ORDER
javax.persistence.Persistence.PERSISTENCE_PROVIDER
javax.persistence.Persistence.providers
org.eclipse.persistence.config.TargetServer.SunAS9

Deprecated Methods

Method and Description
org.eclipse.persistence.queries.ObjectLevelReadQuery.addPartialAttribute(Expression) since EclipseLink 2.1, partial attributes replaced by fetch groups.
org.eclipse.persistence.queries.ObjectLevelReadQuery.addPartialAttribute(String) since EclipseLink 2.1, partial attributes replaced by fetch groups.
org.eclipse.persistence.expressions.Expression.all(Vector) since 2.4 replaced by all(List)
org.eclipse.persistence.expressions.Expression.any(Vector) since 2.4 replaced by any(List)
org.eclipse.persistence.expressions.Expression.as(Class) replaced by Expression.treat(Class)
org.eclipse.persistence.sessions.IdentityMapAccessor.containsObjectInIdentityMap(Vector, Class) since EclipseLink 2.1, replaced by containsObjectInIdentityMap(Object, Class)
org.eclipse.persistence.sessions.Session.copyObject(Object) since EclipseLink 2.1, replaced by copy(Object)
org.eclipse.persistence.sessions.Session.copyObject(Object, ObjectCopyingPolicy) since EclipseLink 2.1, replaced by copy(Object, AttributeGroup)
javax.xml.bind.JAXBContext.createValidator() since JAXB2.0
org.eclipse.persistence.expressions.ExpressionOperator.expressionForArguments(Expression, Vector)
org.eclipse.persistence.queries.FetchGroup.getAttributes() Use CoreAttributeGroup.getAttributeNames()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.getContainerAccessor() Replaced by getInverseReferenceMapping().getAttributeAccessor()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.getContainerAccessor() Replaced by getInverseReferenceMapping().getAttributeAccessor()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.getContainerAttributeName() Replaced by getInverseReferenceMapping().getAttributeName()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.getContainerAttributeName() Replaced by getInverseReferenceMapping().getAttributeName()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.getContainerGetMethodName() Replaced by getInverseReferenceMapping().getGetMethodName()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.getContainerGetMethodName() Replaced by getInverseReferenceMapping().getGetMethodName()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.getContainerSetMethodName() Replaced by getInverseReferenceMapping().getSetMethodName()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.getContainerSetMethodName() Replaced by getInverseReferenceMapping().getSetMethodName()
org.eclipse.persistence.sessions.Project.getDefaultIsIsolated() see getDefaultCacheIsolation()
org.eclipse.persistence.jpa.JpaHelper.getEntityManagerFactory(EntityManagerFactoryImpl)
javax.xml.bind.Validator.getEventHandler() since JAXB2.0
org.eclipse.persistence.sessions.IdentityMapAccessor.getFromIdentityMap(Vector, Class) since EclipseLink 2.1, replaced by getFromIdentityMap(Object, Class)
org.eclipse.persistence.sessions.IdentityMapAccessor.getFromIdentityMap(Vector, Class, boolean) since EclipseLink 2.1, replaced by getFromIdentityMap(Object, Class, boolean)
org.eclipse.persistence.expressions.Expression.getFunction(int, Vector)
org.eclipse.persistence.expressions.Expression.getFunctionWithArguments(String, Vector)
org.eclipse.persistence.platform.database.MySQLPlatform.getIdentifierQuoteCharacter()
org.eclipse.persistence.Version.getJDKVersion() Use JavaSEPlatform.CURRENT instead. Will be removed in 2.7.
org.eclipse.persistence.sessions.JNDIConnector.getLookupType() As of 2.6.0, replaced by configuration provided by ServerPlatform.getJNDIConnectorLookupType()
org.eclipse.persistence.sessions.changesets.ObjectChangeSet.getPrimaryKeys() since EclipseLink 2.1, replaced by getId()
org.eclipse.persistence.queries.ReportQueryResult.getPrimaryKeyValues() since 2.1, replaced by getId()
javax.xml.bind.Validator.getProperty(String) since JAXB2.0
org.eclipse.persistence.queries.ReadObjectQuery.getSelectionKey() since EclipseLink 2.1, replaced by getSelectionId()
org.eclipse.persistence.sessions.IdentityMapAccessor.getWriteLockValue(Vector, Class) since EclipseLink 2.1, replaced by getWriteLockValue(Object, Class)
org.eclipse.persistence.platform.server.wls.WebLogic_10_Platform.initializeApplicationNameAndModuleName()
org.eclipse.persistence.sessions.IdentityMapAccessor.invalidateObject(Vector, Class) since EclipseLink 2.1, replaced by invalidateObject(Object, Class)
org.eclipse.persistence.sessions.IdentityMapAccessor.invalidateObject(Vector, Class, boolean) since EclipseLink 2.1, replaced by invalidateObject(Object, Class, boolean)
org.eclipse.persistence.sessions.IdentityMapAccessor.isValid(Vector, Class) since EclipseLink 2.1, replaced by isValid(Object, Class)
javax.xml.bind.Unmarshaller.isValidating() since JAXB2.0, please see Unmarshaller.getSchema()
org.eclipse.persistence.sessions.Session.keyFromObject(Object) since EclipseLink 2.1, replaced by getId(Object)
org.eclipse.persistence.oxm.XMLMarshaller.objectToXML(Object, Node)
org.eclipse.persistence.sessions.IdentityMapAccessor.putInIdentityMap(Object, Vector) since EclipseLink 2.1, replaced by putInIdentityMap(Object, Object)
org.eclipse.persistence.sessions.IdentityMapAccessor.putInIdentityMap(Object, Vector, Object) since EclipseLink 2.1, replaced by putInIdentityMap(Object, Object, Object)
org.eclipse.persistence.sessions.IdentityMapAccessor.putInIdentityMap(Object, Vector, Object, long) since EclipseLink 2.1, replaced by putInIdentityMap(Object, Object, Object, long)
org.eclipse.persistence.sessions.IdentityMapAccessor.removeFromIdentityMap(Vector, Class) since EclipseLink 2.1, replaced by removeFromIdentityMap(Object, Class)
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.setContainerAccessor(AttributeAccessor) Replaced by getInverseReferenceMapping().setAttributeAccessor()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.setContainerAccessor(AttributeAccessor) Replaced by getInverseReferenceMapping().setAttributeAccessor()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.setContainerAttributeName(String) Replaced by getInverseReferenceMapping().setAttributeName()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.setContainerAttributeName(String) Replaced by getInverseReferenceMapping().setAttributeName()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.setContainerGetMethodName(String) Replaced by getInverseReferenceMapping().setGetMethodName()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.setContainerGetMethodName(String) Replaced by getInverseReferenceMapping().setGetMethodName()
org.eclipse.persistence.oxm.mappings.XMLCompositeCollectionMapping.setContainerSetMethodName(String) Replaced by getInverseReferenceMapping().setSetMethodName()
org.eclipse.persistence.oxm.mappings.XMLCompositeObjectMapping.setContainerSetMethodName(String) Replaced by getInverseReferenceMapping().setSetMethodName()
org.eclipse.persistence.sessions.Project.setDefaultIsIsolated(boolean) see setDefaultCacheIsolation(CacheIsolationType)
javax.xml.bind.Validator.setEventHandler(ValidationEventHandler) since JAXB2.0
org.eclipse.persistence.descriptors.ClassDescriptor.setIsIsolated(boolean) as of EclipseLink 2.2
org.eclipse.persistence.sessions.JNDIConnector.setLookupType(int) As of 2.6.0, replaced by configuration provided by ServerPlatform.getJNDIConnectorLookupType()
javax.xml.bind.Validator.setProperty(String, Object) since JAXB2.0
org.eclipse.persistence.queries.ReadObjectQuery.setSelectionKey(List) since EclipseLink 2.1, replaced by setSelectionId(Object)
org.eclipse.persistence.sessions.UnitOfWork.setShouldOrderUpdates(boolean) since 2.6 replaced by #setCommitOrder(CommitOrderType)
org.eclipse.persistence.descriptors.invalidation.CacheInvalidationPolicy.setShouldRefreshInvalidObjectsInUnitOfWork(boolean) since EclipseLink 2.2
org.eclipse.persistence.sessions.server.ConnectionPolicy.setShouldUseExclusiveConnection(boolean)
org.eclipse.persistence.queries.ReadObjectQuery.setSingletonSelectionKey(Object) since EclipseLink 2.1, replaced by setSelectionId(Object)
javax.xml.bind.Unmarshaller.setValidating(boolean) since JAXB2.0, please see Unmarshaller.setSchema(javax.xml.validation.Schema)
org.eclipse.persistence.sessions.UnitOfWork.shouldOrderUpdates() since 2.6 replaced by #getCommitOrder()
org.eclipse.persistence.descriptors.invalidation.CacheInvalidationPolicy.shouldRefreshInvalidObjectsInUnitOfWork() since EclipseLink 2.2
org.eclipse.persistence.sessions.server.ConnectionPolicy.shouldUseExclusiveConnection()
org.eclipse.persistence.expressions.Expression.some(Vector) since 2.4 replaced by some(List)
org.eclipse.persistence.sessions.IdentityMapAccessor.updateWriteLockValue(Vector, Class, Object) since EclipseLink 2.1, replaced by updateWriteLockValue(Object, Class, Object)
org.eclipse.persistence.Version.useJDK15() Use JavaSEPlatform instead. Will be removed in 2.7.
org.eclipse.persistence.Version.useJDK16() Use JavaSEPlatform instead. Will be removed in 2.7.
javax.xml.bind.Validator.validate(Object) since JAXB2.0
javax.xml.bind.Validator.validateRoot(Object) since JAXB2.0

Deprecated Constructors

Constructor and Description
org.eclipse.persistence.descriptors.changetracking.CollectionChangeEvent(Object, String, Object, Object, int) as of EclipseLink 2.3
org.eclipse.persistence.descriptors.changetracking.CollectionChangeEvent(Object, String, Object, Object, int, Integer) as of EclipseLink 2.3
org.eclipse.persistence.descriptors.changetracking.CollectionChangeEvent(Object, String, Object, Object, int, Integer, boolean) as of EclipseLink 2.3
org.eclipse.persistence.jpa.jpql.tools.EclipseLinkSemanticValidator(JPQLQueryContext) Use EclipseLinkSemanticValidator.EclipseLinkSemanticValidator(JPQLQueryContext, EclipseLinkSemanticValidatorExtension)
org.eclipse.persistence.descriptors.changetracking.MapChangeEvent(Object, String, Object, Object, Object, int) as of EclipseLink 2.3
org.eclipse.persistence.tools.profiler.PerformanceProfiler(Session) replaced by PerformanceProfiler()
org.eclipse.persistence.tools.profiler.PerformanceProfiler(Session, boolean) replaced by PerformanceProfiler()

Deprecated Annotation Type Elements

Annotation Type Element and Description
org.eclipse.persistence.annotations.StoredProcedureParameter.direction
org.eclipse.persistence.annotations.NamedStoredProcedureQuery.resultClass
org.eclipse.persistence.annotations.NamedStoredProcedureQuery.resultSetMapping
org.eclipse.persistence.annotations.Cache.shared As of Eclipselink 2.2. See the attribute 'isolation'