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

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 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
org.eclipse.persistence.config.TargetServer.SunAS9

Deprecated Methods

Method and Description
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.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()
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.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

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'