er.extensions.eof

Class ERXDatabaseDataSource

java.lang.Object

com.webobjects.eocontrol.EODataSource

com.webobjects.eoaccess.EODatabaseDataSource

er.extensions.eof.ERXDatabaseDataSource

All Implemented Interfaces:

com.webobjects.eocontrol.EOKeyValueArchiving, com.webobjects.eocontrol.EOKeyValueArchiving.Awaking, com.webobjects.foundation.NSCoding, Serializable

public class ERXDatabaseDataSource
extends com.webobjects.eoaccess.EODatabaseDataSource

enhanced version which allows the user to 1) set refreshesRefetchedObjects 2) set prefetchingRelationshipKeyPaths which modifies the datasource's fetchSpecification

See Also:

Serialized Form

Author:

david teran

Nested Class Summary

Nested classes/interfaces inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving

com.webobjects.eocontrol.EOKeyValueArchiving._NullValueSupport, com.webobjects.eocontrol.EOKeyValueArchiving._NumberSupport, com.webobjects.eocontrol.EOKeyValueArchiving._TimestampSupport, com.webobjects.eocontrol.EOKeyValueArchiving.Awaking, com.webobjects.eocontrol.EOKeyValueArchiving.FinishInitialization, com.webobjects.eocontrol.EOKeyValueArchiving.Support

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSCoding

com.webobjects.foundation.NSCoding._BigDecimalSupport, com.webobjects.foundation.NSCoding._BigIntegerSupport, com.webobjects.foundation.NSCoding._BooleanSupport, com.webobjects.foundation.NSCoding._ByteSupport, com.webobjects.foundation.NSCoding._CharacterSupport, com.webobjects.foundation.NSCoding._DateSupport, com.webobjects.foundation.NSCoding._DoubleSupport, com.webobjects.foundation.NSCoding._FloatSupport, com.webobjects.foundation.NSCoding._IntegerSupport, com.webobjects.foundation.NSCoding._LongSupport, com.webobjects.foundation.NSCoding._NumberSupport, com.webobjects.foundation.NSCoding._ShortSupport, com.webobjects.foundation.NSCoding._StringSupport, com.webobjects.foundation.NSCoding.Support

Field Summary

Fields

Modifier and Type	Field and Description
NSArray<String>	_prefetchingRelationshipKeyPaths
boolean	_refreshRefetchedObjects

Fields inherited from class com.webobjects.eoaccess.EODatabaseDataSource

_auxiliaryQualifier, _bindings, _editingContext, _fetchSpecification, _fetchSpecificationName, _flags_fetchEnabled, _registeredDBContextSelector

Fields inherited from class com.webobjects.eocontrol.EODataSource

_CLASS

Fields inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving

_CLASS

Fields inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving.Awaking

_CLASS

Fields inherited from interface com.webobjects.foundation.NSCoding

_CLASS

Constructor Summary

Constructors

Constructor and Description
ERXDatabaseDataSource(com.webobjects.eocontrol.EOEditingContext ec, String entityName) Constructs a new ERXDatabaseDataSource to fetch all objects for the EOEntity specified by entityName into ec.
ERXDatabaseDataSource(com.webobjects.eocontrol.EOEditingContext ec, String entityName, String fetchSpecificationName) Constructs a new ERXDatabaseDataSource to fetch objects into ec for the EOEntity specified by entityName using the fetch specification fetchSpecificationName.
ERXDatabaseDataSource(com.webobjects.eocontrol.EOEditingContext ec, String entityName, String fetchSpecificationName, boolean refresh) Constructs a new ERXDatabaseDataSource to fetch objects into ec for the EOEntity specified by entityName using the fetch specification fetchSpecificationName.

Method Summary

Modifier and Type	Method and Description
com.webobjects.eocontrol.EOFetchSpecification	fetchSpecification() Enhanced version which uses the refreshesRefetchedObjects value
com.webobjects.eocontrol.EOFetchSpecification	fetchSpecificationForFetch() Enhanced version which uses the refreshesRefetchedObjects value
NSArray	prefetchingRelationshipKeyPaths()
boolean	refreshesRefetchedObjects()
void	setPrefetchingRelationshipKeyPaths(ERXKey<?>... prefetchingRelationshipKeyPaths) Sets the relationships to prefetch along with the main fetch.
void	setPrefetchingRelationshipKeyPaths(NSArray<String> relationshipKeyPaths)
void	setRefreshesRefetchedObjects(boolean v)

Methods inherited from class com.webobjects.eoaccess.EODatabaseDataSource

