public Class FetchGroupManager

Add a named fetch group to the descriptor

INTERNAL: Add primary key and version attributes to the passed fetch group.

Overrides java.lang.Object.clone.

INTERNAL: Clone the fetch group manager.

Returns:Object

Doc from java.lang.Object.clone.

a clone of this instance.

Annotations

@Override

INTERNAL: Copy fetch group reference from the source object to the target

INTERNAL: Copy fetch group reference from the source object to the target

PUBLIC: Returns clone of the default fetch group. Could be used as a starting point for a new user-defined fetch group.

PUBLIC: Returns clone of the full fetch group - contains all the attributes, no nesting. Could be used as a starting point for a new user-defined fetch group.

PUBLIC: Returns clone of the minimal fetch group. Could be used as a starting point for a new user-defined fetch group.

INTERNAL: Union two fetch groups as EntityFetchGroups. Ignores all nested attributes.

INTERNAL: Returns EntityFetchGroup corresponding to default FetchGroup.

Return the descriptor-level default fetch group. All read object and read all queries would use the default fetch group if no fetch group is explicitly defined for the query, unless setShouldUseDefaultFetchGroup(false); is also called on the query. Default fetch group should be used carefully. It would be beneficial if most of the system queries are for the subset of the object, so un-needed attributes data would not have to be read, and the users do not have to setup every query for the given fetch group, as default one is always used. However, if queries on object are mostly use case specific and not systematic, using default fetch group could cause undesirable extra round-trip and performance degradation.

See Also

org.eclipse.persistence.queries.ObjectLevelReadQuery#setShouldUseDefaultFetchGroup(boolean)

PUBLIC: Return the referenced descriptor.

INTERNAL: Returns entity fetch group corresponding to the passed set of attributes.

INTERNAL: Returns entity fetch group corresponding to the passed fetch group.

Return a pre-defined named fetch group. Lookup the FetchGroup to use given a name taking into consideration descriptor inheritance to ensure parent descriptors are searched for named FetchGroups.

Lookup the FetchGroup to use given a name and a flag taking into consideration descriptor inheritance to ensure parent descriptors are searched for named and default FetchGroup. This is used to determine the FetchGroup to use in a query's prepare.

Return the fetch group map: keyed by the group name, valued by the fetch group object.

INTERNAL: Returns EntityFetchGroup corresponding to primary key attribute(s).

INTERNAL: Returns EntityFetchGroup corresponding to non relational attributes intersected with defaultFetchGroup.

INTERNAL: Returns EntityFetchGroup corresponding to non relational attributes intersected with defaultFetchGroup.

INTERNAL: Return FetchGroup held by the object.

INTERNAL: Return FetchGroup held by the object.

Return true if a fetch group exists for the given group name.

INTERNAL: Initialize the fetch groups. XXX-dclarke: added support for reinit the query manager's queries if they exist

Return true if the attribute of the object has already been fetched

PUBLIC: Indicates whether the passed fetch group contains all the attributes, no nesting.

PUBLIC: Indicates whether the passed fetch group is minimal.

INTERNAL: Return if the cached object data is sufficiently valid against a fetch group

INTERNAL: Return true if the object is partially fetched and cached. It applies to the query with fetch group.

INTERNAL: postInitialize called for inheritance children first. That allows to copy defaultFetchGroup from the parent only in case it has been set by user (not automatically generated).

PUBLIC: Add primary key and version attributes to the passed fetch group and all the fetch group it contains. Also verifies that all the attributes have corresponding mappings. Could be used for fetch group preparation and validation. Called by ObjectLevelReadQuery prepareFetchgroup method.

INTERNAL: Reset object attributes to the default values.

Set the descriptor-level default fetch group. All read object and read all queries would use the default fetch group if no fetch group is explicitly defined for the query, unless setShouldUseDefaultFetchGroup(false); is also called on the query. Default fetch group should be used carefully. It would be beneficial if most of the system queries are for the subset of the object, so un-needed attributes data would not have to be read, and the users do not have to setup every query for the given fetch group, as default one is always used. However, if queries on object are mostly use case specific and not systematic, using default fetch group could cause undesirable extra round-trip and performance degradation.

See Also

org.eclipse.persistence.queries.ObjectLevelReadQuery#setShouldUseDefaultFetchGroup(boolean)

Set the referenced descriptor.

INTERNAL: Set fetch group into the object.

INTERNAL: Set if the tracked object is fetched from executing a query with or without refresh.

PUBLIC: Set whether defaultFetchGroup should be copied from the parent if not set.

PUBLIC: Indicates whether defaultFetchGroup should be copied from the parent if not set.

INTERNAL: Return true if the cached object data should be written in clone. It is used in Fetch Group case when filling in the clone from the cached object.

INTERNAL: Union the fetch group of the domain object with the new fetch group.

INTERNAL: Union two fetch groups.

INTERNAL: Write data of the partially fetched object into the working and backup clones