Deprecated API


Contents
Deprecated Classes
org.apache.cayenne.gen.AntClassGenerator
          since 3.0 this class is no longer relevant. 
org.apache.cayenne.tools.CayenneGenerator
          since 3.0 renamed to CayenneGeneratorTask 
org.apache.cayenne.util.CayenneMap
          since 3.0 this map is not used by Cayenne internally. 
org.apache.cayenne.gen.ClassGenerationAction1_1
          since 3.0 
org.apache.cayenne.gen.ClassGenerationInfo
          since 3.0, as class generator version 1.1 is deprecated. 
org.apache.cayenne.gen.ClassGenerator
          since 3.0 template logic is merged into the code generation action. 
org.apache.cayenne.access.DataDomainLegacyQueryAction
          since 3.0 - this class should not be public 
org.apache.cayenne.gen.DefaultClassGenerator
          since 3.0 use ClassGenerationAction and subclasses. 
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 deprecated. 
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.gen.MapClassGenerator
          since 3.0 use ClassGenerationAction and subclasses. 
org.apache.cayenne.dba.PkRange
          since 3.0 repalced with a non-public LongPkRange. 
org.apache.cayenne.map.QueryBuilder
          since 3.0 replaced by a non-public class. 
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.gen.EntityArtifact.OBJ_ENTITY_KEY
          since 3.0 "OBJECT" should be used instead, as the root key in the template is not necessarily ObjEntity. Still preserved for ObjEntities for backwards compatibility. 
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. 
org.apache.cayenne.tools.CayenneGeneratorTask.version
          since 3.0 
 

Deprecated Methods
org.apache.cayenne.map.DbEntity.addAttribute(Attribute)
          in favour of DbEntity.addAttribute(DbAttribute attr). Scheduled for removal in Cayenne 4. 
org.apache.cayenne.wocompat.parser.Parser.array()
          since 3.0, use 'collection(String)' instead. 
org.apache.cayenne.dba.JdbcPkGenerator.binaryPK(DbEntity)
          since 3.0 
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.tools.CayenneGeneratorTask.createGenerator()
          since 3.0. Use CayenneGeneratorTask.createGeneratorAction(). 
org.apache.cayenne.DataRow.createObjectId(ObjEntity)
          since 3.0 - unused 
org.apache.cayenne.DataRow.createObjectId(String, DbEntity)
          since 3.0 - unused. 
org.apache.cayenne.DataRow.createObjectId(String, DbEntity, String)
          since 3.0 - unused. 
org.apache.cayenne.wocompat.parser.Parser.dictionary()
          since 3.0, use 'map(String)' instead. 
org.apache.cayenne.dba.AutoAdapter.dropTable(DbEntity)
          since 3.0 as the deocarated method is deprecated. 
org.apache.cayenne.dba.DbAdapter.dropTable(DbEntity)
          since 3.0 Cayenne supports 'dropTableStatements' to allow multiple statements to be executed when dropping the table. 
org.apache.cayenne.dba.JdbcAdapter.dropTable(DbEntity)
          since 3.0 in favor of "dropTableStatements" 
org.apache.cayenne.dba.mysql.MySQLAdapter.dropTable(DbEntity)
          since 3.0 
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.tools.NamePatternMatcher.filter(List)
          since 3.0 
org.apache.cayenne.gen.MapClassGenerator.generateClassPairs()
          since 3.0 - unused 
org.apache.cayenne.dba.JdbcPkGenerator.generatePkForDbEntity(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.openbase.OpenBasePkGenerator.generatePkForDbEntity(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.PkGenerator.generatePkForDbEntity(DataNode, DbEntity)
          since 3.0 use PkGenerator.generatePk(DataNode, DbAttribute). 
org.apache.cayenne.gen.MapClassGenerator.generateSingleClasses()
          since 3.0 - unused. 
org.apache.cayenne.gen.EntityUtils.getBaseClassName()
          since 3.0 This value is a part of velocity context and therefore is redundant here. 
org.apache.cayenne.gen.EntityUtils.getBasePackageName()
          since 3.0 This value is a part of velocity context and therefore is redundant here. 
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.access.OptimisticLockException.getFreshSnapshot(QueryEngine)
          since 3.0 use OptimisticLockException.getFreshSnapshot(ObjectContext) 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.map.DbAttribute.getPrecision()
          since 3.0 as this property really referred to 'scale'. Use DbAttribute.getScale() instead. 
org.apache.cayenne.map.DbEntity.getPrimaryKey()
          since 3.0 use DbEntity.getPrimaryKeys() that returns a collection. 
org.apache.cayenne.dba.mysql.MySQLPkGenerator.getPrimaryKey(Statement, String)
          since 3.0 
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.gen.EntityUtils.getSubClassName()
          since 3.0 This value is a part of velocity context and therefore is redundant here. 
org.apache.cayenne.gen.EntityUtils.getSubPackageName()
          since 3.0 This value is a part of velocity context and therefore is redundant here. 
org.apache.cayenne.gen.EntityUtils.getSuperClassName()
          since 3.0 This value is a part of velocity context and therefore is redundant here. 
org.apache.cayenne.gen.EntityUtils.getSuperPackageName()
          since 3.0 This value is a part of velocity context and therefore is redundant here. 
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.map.ObjAttribute.isCompound()
          since 3.0 use 'isFlattened'. 
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.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.tools.NamePatternMatcher.passedExcludeFilter(CayenneMapEntry)
          since 3.0 
org.apache.cayenne.tools.NamePatternMatcher.passedIncludeFilter(CayenneMapEntry)
          since 3.0 
org.apache.cayenne.dba.db2.DB2PkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.derby.DerbyPkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.frontbase.FrontBasePkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.ingres.IngresPkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.JdbcPkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 JdbcPkGenerator.longPkFromDatabase(DataNode, DbEntity) is used. 
org.apache.cayenne.dba.mysql.MySQLPkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.openbase.OpenBasePkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.oracle.OraclePkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.postgres.PostgresPkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
org.apache.cayenne.dba.sybase.SybasePkGenerator.pkFromDatabase(DataNode, DbEntity)
          since 3.0 
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.map.ObjAttribute.setDbAttribute(DbAttribute)
          since 3.0 - this method only works for non-flattened attributes. 'setDbAttributePath' should be used instead. 
org.apache.cayenne.map.ObjAttribute.setDbAttributeName(String)
          since 3.0 use ObjAttribute.setDbAttributePath(String). 
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.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.tools.CayenneGeneratorTask.setVersion(String)
          since 3.0 
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. 
org.apache.cayenne.gen.MapClassGenerator(DataMap)
          since 3.0 - unused. 
 



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