Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
org.apache.cayenne.DataChannelFilter since 4.1 use DataChannelQueryFilter and DataChannelSyncFilter
org.apache.cayenne.DataChannelFilterChain since 4.1 in favor of DataChannelSyncFilterChain and DataChannelQueryFilterChain
org.apache.cayenne.reflect.Property since 4.0 renamed to PropertyDescriptor.

Deprecated Classes

Class and Description
org.apache.cayenne.resource.FilesystemResourceLocator since 4.1. This can be implemented as a custom strategy outside Cayenne. There's no need for this object to be in Cayenne.

Deprecated Exceptions

Exceptions and Description
org.apache.cayenne.CayenneException since 4.1 use CayenneRuntimeException instead

Deprecated Fields

Field and Description
org.apache.cayenne.dba.JdbcAdapter.batchQueryBuilderFactory since 4.0 BatchQueryBuilderfactory is attached to the DataNode.
org.apache.cayenne.configuration.xml.ObjRelationshipHandler.DB_RELATIONSHIP_REF_TAG
org.apache.cayenne.configuration.server.DataDomainProvider.filters since 4.1, use query and sync filters instead
org.apache.cayenne.access.DataDomain.filters since 4.1 this field is unused
org.apache.cayenne.configuration.Constants.SERVER_DOMAIN_FILTERS_LIST since 4.1 domain filters replaced with query and sync filters
org.apache.cayenne.configuration.Constants.SERVER_MAX_QUEUE_WAIT_TIME since 4.0 renamed to Constants.JDBC_MAX_QUEUE_WAIT_TIME. Property name is preserved.
org.apache.cayenne.access.DataContext.transactionFactory since 4.0 used in a method that itself should be deprecated, so this is a temp code

Deprecated Methods

Method and Description
org.apache.cayenne.access.DataDomain.addFilter(DataChannelFilter) since 4.1 use DataDomain.addQueryFilter(DataChannelQueryFilter) and DataDomain.addSyncFilter(DataChannelSyncFilter) instead
org.apache.cayenne.map.SelectQueryDescriptor.addPrefetch(String) since 4.1 use SelectQueryDescriptor.addPrefetch(String, int)
org.apache.cayenne.cache.NestedQueryCache.clear() since 4.0
org.apache.cayenne.cache.QueryCache.clear() since 4.0. Please use implementation specific methods to perform cache management tasks.
org.apache.cayenne.configuration.server.ServerModule.contributeDomainFilters(Binder) since 4.1 use ServerModule.contributeDomainQueryFilters(Binder) and ServerModule.contributeDomainSyncFilters(Binder)
org.apache.cayenne.dba.JdbcAdapter.createPkGenerator()
org.apache.cayenne.ejbql.parser.JavaCharStream.getColumn()
org.apache.cayenne.CayenneException.getExceptionLabel() since 4.1 use CayenneRuntimeException.getExceptionLabel()
org.apache.cayenne.access.DataDomain.getFilters() since 4.1 use DataDomain.getQueryFilters() and DataDomain.getSyncFilters()
org.apache.cayenne.map.ObjEntity.getJavaClass() since 4.0 this method based on statically defined class loading algorithm is not going to work in environments like OSGi. AdhocObjectFactory should be used as it can provide the environment-specific class loading policy.
org.apache.cayenne.util.Util.getJavaClass(String) since 4.0 this method based on statically defined class loading algorithm is not going to work in environments like OSGi. AdhocObjectFactory should be used as it can provide the environment-specific class loading policy.
org.apache.cayenne.ejbql.parser.JavaCharStream.getLine()
org.apache.cayenne.conn.DataSourceInfo.getPasswordEncoder() since 4.0 as class loading should not happen here.
org.apache.cayenne.map.SelectQueryDescriptor.getPrefetches() since 4.1 use SelectQueryDescriptor.getPrefetchesMap().
org.apache.cayenne.access.DataDomain.initWithProperties(Map<String, String>) since 4.0 properties are processed by the DI provider.
org.apache.cayenne.CayenneDataObject.makePath(String...) since 4.1, use Cayenne.makePath(String...) instead
org.apache.cayenne.access.DataDomain.removeFilter(DataChannelFilter) since 4.1 use DataDomain.removeQueryFilter(DataChannelQueryFilter) and DataDomain.removeSyncFilter(DataChannelSyncFilter) instead
org.apache.cayenne.query.SelectQuery.setFetchingDataRows(boolean) since 4.0, use SelectQuery.dataRowQuery(Class, Expression) to create DataRow query instead.
org.apache.cayenne.map.SelectQueryDescriptor.setPrefetches(List<String>) since 4.1 use SelectQueryDescriptor.setPrefetchesMap(HashMap).
org.apache.cayenne.access.DataContext.setTransactionFactory(TransactionFactory) since 4.0 avoid using this directly. Transaction management at this level will be eventually removed
org.apache.cayenne.dba.TypesMapping.supportsLength(int) Returns true if supplied type can have a length attribute as a part of column definition.

Deprecated Constructors

Constructor and Description
org.apache.cayenne.access.DataDomain(String, Map<String, String>) since 4.0 unused
org.apache.cayenne.query.RefreshQuery() since 4.0, "refresh all" query will drop all cache contents