Deprecated API

Contents

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

Deprecated Interfaces

commonj.sdo.DataGraph
. Because the same functionality can be obtained with DataObjects alone and because using DataObjects has the advantages of consistence and richer functionality, the use of the special envelope DataGraph is discouraged and may be removed altogether in a future version.

org.eclipse.persistence.sessions.factories.DescriptorCustomizer

org.eclipse.persistence.sessions.factories.SessionCustomizer

javax.xml.bind.Validator
since JAXB 2.0

Deprecated Classes

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.

Deprecated Annotation Types

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

org.eclipse.persistence.config.PersistenceUnitProperties.ALLOW_ZERO_ID
replaced by 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 CONNECTION_POOL_INITIAL

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_MAX
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_MIN
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_CONNECTIONS_WAIT
as of EclipseLink 2.2 replaced by CONNECTION_POOL_WAIT

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_INITIAL
as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_MAX
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_MIN
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_READ_CONNECTIONS_SHARED
as of EclipseLink 2.2 replaced by CONNECTION_POOL_SHARED

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL
as of EclipseLink 2.2 replaced by CONNECTION_POOL_SEQUENCE

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_DATASOURCE
as of EclipseLink 2.2 replaced by CONNECTION_POOL_NON_JTA_DATA_SOURCE

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_INITIAL
as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_MAX
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_SEQUENCE_CONNECTION_POOL_MIN
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_WRITE_CONNECTIONS_INITIAL
as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_WRITE_CONNECTIONS_MAX
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

org.eclipse.persistence.config.PersistenceUnitProperties.JDBC_WRITE_CONNECTIONS_MIN
as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

org.eclipse.persistence.jpa.rs.MatrixParameters.JPARS_RELATIONSHIP_PARTNER
Use QueryParameters.JPARS_RELATIONSHIP_PARTNER instead.

javax.persistence.Persistence.PERSISTENCE_PROVIDER

javax.persistence.Persistence.providers

Deprecated Methods

commonj.sdo.Sequence.add(int, String)
replaced by Sequence.addText(int, String) in 2.1.0

commonj.sdo.Sequence.add(String)
replaced by Sequence.addText(String) in 2.1.0

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.jpa.jpql.AbstractJPQLQueryHelper.buildGrammarValidator(JPQLQueryContext)
Eventually this method should change to accept JPQLGrammar and not JPQLQueryContext anymore

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.jpa.jpql.parser.RangeVariableDeclaration.getAbstractSchemaName()
Use RangeVariableDeclaration.getRootObject()

org.eclipse.persistence.queries.FetchGroup.getAttributes()
Use AttributeGroup.getAttributeNames()

org.eclipse.persistence.mappings.foundation.AbstractDirectMapping.getAttributeValue(Object, Session)

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()

commonj.sdo.ChangeSummary.getDataGraph()

commonj.sdo.DataObject.getDataGraph()

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.sessions.changesets.ObjectChangeSet.getPrimaryKeys()

org.eclipse.persistence.queries.ReportQueryResult.getPrimaryKeyValues()

javax.xml.bind.Validator.getProperty(String)
since JAXB2.0

commonj.sdo.DataObject.getProperty(String)
replaced by DataObject.getInstanceProperty(String) in 2.1.0

org.eclipse.persistence.queries.ReadObjectQuery.getSelectionKey()

commonj.sdo.DataObject.getSequence(int)
in 2.1.0.

org.eclipse.persistence.sdo.SDODataObject.getSequence(int)
in SDO 2.1.0.

commonj.sdo.DataObject.getSequence(Property)
in 2.1.0.

org.eclipse.persistence.sdo.SDODataObject.getSequence(Property)
in SDO 2.1.0.

commonj.sdo.DataObject.getSequence(String)
in 2.1.0.

org.eclipse.persistence.sdo.SDODataObject.getSequence(String)
in SDO 2.1.0.

org.eclipse.persistence.sessions.IdentityMapAccessor.getWriteLockValue(Vector, Class)
since EclipseLink 2.1, replaced by getWriteLockValue(Object, Class)

org.eclipse.persistence.jpa.jpql.parser.RangeVariableDeclaration.hasAbstractSchemaName()
Use RangeVariableDeclaration.hasRootObject()

org.eclipse.persistence.jpa.jpql.parser.RangeVariableDeclaration.hasSpaceAfterAbstractSchemaName()
Use RangeVariableDeclaration.hasSpaceAfterRootObject()

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

javax.xml.bind.Validator.setProperty(String, Object)
since JAXB2.0

org.eclipse.persistence.queries.ReadObjectQuery.setSelectionKey(List)

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)

javax.xml.bind.Unmarshaller.setValidating(boolean)
since JAXB2.0, please see Unmarshaller.setSchema(javax.xml.validation.Schema)

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)

commonj.sdo.helper.DataHelper.toDuration(Calendar)
There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged. Convert from a Calendar to a String representation of the Duration type.

commonj.sdo.helper.DataHelper.toDuration(Date)
There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged. Convert from a Date to a String representation of the Duration type.

org.eclipse.persistence.sessions.IdentityMapAccessor.updateWriteLockValue(Vector, Class, Object)
since EclipseLink 2.1, replaced by updateWriteLockValue(Object, Class, Object)

javax.xml.bind.Validator.validate(Object)
since JAXB2.0

javax.xml.bind.Validator.validateRoot(Object)
since JAXB2.0

Deprecated Constructors

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.DefaultGrammarValidator(JPQLQueryContext)
This constructor only exists for backward compatibility. JPQLQueryContext is no longer required, only JPQLGrammar

org.eclipse.persistence.jpa.jpql.EclipseLinkGrammarValidator(JPQLQueryContext)
This constructor only exists for backward compatibility. JPQLQueryContext is no longer required, only JPQLGrammar

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

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'