Deprecated API


Contents
Deprecated Classes
org.apache.cayenne.util.CayenneMap
          since 3.0 this map is not used by Cayenne internally. 
org.apache.cayenne.query.DeleteQuery
          since 3.0. Should be replaced either with EJBQL update query or SQLTemplate. 
org.apache.cayenne.access.trans.DeleteTranslator
          since 3.0 since DeleteQuery is deprecacted. 
org.apache.cayenne.map.DerivedDbAttribute
          since 3.0M2 (scheduled for removal in 3.0M3) this type of mapping is no longer supported. 
org.apache.cayenne.map.DerivedDbEntity
          since 3.0M2 (scheduled for removal in 3.0M3) this type of mapping is no longer supported. 
org.apache.cayenne.reflect.IndexedListProperty
          since 3.0 (no substitute exists in Cayenne) 
org.apache.cayenne.reflect.ListProperty
          since 3.0 replaced by non-public classes. 
org.apache.cayenne.access.jdbc.UpdateAction
          since 3.0 as corresponding delete and update queries are deprecated. 
org.apache.cayenne.query.UpdateQuery
          since 3.0. Should be replaced either with EJBQL update query or SQLTemplate. 
 

Deprecated Fields
org.apache.cayenne.conf.DBCPDataSourceFactory.PROPERTY_PREFIX
          since 2.0 - this information is now private. 
org.apache.cayenne.conf.DBCPDataSourceFactory.PS_PROPERTY_PREFIX
          since 2.0 - this information is now private. 
org.apache.cayenne.dba.db2.DB2PkGenerator.SEQUENCE_PREFIX
          since 2.0 - other generators do not expose the default prefix. 
org.apache.cayenne.Fault.toManyFault
          since 3.0 as the fault singletons are no longer static and are managed by the Cayenne configuration. 
org.apache.cayenne.Fault.toOneFault
          since 3.0 as the fault singletons are no longer static and are managed by the Cayenne configuration. 
 

Deprecated Methods
org.apache.cayenne.query.SelectQuery.andParentQualifier(Expression)
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.wocompat.parser.Parser.array()
          since 3.0, use 'collection(String)' instead. 
org.apache.cayenne.access.ObjectStore.cachedQueriesCount()
          since 3.0. See DataContext.getQueryCache(). 
org.apache.cayenne.access.ObjectStore.cacheQueryResult(String, List)
          since 3.0. See DataContext.getQueryCache(). 
org.apache.cayenne.access.DataContext.createAndRegisterNewObject(Class)
          since 3.0, use DataContext.newObject(Class) instead. 
org.apache.cayenne.access.DataContext.createAndRegisterNewObject(String)
          since 3.0, use DataContext.newObject(String) instead. 
org.apache.cayenne.access.DbGenerator.createFkConstraintsQueries(DbEntity)
          since 3.0 as this method is used to generate both FK and UNIQUE constraints, use 'createConstraintsQueries' instead. 
org.apache.cayenne.wocompat.parser.Parser.dictionary()
          since 3.0, use 'map(String)' instead. 
org.apache.cayenne.CayenneDataObject.fetchFinished()
          since 3.0 use callbacks. 
org.apache.cayenne.DataObject.fetchFinished()
          since 3.0 users must use callbacks instead. This method is no longer invoked by Cayenne runtime. 
org.apache.cayenne.access.IncrementalFaultList.fillIn(Query)
          since 3.0 this method is not called and is deprecated in favor of IncrementalFaultList.fillIn(Query, List, boolean), as this method performed unneeded synchronization. 
org.apache.cayenne.access.ObjectStore.getCachedQueryResult(String)
          since 3.0. See DataContext.getQueryCache(). 
org.apache.cayenne.ejbql.parser.JavaCharStream.getColumn()
            
org.apache.cayenne.exp.parser.JavaCharStream.getColumn()
            
org.apache.cayenne.wocompat.parser.SimpleCharStream.getColumn()
            
