Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV NEXT | FRAMES NO FRAMES

## Deprecated API

Contents

- Deprecated Classes
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

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.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV NEXT | FRAMES NO FRAMES

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