_finishInitialization, _partialInitWithEditingContextEntityNameFetchSpecificationName, _qualifierForRelationshipKey, auxiliaryQualifier, awakeFromKeyValueUnarchiver, awakeFromNib, classDescriptionForObjects, classForCoder, createObject, databaseContext, dataSourceQualifiedByKey, decodeObject, decodeWithKeyValueUnarchiver, deleteObject, editingContext, encodeWithCoder, encodeWithKeyValueArchiver, entity, fetchObjects, fetchSpecificationName, insertObject, isFetchEnabled, qualifierBindingKeys, qualifierBindings, qualifyWithRelationshipKey, setAuxiliaryQualifier, setEditingContext, setFetchEnabled, setFetchSpecification, setFetchSpecificationByName, setParentDataSourceRelationshipKey, setQualifierBindings

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

_refreshRefetchedObjects

public boolean _refreshRefetchedObjects

_prefetchingRelationshipKeyPaths

public NSArray<String> _prefetchingRelationshipKeyPaths

Constructor Detail

ERXDatabaseDataSource

public ERXDatabaseDataSource(com.webobjects.eocontrol.EOEditingContext ec,
                             String entityName)

Constructs a new ERXDatabaseDataSource to fetch all objects for the EOEntity specified by entityName into ec. Finds the EOObjectStoreCoordinator for ec and searches for a channel that services the model of the entity. If one exists, the ERXDatabaseDataSource uses it. Otherwise, a new one is created for this ERXDatabaseDataSource.

Parameters:

ec - the editing context into which to fetch objects

entityName - the EOEntity for this data source

ERXDatabaseDataSource

public ERXDatabaseDataSource(com.webobjects.eocontrol.EOEditingContext ec,
                             String entityName,
                             String fetchSpecificationName)

Constructs a new ERXDatabaseDataSource to fetch objects into ec for the EOEntity specified by entityName using the fetch specification fetchSpecificationName. Finds the EOObjectStoreCoordinator for ec and searches for a channel that services the model of the entity. If one exists, the ERXDatabaseDataSource uses it. Otherwise, a new one is created for this ERXDatabaseDataSource.
fetchSpecificationName is used to find the fetch specification in the entity. If fetchSpecificationName is null, a new fetch specification is instantiated that will fetch all objects of the entity.

Parameters:

ec - the editing context into which to fetch objects

entityName - the EOEntity for this data source

fetchSpecificationName - the criteria to select and order a group of database records, or null

ERXDatabaseDataSource

public ERXDatabaseDataSource(com.webobjects.eocontrol.EOEditingContext ec,
                             String entityName,
                             String fetchSpecificationName,
                             boolean refresh)

Constructs a new ERXDatabaseDataSource to fetch objects into ec for the EOEntity specified by entityName using the fetch specification fetchSpecificationName. Finds the EOObjectStoreCoordinator for ec and searches for a channel that services the model of the entity. If one exists, the ERXDatabaseDataSource uses it. Otherwise, a new one is created for this ERXDatabaseDataSource.
fetchSpecificationName is used to find the fetch specification in the entity. If fetchSpecificationName is null, a new fetch specification is instantiated that will fetch all objects of the entity.

Parameters:

ec - the editing context into which to fetch objects

entityName - the EOEntity for this data source

fetchSpecificationName - the criteria to select and order a group of database records, or null

refresh - true if you want to refresh refetched objects

Method Detail

setRefreshesRefetchedObjects

public void setRefreshesRefetchedObjects(boolean v)

refreshesRefetchedObjects

public boolean refreshesRefetchedObjects()

prefetchingRelationshipKeyPaths

public NSArray prefetchingRelationshipKeyPaths()

setPrefetchingRelationshipKeyPaths

public void setPrefetchingRelationshipKeyPaths(NSArray<String> relationshipKeyPaths)

setPrefetchingRelationshipKeyPaths

public void setPrefetchingRelationshipKeyPaths(ERXKey<?>... prefetchingRelationshipKeyPaths)

Sets the relationships to prefetch along with the main fetch.

Parameters:

prefetchingRelationshipKeyPaths - list of keys to prefetch

See Also:

setPrefetchingRelationshipKeyPaths(NSArray)

fetchSpecificationForFetch

public com.webobjects.eocontrol.EOFetchSpecification fetchSpecificationForFetch()

Enhanced version which uses the refreshesRefetchedObjects value

Overrides:

fetchSpecificationForFetch in class com.webobjects.eoaccess.EODatabaseDataSource

See Also:

setRefreshesRefetchedObjects(boolean), EOFetchSpecification.refreshesRefetchedObjects()

fetchSpecification

public com.webobjects.eocontrol.EOFetchSpecification fetchSpecification()

Enhanced version which uses the refreshesRefetchedObjects value

Overrides:

fetchSpecification in class com.webobjects.eoaccess.EODatabaseDataSource

See Also:

setRefreshesRefetchedObjects(boolean), EOFetchSpecification.refreshesRefetchedObjects()