er.extensions.eof
Class ERXFetchSpecification<T extends EOEnterpriseObject>

java.lang.Object
  com.webobjects.eocontrol.EOFetchSpecification
      er.extensions.eof.ERXFetchSpecification<T>

Type Parameters:

T - the type of objects this fetch spec will return

All Implemented Interfaces:

EOKeyValueArchiving, NSCoding, Serializable, Cloneable

Direct Known Subclasses:

ERXGroupingFetchSpecification

public class ERXFetchSpecification<T extends EOEnterpriseObject>
extends EOFetchSpecification

Extended fetch specification.

• has an identifier for caching
• type-safe, can fetch objects of a certain type
• has a user info

Author:

ak

See Also:

Serialized Form

Nested Class Summary

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

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

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

EOKeyValueArchiving._NullValueSupport, EOKeyValueArchiving._NumberSupport, EOKeyValueArchiving._TimestampSupport, EOKeyValueArchiving.Awaking, EOKeyValueArchiving.FinishInitialization, EOKeyValueArchiving.Support

Field Summary

Fields inherited from class com.webobjects.eocontrol.EOFetchSpecification

_CLASS

Constructor Summary

ERXFetchSpecification(EOFetchSpecification spec)

ERXFetchSpecification(ERXFetchSpecification<T> spec)

ERXFetchSpecification(String entityName, EOQualifier qualifier, NSArray sortOrderings)

ERXFetchSpecification(String entityName, EOQualifier qualifier, NSArray sortOrderings, boolean usesDistinct, boolean isDeep, NSDictionary hints)

Method Summary

protected String	additionalIdentifierInfo()
Object	clone()
NSArray<T>	fetchObjects(EOEditingContext ec) Type-safe method to fetch objects for this fetch spec.
NSArray<NSDictionary<String,Object>>	fetchRawRows(EOEditingContext ec) Type-safe method to fetch raw rows.
static <T extends EOEnterpriseObject> ERXFetchSpecification<T>	fetchSpec(EOFetchSpecification fs) Converts a normal fetch spec to an ERX one.
static <T extends EOEnterpriseObject> ERXFetchSpecification<T>	fetchSpec(EOFetchSpecification fs, Class<T> clazz) Converts a normal fetch spec to an ERX one.
String	identifier() Collects all relevant attributes and the bindings and returns a key suitable for caching.
static String	identifierForFetchSpec(EOFetchSpecification fs) Builds an identifier for the given fetch spec which is suitable for caching.
protected static String	identifierForQualifier(EOQualifier q) Helper to create a string from a qualifier.
boolean	includeEditingContextChanges() Returns whether or not to include editing context changes.
Object	objectForKey(String key) Gets an arbitrary value.
void	setIncludeEditingContextChanges(boolean includeEditingContextChanges) When true, objectsWithFetchSpecification will include newly inserted objects, newly removed objects, and newly updated objects in your fetch results (@see ERXEOControlUtilities.objectsWithQualifier).
void	setObjectForKey(Object value, String key) Sets a arbitrary value.
NSDictionary	userInfo() Gets the user info.

Methods inherited from class com.webobjects.eocontrol.EOFetchSpecification

_decodeWithKeyValueUnarchiver, classForCoder, decodeObject, decodeWithKeyValueUnarchiver, encodeWithCoder, encodeWithKeyValueArchiver, entityName, fetchesRawRows, fetchLimit, fetchSpecificationNamed, fetchSpecificationWithQualifierBindings, hints, isDeep, locksObjects, prefetchingRelationshipKeyPaths, promptsAfterFetchLimit, qualifier, rawRowKeyPaths, refreshesRefetchedObjects, requiresAllQualifierBindingVariables, setEntityName, setFetchesRawRows, setFetchLimit, setHints, setIsDeep, setLocksObjects, setPrefetchingRelationshipKeyPaths, setPromptsAfterFetchLimit, setQualifier, setRawRowKeyPaths, setRefreshesRefetchedObjects, setRequiresAllQualifierBindingVariables, setSortOrderings, setUsesDistinct, sortOrderings, toString, usesDistinct

Methods inherited from class java.lang.Object

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

Constructor Detail

ERXFetchSpecification

public ERXFetchSpecification(String entityName,
                             EOQualifier qualifier,
                             NSArray sortOrderings,
                             boolean usesDistinct,
                             boolean isDeep,
                             NSDictionary hints)

ERXFetchSpecification

public ERXFetchSpecification(String entityName,
                             EOQualifier qualifier,
                             NSArray sortOrderings)

ERXFetchSpecification

public ERXFetchSpecification(EOFetchSpecification spec)

ERXFetchSpecification

public ERXFetchSpecification(ERXFetchSpecification<T> spec)

Method Detail

setIncludeEditingContextChanges

public void setIncludeEditingContextChanges(boolean includeEditingContextChanges)

When true, objectsWithFetchSpecification will include newly inserted objects, newly removed objects, and newly updated objects in your fetch results (@see ERXEOControlUtilities.objectsWithQualifier).

Parameters:

includeEditingContextChanges - whether or not to include editing context changes

includeEditingContextChanges

public boolean includeEditingContextChanges()

Returns whether or not to include editing context changes.

Returns:

whether or not to include editing context changes

setObjectForKey

public void setObjectForKey(Object value,
                            String key)

Sets a arbitrary value.

objectForKey

public Object objectForKey(String key)

Gets an arbitrary value.

Parameters:

key -

userInfo

public NSDictionary userInfo()

Gets the user info.

fetchObjects

public NSArray<T> fetchObjects(EOEditingContext ec)

Type-safe method to fetch objects for this fetch spec.

Parameters:

ec -

fetchRawRows

public NSArray<NSDictionary<String,Object>> fetchRawRows(EOEditingContext ec)

Type-safe method to fetch raw rows.

Parameters:

ec -

identifier

public String identifier()

Collects all relevant attributes and the bindings and returns a key suitable for caching.

additionalIdentifierInfo

protected String additionalIdentifierInfo()

clone

public Object clone()

Overrides:

clone in class EOFetchSpecification

fetchSpec

public static <T extends EOEnterpriseObject> ERXFetchSpecification<T> fetchSpec(EOFetchSpecification fs,
                                                                                Class<T> clazz)

Converts a normal fetch spec to an ERX one.

Type Parameters:

T -

Parameters:

fs -

clazz -

fetchSpec

public static <T extends EOEnterpriseObject> ERXFetchSpecification<T> fetchSpec(EOFetchSpecification fs)

Converts a normal fetch spec to an ERX one.

Type Parameters:

T -

Parameters:

fs -

identifierForQualifier

protected static String identifierForQualifier(EOQualifier q)

Helper to create a string from a qualifier.

Parameters:

q -

identifierForFetchSpec

public static String identifierForFetchSpec(EOFetchSpecification fs)

Builds an identifier for the given fetch spec which is suitable for caching.

Parameters:

fs -