org.apache.cayenne.CayenneDataObject.getDataContext()
          since 3.0 use CayenneDataObject.getObjectContext(). 
org.apache.cayenne.DataObject.getDataContext()
          since 3.0 use Persistent.getObjectContext(). 
org.apache.cayenne.access.types.ExtendedTypeMap.getDefaultType(String)
          since 3.0 - use ExtendedTypeMap.createType(String) instead. 
org.apache.cayenne.wocompat.EOObjEntity.getHasSuperClass()
          since 2.0 use isSubclass() 
org.apache.cayenne.wocompat.EOObjEntity.getIsAbstractEntity()
          since 2.0 use isAbstractEntity() 
org.apache.cayenne.wocompat.EOObjEntity.getIsClientEntity()
          since 2.0 use !isServerOnly() 
org.apache.cayenne.ejbql.parser.JavaCharStream.getLine()
            
org.apache.cayenne.exp.parser.JavaCharStream.getLine()
            
org.apache.cayenne.wocompat.parser.SimpleCharStream.getLine()
            
org.apache.cayenne.query.SelectQuery.getParentObjEntityName()
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.query.SelectQuery.getParentQualifier()
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.map.DbAttribute.getPrecision()
          since 3.0 as this property really referred to 'scale'. Use DbAttribute.getScale() instead. 
org.apache.cayenne.reflect.ClassDescriptor.getProperties()
          since 3.0. Use ClassDescriptor.visitProperties(PropertyVisitor) method instead. 
org.apache.cayenne.reflect.LazyClassDescriptorDecorator.getProperties()
          since 3.0. Use LazyClassDescriptorDecorator.visitProperties(PropertyVisitor) method instead. 
org.apache.cayenne.reflect.PersistentDescriptor.getProperties()
          since 3.0. Use PersistentDescriptor.visitProperties(PropertyVisitor) method instead. 
org.apache.cayenne.wocompat.EOObjAttribute.getReadOnly()
          since 2.0 use isReadOnly(). 
org.apache.cayenne.Fault.getToManyFault()
          since 3.0 as the fault singletons are no longer static and are managed by the Cayenne configuration. 
org.apache.cayenne.Fault.getToOneFault()
          since 3.0 as the fault singletons are no longer static and are managed by the Cayenne configuration. 
org.apache.cayenne.access.ClientServerChannel.isLifecycleEventsEnabled()
          Since 3.0 - always returns false. This method was a misnomer referring to DataChannel events, not lifecycle events introduced in 3.0. Currently ClientServerChannel posts no channel events. 
org.apache.cayenne.query.SelectQuery.isQualifiedOnParent()
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.access.jdbc.SQLTemplateAction.isRemovingLineBreaks()
          since 3.0 
org.apache.cayenne.map.EntityResolver.lookupDbEntity(Class)
          since 3.0 - lookup DbEntity via ObjEntity instead. 
org.apache.cayenne.map.EntityResolver.lookupDbEntity(Persistent)
          since 3.0 - lookup DbEntity via ObjEntity instead. 
org.apache.cayenne.map.EntityResolver.lookupObjEntity(String)
          since 3.0 - use getObjEntity() instead. 
org.apache.cayenne.wocompat.parser.Parser.object()
          since 3.0, use 'object(String)' instead. 
org.apache.cayenne.access.ObjectStore.objectsInvalidated(Collection)
          since 3.0, use DataContext.invalidateObjects(Collection) or RefreshQuery. 
org.apache.cayenne.query.SelectQuery.orParentQualifier(Expression)
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.BaseContext.prepareForAccess(Persistent, String)
          since 3.0 this method is replaced by BaseContext.prepareForAccess(Persistent, String, boolean). 
org.apache.cayenne.ObjectContext.prepareForAccess(Persistent, String)
          since 3.0 use ObjectContext.prepareForAccess(Persistent, String, boolean). 
org.apache.cayenne.access.DataContext.refetchObject(ObjectId)
          since 3.0 use ObjectIdQuery with appropriate refresh settings. 
