Module org.eclipse.persistence.core

Package org.eclipse.persistence.queries

Class AttributeGroup

java.lang.Object

org.eclipse.persistence.core.queries.CoreAttributeGroup<AttributeItem,ClassDescriptor>

org.eclipse.persistence.queries.AttributeGroup

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

CopyGroup, FetchGroup, LoadGroup

public class AttributeGroup
extends CoreAttributeGroup<AttributeItem,ClassDescriptor>
implements Serializable, Cloneable

Purpose: An AttributeGroup represents a set of mappings and nested AttributeGroups for relationship mappings for an entity type. Responsibilities:

• Defines which attributes should be fetched from the database within a FetchGroup.
• Define which relationship attributes should be populated in a resulting entity graph within a LoadGroup
• Define which attributes should be copied within a CopyGroup

To reference nested attributes a dot ('.') notation is used to reference related attributes. All attribute names provided are assumed to be correct until processed against the mappings during usage of the group.

Since:

EclipseLink 2.1

See Also:

• FetchGroup
• LoadGroup
• CopyGroup
• Serialized Form

Field Summary

Fields inherited from class org.eclipse.persistence.core.queries.CoreAttributeGroup

allsubclasses, isValidated, items, name, subClasses, superClassGroup, type, typeName

Constructor Summary

Constructors

Constructor	Description
AttributeGroup()
AttributeGroup(String name)
AttributeGroup(String name, Class<?> type, boolean isValidated)	INTERNAL: This constructer is to only be used by EclipseLink internally
AttributeGroup(String name, String type, boolean isValidated)

Method Summary

Modifier and Type	Method	Description
void	addAttribute(String attributeNameOrPath, AttributeGroup group)	Add a basic attribute or nested attribute with each String representing an attribute on the path to what needs to be included in the AttributeGroup.
AttributeGroup	clone()
AttributeGroup	findGroup(ClassDescriptor type)
AttributeGroup	getGroup(String attributeNameOrPath)	Returns AttributeGroup corresponding to the passed (possibly nested) attribute.
AttributeItem	getItem(String attributeNameOrPath)	INTERNAL: Lookup the AttributeItemfor the provided attribute name or path.
boolean	isConcurrent()	INTERNAL: Only LoadGroups allow concurrency.
boolean	isCopyGroup()	INTERNAL: This method is used internally when converting to a copy group.
boolean	isLoadGroup()
boolean	isSupersetOf(AttributeGroup anotherGroup)	Return true if this AttributeGroup is a super-set of the passed in AttributeGroup.
protected AttributeGroup	newGroup(String name, CoreAttributeGroup parent)	Subclass may create different types.
protected AttributeItem	newItem(CoreAttributeGroup group, String attrName)	Subclass may create different types.
protected AttributeItem	newItem(AttributeGroup group, String attrName)	Subclass may create different types.
CopyGroup	toCopyGroup()	Convert the group to a CopyGroup for usage with the copy() API.
CopyGroup	toCopyGroup(Map<AttributeGroup,CopyGroup> cloneMap, Map copies)	INTERNAL: This method is used internally when converting to a copy group.
FetchGroup	toFetchGroup()	Convert the group to a FetchGroup for usage with queries.
FetchGroup	toFetchGroup(Map<AttributeGroup,FetchGroup> cloneMap)	INTERNAL: This method is used internally when converting to a copy group.
LoadGroup	toLoadGroup()	Convert the group to a LoadGroup for usage with queries.
LoadGroup	toLoadGroup(Map<AttributeGroup,LoadGroup> cloneMap, boolean loadOnly)

Methods inherited from class org.eclipse.persistence.core.queries.CoreAttributeGroup

addAttribute, addAttribute, addAttribute, addAttributeKey, addAttributes, clone, containsAttribute, containsAttributeInternal, convert, convertClassNamesToClasses, equals, getAllItems, getAttributeNames, getItem, getItems, getName, getSubClassGroups, getType, getTypeName, hashCode, hasInheritance, hasItems, insertSubClass, isFetchGroup, isSupersetOf, isValidated, removeAttribute, setAllSubclasses, setAttributeNames, setName, toString, toStringAdditionalInfo, toStringItems, toStringPath

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

AttributeGroup

public AttributeGroup(String name)

AttributeGroup

public AttributeGroup(String name,
 Class<?> type,
 boolean isValidated)

INTERNAL: This constructer is to only be used by EclipseLink internally

AttributeGroup

public AttributeGroup(String name,
 String type,
 boolean isValidated)

AttributeGroup

public AttributeGroup()

Method Details

addAttribute

public void addAttribute(String attributeNameOrPath,
 AttributeGroup group)

Add a basic attribute or nested attribute with each String representing an attribute on the path to what needs to be included in the AttributeGroup.

Example: group.addAttribute("firstName", group1);
group.addAttribute("manager.address", group2); Note that existing group corresponding to attributeNameOrPath will be overridden with the passed group.

Parameters:

attributeNameOrPath - A simple attribute, array or attributes forming a path

group - - an AttributeGroup to be added.

getGroup

public AttributeGroup getGroup(String attributeNameOrPath)

Returns AttributeGroup corresponding to the passed (possibly nested) attribute.

Overrides:

getGroup in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

isSupersetOf

public boolean isSupersetOf(AttributeGroup anotherGroup)

Return true if this AttributeGroup is a super-set of the passed in AttributeGroup.

getItem

public AttributeItem getItem(String attributeNameOrPath)

INTERNAL: Lookup the AttributeItemfor the provided attribute name or path.

Overrides:

getItem in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

Returns:

item or null

Throws:

IllegalArgumentException - if name is not valid attribute name or path

newItem

protected AttributeItem newItem(AttributeGroup group,
 String attrName)

Subclass may create different types.

findGroup

public AttributeGroup findGroup(ClassDescriptor type)

Overrides:

findGroup in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

toFetchGroup

public FetchGroup toFetchGroup()

Convert the group to a FetchGroup for usage with queries.

toFetchGroup

public FetchGroup toFetchGroup(Map<AttributeGroup,FetchGroup> cloneMap)

INTERNAL: This method is used internally when converting to a copy group.

isCopyGroup

public boolean isCopyGroup()

INTERNAL: This method is used internally when converting to a copy group.

Overrides:

isCopyGroup in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

toCopyGroup

public CopyGroup toCopyGroup()

Convert the group to a CopyGroup for usage with the copy() API.

toCopyGroup

public CopyGroup toCopyGroup(Map<AttributeGroup,CopyGroup> cloneMap,
 Map copies)

INTERNAL: This method is used internally when converting to a copy group.

isLoadGroup

public boolean isLoadGroup()

Overrides:

isLoadGroup in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

toLoadGroup

public LoadGroup toLoadGroup()

Convert the group to a LoadGroup for usage with queries.

toLoadGroup

public LoadGroup toLoadGroup(Map<AttributeGroup,LoadGroup> cloneMap,
 boolean loadOnly)

clone

public AttributeGroup clone()

Overrides:

clone in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

isConcurrent

public boolean isConcurrent()

INTERNAL: Only LoadGroups allow concurrency.

Overrides:

isConcurrent in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

newItem

protected AttributeItem newItem(CoreAttributeGroup group,
 String attrName)

Subclass may create different types.

Overrides:

newItem in class CoreAttributeGroup<AttributeItem,ClassDescriptor>

newGroup

protected AttributeGroup newGroup(String name,
 CoreAttributeGroup parent)

Subclass may create different types.

Overrides:

newGroup in class CoreAttributeGroup<AttributeItem,ClassDescriptor>