org.apache.cayenne.access.ObjectStore.resolveHollow(Persistent)
          since 3.0 use ObjectContext.prepareForAccess(Persistent, String, boolean). 
org.apache.cayenne.CayenneDataObject.setDataContext(DataContext)
          since 3.0 use CayenneDataObject.setObjectContext(ObjectContext). 
org.apache.cayenne.DataObject.setDataContext(DataContext)
          since 3.0 use Persistent.setObjectContext(ObjectContext). 
org.apache.cayenne.wocompat.EOObjEntity.setHasSuperClass(boolean)
          since 2.0 use setSubclass() 
org.apache.cayenne.wocompat.EOObjEntity.setIsAbstractEntity(boolean)
          since 2.0 use setAbstractEntity() 
org.apache.cayenne.wocompat.EOObjEntity.setIsClientEntity(boolean)
          since 2.0 use setServerOnly() 
org.apache.cayenne.access.ClientServerChannel.setLifecycleEventsEnabled(boolean)
          Since 3.0 - does nothing. This method was a misnomer referring to DataChannel events, not lifecycle events introduced in 3.0. Currently ClientServerChannel posts no channel events. 
org.apache.cayenne.query.SelectQuery.setParentObjEntityName(String)
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.query.SelectQuery.setParentQualifier(Expression)
          since 3.0M2 (scheduled for removal in 3.0M3) as DerivedDbEntity is deprecated. 
org.apache.cayenne.map.DbAttribute.setPrecision(int)
          since 3.0 as this property really referred to 'scale'. Use DbAttribute.setScale(int) instead. 
org.apache.cayenne.access.jdbc.SQLTemplateAction.setRemovingLineBreaks(boolean)
          since 3.0 - does nothing 
org.apache.cayenne.access.ObjectStore.startTrackingNewObjects()
          since 3.0 as ObjectStore holds weak reference to unmodified objects and this feature is useless. 
org.apache.cayenne.dba.AutoAdapter.supportsFkConstraints()
          since 3.0 - almost all DB's support FK's now and also this flag is less relevant for Cayenne now. 
org.apache.cayenne.dba.DbAdapter.supportsFkConstraints()
          since 3.0 - almost all DB's support FK's now and also this flag is less relevant for Cayenne now. 
org.apache.cayenne.access.ObjectStore.unregisterNewObjects()
          since 3.0 as ObjectStore holds weak reference to unmodified objects and this feature is useless. 
org.apache.cayenne.dba.JdbcActionBuilder.updateAction(Query)
          since 3.0 as the corresponding UpdateQuery and DeleteQuery queries are deprecated. 
org.apache.cayenne.query.SQLActionVisitor.updateAction(Query)
          since 3.0 as the corresponding UpdateQuery and DeleteQuery queries are deprecated. 
org.apache.cayenne.access.types.AbstractType.validateNull(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.AbstractType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.BigIntegerType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.BooleanType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.ByteArrayType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.CalendarType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.CharType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.EnumType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.ExtendedType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
org.apache.cayenne.access.types.UtilDateType.validateProperty(Object, String, Object, DbAttribute, ValidationResult)
          since 3.0 as validation should not be done at the DataNode level. 
 

Deprecated Constructors
org.apache.cayenne.access.ClientServerChannel(DataDomain, boolean)
          since 3.0 as DataChannel events (incorrectly called "lifecycleEvents" in 2.0) are no longer posted by ClientServerChannel. 
org.apache.cayenne.access.DataRowStore(String)
          since 3.0 as it instantiates an EventManager internally that can lead to dispatch thread leaks. 
org.apache.cayenne.access.DataRowStore(String, Map)
          since 3.0 as it instantiates an EventManager internally that can lead to dispatch thread leaks. 
org.apache.cayenne.dba.JdbcActionBuilder(DbAdapter, EntityResolver)
          since 3.0 use "JdbcActionBuilder(JdbcAdapter,EntityResolver)" constructor instead. 
 



Copyright © 2001-2007 Apache Cayenne. All Rights Reserved.