java.lang.Object
- org.eclipse.persistence.internal.queries.JoinedAttributeManager

All Implemented Interfaces:

Serializable, Cloneable
```
public class JoinedAttributeManager
extends Object
implements Cloneable, Serializable
```
Purpose: A common class to be used by ObjectLevelReadQueries and ReportItems. This Class will be used to store Joined Attribute Expressions. It will also store the indexes for object construction.

Since:

EJB3.0 RI

Author:

Gordon Yorke

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field	Description
`protected List<Expression>`	`additionalFieldExpressions`
`protected ExpressionBuilder`	`baseExpressionBuilder`	Stores the base builder for resolving joined attributes by name.
`protected ObjectBuildingQuery`	`baseQuery`	Stores the base query.
`protected List<AbstractRecord>`	`dataResults`	Stored all row results to -m joining.
`protected Map<Object,List<AbstractRecord>>`	`dataResultsByPrimaryKey`	Stored all row results to -m joining by cache key.
`protected ClassDescriptor`	`descriptor`	Stores the descriptor that these joins apply on
`protected boolean`	`hasOuterJoinedAttribute`	PERF: Used to avoid null checks for inner attribute joining.
`protected boolean`	`isToManyJoin`	Used to determine if -m joining has been used.
`protected List<DatabaseMapping>`	`joinedAggregateMappings`	Stores AggregateObjectMapping expressions used within local join expressions
`protected List<Expression>`	`joinedAttributeExpressions`	Stores the joined attributes added through the query
`protected List<DatabaseMapping>`	`joinedAttributeMappings`	indexed list of mappings corresponding to
`protected List<Expression>`	`joinedAttributes`	PERF: Cache the local joined attribute expressions.
`protected List<Expression>`	`joinedMappingExpressions`	Stores the joined attributes as specified in the descriptor
`protected Map<DatabaseMapping,Object>`	`joinedMappingIndexes`	Used internally for joining.
`protected Map<DatabaseMapping,ObjectLevelReadQuery>`	`joinedMappingQueries`	Used internally for joining.
`protected Map<DatabaseMapping,ObjectLevelReadQuery>`	`joinedMappingQueryClones`	PERF: Stores the cloned joinedMappingQueries.
`protected Expression`	`lastJoinedAttributeBaseExpression`	Stores the last used base expression while adding joined attribute expression.
`protected List<Expression>`	`orderByExpressions`
`protected int`	`parentResultIndex`	Stores the result index of the parent, used for oneToMany joins.
`protected boolean`	`shouldFilterDuplicates`	Determine if duplicate rows should be filter when using 1-m joining.

Constructor Summary

Constructors
Constructor	Description
`JoinedAttributeManager()`
`JoinedAttributeManager(ClassDescriptor descriptor, ExpressionBuilder baseBuilder, ObjectBuildingQuery baseQuery)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Expression`	`addAndPrepareJoinedMapping(ForeignReferenceMapping mapping, AbstractSession session)`	Add the mapping for join fetch, prepare and return the join expression being used.
`protected Expression`	`addExpressionAndBaseToGroupedList(Expression expression, List expressionlist, Expression lastJoinedAttributeBaseExpression)`	adds expression and its base expressions recursively to the expressionList in groups, so that an expression is never listed before its base expression
`void`	`addJoinedAttribute(Expression attributeExpression)`
`void`	`addJoinedAttributeExpression(Expression attributeExpression)`
`void`	`addJoinedMapping(String attributeName)`	Add an attribute represented by the given attribute name to the list of joins for this query.
`void`	`addJoinedMappingExpression(Expression mappingExpression)`	Add an attribute represented by the given attribute name to the list of joins for this query.
`void`	`clear()`	Clear the joining state.
`void`	`clearDataResults()`	Clear the data-results for joined data for a 1-m join.
`JoinedAttributeManager`	`clone()`	Clones the Joined Attribute Manager.
`protected int`	`computeIndexesForJoinedExpressions(List joinedExpressions, int currentIndex, AbstractSession session)`	This method is used when computing the indexes for joined mappings.
`int`	`computeJoiningMappingIndexes(boolean includeAllSubclassFields, AbstractSession session, int offset)`	For joining the resulting rows include the field/values for many objects.
`void`	`computeJoiningMappingQueries(AbstractSession session)`	Used to optimize joining by pre-computing the nested join queries for the mappings.
`protected void`	`computeNestedQueriesForJoinedExpressions(List joinedExpressions, AbstractSession session, ObjectLevelReadQuery readQuery)`	This method is used when computing the nested queries for joined mappings.
`void`	`copyFrom(JoinedAttributeManager otherJoinManager)`	Copies settings from another manager.
`List<Expression>`	`getAdditionalFieldExpressions()`	Get the list of additional field expressions.
`List<Expression>`	`getAdditionalFieldExpressions_()`	Get the list of additional field expressions.
`ExpressionBuilder`	`getBaseExpressionBuilder()`	Returns the base expression builder for this query.
`ObjectBuildingQuery`	`getBaseQuery()`	Returns the base query.
`List<AbstractRecord>`	`getDataResults_()`	Return all of the rows fetched by the query, used for 1-m joining.
`Map<Object,List<AbstractRecord>>`	`getDataResultsByPrimaryKey()`	Return all of the rows fetched by the query by cache-key, used for 1-m joining.
`ClassDescriptor`	`getDescriptor()`
`List<DatabaseMapping>`	`getJoinedAggregateMappings()`	Return the attributes that must be joined.
`List<Expression>`	`getJoinedAttributeExpressions()`	Return the attributes that must be joined.
`List<DatabaseMapping>`	`getJoinedAttributeMappings()`	Return the attributes that must be joined.
`List<Expression>`	`getJoinedAttributes()`	Return the attributes that must be joined.
`List<Expression>`	`getJoinedMappingExpressions()`	Get the list of expressions that represent elements that are joined because of their mapping for this query.
`Map<DatabaseMapping,Object>`	`getJoinedMappingIndexes_()`	Return the joined mapping indexes, used to compute mapping row partitions.
`Map<DatabaseMapping,ObjectLevelReadQuery>`	`getJoinedMappingQueries_()`	Return the joined mapping queries, used optimize joining, only compute the nested queries once.
`Map<DatabaseMapping,ObjectLevelReadQuery>`	`getJoinedMappingQueryClones()`
`ObjectLevelReadQuery`	`getNestedJoinedMappingQuery(Expression expression)`	INTERNAL: Returns the nested query corresponding to the expression.
`List<Expression>`	`getOrderByExpressions()`	Get the list of orderBy expressions.
`List<Expression>`	`getOrderByExpressions_()`	Get the list of orderBy expressions.
`int`	`getParentResultIndex()`
`Object`	`getValueFromObjectForExpression(AbstractSession session, Object clone, ObjectExpression expression)`	INTERNAL: Helper method to get the value from the clone for the expression passed in, triggering joins on all intermediate steps.
`boolean`	`hasAdditionalFieldExpressions()`	Return if there are additional field expressions.
`boolean`	`hasJoinedAttributeExpressions()`	Return the attributes that must be joined.
`boolean`	`hasJoinedAttributes()`	Return if any attributes are joined.
`boolean`	`hasJoinedExpressions()`	This method checks both attribute expressions and mapping expressions and determines if there are any joins to be made.
`boolean`	`hasJoinedMappingExpressions()`	Return the attributes that must be joined.
`boolean`	`hasOrderByExpressions()`	Return if there are orderBy expressions.
`boolean`	`hasOuterJoinedAttributeQuery()`	PERF: Return if the query uses any outer attribute joins, used to avoid null checks in building objects.
`protected boolean`	`isAttributeExpressionJoined(DatabaseMapping attributeMapping)`	Return if the attribute is specified for joining.
`boolean`	`isAttributeJoined(ClassDescriptor mappingDescriptor, DatabaseMapping attributeMapping)`	Return if the attribute is specified for joining.
`protected boolean`	`isAttributeMappingJoined(DatabaseMapping attributeMapping)`	Return whether the given attribute is joined as a result of a join on a mapping
`protected boolean`	`isAttributeNameInJoinedExpressionList(String attributeName, List joinedExpressionList)`	Iterate through a list of expressions searching for the given attribute name.
`protected boolean`	`isMappingInJoinedExpressionList(DatabaseMapping attributeMapping, List joinedExpressionList)`	Iterate through a list of expressions searching for the given attribute name.
`boolean`	`isToManyJoin()`	Return if the query uses any -m joins, and thus return duplicate/multiple rows.
`protected Expression`	`prepareJoinExpression(Expression expression, AbstractSession session)`	Validate and prepare the join expression.
`void`	`prepareJoinExpressions(AbstractSession session)`	Validate and prepare join expressions.
`AbstractRecord`	`processDataResults(AbstractRecord row, Cursor cursor, boolean forward)`	Process the data-results for joined data for a 1-m join.
`protected void`	`processDataResults(AbstractSession session)`	Process the data-results for joined data for a 1-m join.
`void`	`processJoinedMappings(AbstractSession session)`	This method collects the Joined Mappings from the descriptor and initializes them.
`void`	`reset()`	Reset the JoinedAttributeManager.
`void`	`setAdditionalFieldExpressions_(List<Expression> expressions)`	Set the list of additional field expressions.
`protected void`	`setBaseExpressionBuilder(ExpressionBuilder builder)`	This method is called from within this package, it is used when initializing a ReportItem
`void`	`setBaseQuery(ObjectLevelReadQuery query)`	This method is called from within this package it is used when initializing a report Item
`void`	`setDataResults(List dataResults, AbstractSession session)`	Set all of the rows fetched by the query, used for 1-m joining.
`protected void`	`setDataResultsByPrimaryKey(Map<Object,List<AbstractRecord>> dataResultsByPrimaryKey)`	Set all of the rows fetched by the query by cache-key, used for 1-m joining.
`void`	`setDescriptor(ClassDescriptor descriptor)`	Called to set the descriptor on a Join Managerwith in a ReportItem, durring initialization, and durring DatabaseQuery.checkDescriptor.
`protected void`	`setIsOuterJoinedAttributeQuery(boolean isOuterJoinedAttribute)`	PERF: Set if the query uses any outer attribute joins, used to avoid null checks in building objects.
`void`	`setIsToManyJoinQuery(boolean isToManyJoin)`	Set if the query uses any -m joins, and thus return duplicate/multiple rows.
`void`	`setJoinedAttributeExpressions_(List joinedExpressions)`	Set the list of expressions that represent elements that are joined because of their mapping for this query.
`void`	`setJoinedMappingExpressions_(List joinedMappingExpressions)`	Set the list of expressions that represent elements that are joined because of their mapping for this query.
`void`	`setJoinedMappingIndexes_(Map joinedMappingIndexes)`	Set the joined mapping indexes, used to compute mapping row partitions.
`void`	`setJoinedMappingQueries_(Map joinedMappingQueries)`	Set the joined mapping queries, used optimize joining, only compute the nested queries once.
`void`	`setJoinedMappingQueryClones(Map joinedMappingQueryClones)`
`void`	`setOrderByExpressions_(List<Expression> expressions)`	Set the list of orderBy expressions.
`void`	`setParentResultIndex(int parentsResultIndex)`
`void`	`setShouldFilterDuplicates(boolean shouldFilterDuplicates)`	Set if duplicate rows should be filter when using 1-m joining.
`ForUpdateOfClause`	`setupLockingClauseForJoinedExpressions(ForUpdateOfClause lockingClause, AbstractSession session)`	Used for joining in conjunction with pessimistic locking.
`boolean`	`shouldFilterDuplicates()`	Return if duplicate rows should be filter when using 1-m joining.

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - joinedAggregateMappings
```
protected transient List<DatabaseMapping> joinedAggregateMappings
```
    Stores AggregateObjectMapping expressions used within local join expressions
  - joinedAttributeMappings
```
protected transient List<DatabaseMapping> joinedAttributeMappings
```
    indexed list of mappings corresponding to
  - joinedAttributeExpressions
```
protected List<Expression> joinedAttributeExpressions
```
    Stores the joined attributes added through the query
  - joinedMappingExpressions
```
protected List<Expression> joinedMappingExpressions
```
    Stores the joined attributes as specified in the descriptor
  - joinedAttributes
```
protected List<Expression> joinedAttributes
```
    PERF: Cache the local joined attribute expressions.
  - isToManyJoin
```
protected boolean isToManyJoin
```
    Used to determine if -m joining has been used.
  - hasOuterJoinedAttribute
```
protected boolean hasOuterJoinedAttribute
```
    PERF: Used to avoid null checks for inner attribute joining.
  - joinedMappingIndexes
```
protected transient Map<DatabaseMapping,Object> joinedMappingIndexes
```
    Used internally for joining.
  - joinedMappingQueries
```
protected transient Map<DatabaseMapping,ObjectLevelReadQuery> joinedMappingQueries
```
    Used internally for joining.
  - joinedMappingQueryClones
```
protected transient Map<DatabaseMapping,ObjectLevelReadQuery> joinedMappingQueryClones
```
    PERF: Stores the cloned joinedMappingQueries.
  - dataResults
```
protected transient List<AbstractRecord> dataResults
```
    Stored all row results to -m joining.
  - dataResultsByPrimaryKey
```
protected transient Map<Object,List<AbstractRecord>> dataResultsByPrimaryKey
```
    Stored all row results to -m joining by cache key.
  - descriptor
```
protected transient ClassDescriptor descriptor
```
    Stores the descriptor that these joins apply on
  - baseExpressionBuilder
```
protected ExpressionBuilder baseExpressionBuilder
```
    Stores the base builder for resolving joined attributes by name.
  - lastJoinedAttributeBaseExpression
```
protected Expression lastJoinedAttributeBaseExpression
```
    Stores the last used base expression while adding joined attribute expression.
  - baseQuery
```
protected ObjectBuildingQuery baseQuery
```
    Stores the base query.
  - parentResultIndex
```
protected int parentResultIndex
```
    Stores the result index of the parent, used for oneToMany joins.
  - shouldFilterDuplicates
```
protected boolean shouldFilterDuplicates
```
    Determine if duplicate rows should be filter when using 1-m joining.
  - orderByExpressions
```
protected transient List<Expression> orderByExpressions
```
  - additionalFieldExpressions
```
protected transient List<Expression> additionalFieldExpressions
```
- Constructor Detail
  - JoinedAttributeManager
```
public JoinedAttributeManager()
```
  - JoinedAttributeManager
```
public JoinedAttributeManager(ClassDescriptor descriptor,
                              ExpressionBuilder baseBuilder,
                              ObjectBuildingQuery baseQuery)
```
- Method Detail
  - shouldFilterDuplicates
```
public boolean shouldFilterDuplicates()
```
    Return if duplicate rows should be filter when using 1-m joining.
  - setShouldFilterDuplicates
```
public void setShouldFilterDuplicates(boolean shouldFilterDuplicates)
```
    Set if duplicate rows should be filter when using 1-m joining.
  - addJoinedAttribute
```
public void addJoinedAttribute(Expression attributeExpression)
```
  - addJoinedAttributeExpression
```
public void addJoinedAttributeExpression(Expression attributeExpression)
```
  - addJoinedMappingExpression
```
public void addJoinedMappingExpression(Expression mappingExpression)
```
    Add an attribute represented by the given attribute name to the list of joins for this query. Note: Mapping level joins are represented separately from query level joins.
  - addJoinedMapping
```
public void addJoinedMapping(String attributeName)
```
    Add an attribute represented by the given attribute name to the list of joins for this query. Note: Mapping level joins are represented separately from query level joins.
  - clone
```
public JoinedAttributeManager clone()
```
    Clones the Joined Attribute Manager. Generally called from Query.clone().
    
    Overrides:
    
    clone in class Object
  - copyFrom
```
public void copyFrom(JoinedAttributeManager otherJoinManager)
```
    Copies settings from another manager. Should copy all the attributes that clone method clones.
  - clear
```
public void clear()
```
    Clear the joining state. This is used to redefine a queries joins for nested joins.
  - computeJoiningMappingIndexes
```
public int computeJoiningMappingIndexes(boolean includeAllSubclassFields,
                                        AbstractSession session,
                                        int offset)
```
    For joining the resulting rows include the field/values for many objects. As some of the objects may have the same field names, these row partitions need to be calculated. The indexes are stored in the query and used later when building the objects.
  - computeNestedQueriesForJoinedExpressions
```
protected void computeNestedQueriesForJoinedExpressions(List joinedExpressions,
                                                        AbstractSession session,
                                                        ObjectLevelReadQuery readQuery)
```
    This method is used when computing the nested queries for joined mappings. It recurses computing the nested mapping queries and their join indexes.
  - computeJoiningMappingQueries
```
public void computeJoiningMappingQueries(AbstractSession session)
```
    Used to optimize joining by pre-computing the nested join queries for the mappings.
  - computeIndexesForJoinedExpressions
```
protected int computeIndexesForJoinedExpressions(List joinedExpressions,
                                                 int currentIndex,
                                                 AbstractSession session)
```
    This method is used when computing the indexes for joined mappings. It iterates through a list of join expressions and adds an index that represents where the fields represented by that expression will appear in the row returned by a read query. Method computeNestedQueriesForJoinedExpressions(List, AbstractSession, ObjectLevelReadQuery) must be already called.
    
    Parameters:
    
    joinedExpressions - Join expressions List.
    
    currentIndex - Current joined mapping index.
    
    session - Current session.
    
    Returns:
    
    Current joined mapping index updated.
  - getAdditionalFieldExpressions
```
public List<Expression> getAdditionalFieldExpressions()
```
    Get the list of additional field expressions.
  - getAdditionalFieldExpressions_
```
public List<Expression> getAdditionalFieldExpressions_()
```
    Get the list of additional field expressions.
  - getBaseExpressionBuilder
```
public ExpressionBuilder getBaseExpressionBuilder()
```
    Returns the base expression builder for this query.
  - getBaseQuery
```
public ObjectBuildingQuery getBaseQuery()
```
    Returns the base query.
  - getDataResults_
```
public List<AbstractRecord> getDataResults_()
```
    Return all of the rows fetched by the query, used for 1-m joining.
  - getDescriptor
```
public ClassDescriptor getDescriptor()
```
  - hasAdditionalFieldExpressions
```
public boolean hasAdditionalFieldExpressions()
```
    Return if there are additional field expressions.
  - setAdditionalFieldExpressions_
```
public void setAdditionalFieldExpressions_(List<Expression> expressions)
```
    Set the list of additional field expressions.
  - getJoinedAggregateMappings
```
public List<DatabaseMapping> getJoinedAggregateMappings()
```
    Return the attributes that must be joined.
  - getJoinedAttributeExpressions
```
public List<Expression> getJoinedAttributeExpressions()
```
    Return the attributes that must be joined.
  - getJoinedAttributeMappings
```
public List<DatabaseMapping> getJoinedAttributeMappings()
```
    Return the attributes that must be joined.
  - getJoinedAttributes
```
public List<Expression> getJoinedAttributes()
```
    Return the attributes that must be joined.
  - getJoinedMappingExpressions
```
public List<Expression> getJoinedMappingExpressions()
```
    Get the list of expressions that represent elements that are joined because of their mapping for this query.
  - hasJoinedAttributeExpressions
```
public boolean hasJoinedAttributeExpressions()
```
    Return the attributes that must be joined.
  - hasJoinedExpressions
```
public boolean hasJoinedExpressions()
```
    This method checks both attribute expressions and mapping expressions and determines if there are any joins to be made.
  - hasJoinedMappingExpressions
```
public boolean hasJoinedMappingExpressions()
```
    Return the attributes that must be joined.
  - hasJoinedAttributes
```
public boolean hasJoinedAttributes()
```
    Return if any attributes are joined. This is a convience method that is only valid after prepare.
  - hasOuterJoinedAttributeQuery
```
public boolean hasOuterJoinedAttributeQuery()
```
    PERF: Return if the query uses any outer attribute joins, used to avoid null checks in building objects.
  - getOrderByExpressions
```
public List<Expression> getOrderByExpressions()
```
    Get the list of orderBy expressions.
  - getOrderByExpressions_
```
public List<Expression> getOrderByExpressions_()
```
    Get the list of orderBy expressions.
  - getValueFromObjectForExpression
```
public Object getValueFromObjectForExpression(AbstractSession session,
                                              Object clone,
                                              ObjectExpression expression)
```
    INTERNAL: Helper method to get the value from the clone for the expression passed in, triggering joins on all intermediate steps. Example expression "emp.project.pk" with a clone Employee will trigger indirection and return the project pk value.
  - hasOrderByExpressions
```
public boolean hasOrderByExpressions()
```
    Return if there are orderBy expressions.
  - setOrderByExpressions_
```
public void setOrderByExpressions_(List<Expression> expressions)
```
    Set the list of orderBy expressions.
  - isToManyJoin
```
public boolean isToManyJoin()
```
    Return if the query uses any -m joins, and thus return duplicate/multiple rows.
  - isAttributeJoined
```
public boolean isAttributeJoined(ClassDescriptor mappingDescriptor,
                                 DatabaseMapping attributeMapping)
```
    Return if the attribute is specified for joining.
  - isMappingInJoinedExpressionList
```
protected boolean isMappingInJoinedExpressionList(DatabaseMapping attributeMapping,
                                                  List joinedExpressionList)
```
    Iterate through a list of expressions searching for the given attribute name. Return true if it is found, false otherwise. Only use if the query was preprepared so that join expressions were processed.
  - isAttributeNameInJoinedExpressionList
```
protected boolean isAttributeNameInJoinedExpressionList(String attributeName,
                                                        List joinedExpressionList)
```
    Iterate through a list of expressions searching for the given attribute name. Return true if it is found, false otherwise.
  - isAttributeExpressionJoined
```
protected boolean isAttributeExpressionJoined(DatabaseMapping attributeMapping)
```
    Return if the attribute is specified for joining.
  - isAttributeMappingJoined
```
protected boolean isAttributeMappingJoined(DatabaseMapping attributeMapping)
```
    Return whether the given attribute is joined as a result of a join on a mapping
  - setJoinedAttributeExpressions_
```
public void setJoinedAttributeExpressions_(List joinedExpressions)
```
    Set the list of expressions that represent elements that are joined because of their mapping for this query.
  - setJoinedMappingExpressions_
```
public void setJoinedMappingExpressions_(List joinedMappingExpressions)
```
    Set the list of expressions that represent elements that are joined because of their mapping for this query.
  - getJoinedMappingIndexes_
```
public Map<DatabaseMapping,Object> getJoinedMappingIndexes_()
```
    Return the joined mapping indexes, used to compute mapping row partitions.
  - getJoinedMappingQueries_
```
public Map<DatabaseMapping,ObjectLevelReadQuery> getJoinedMappingQueries_()
```
    Return the joined mapping queries, used optimize joining, only compute the nested queries once.
  - getNestedJoinedMappingQuery
```
public ObjectLevelReadQuery getNestedJoinedMappingQuery(Expression expression)
```
    INTERNAL: Returns the nested query corresponding to the expression. The passed expression should be either join mapping or joined attribute expression.
  - setJoinedMappingQueries_
```
public void setJoinedMappingQueries_(Map joinedMappingQueries)
```
    Set the joined mapping queries, used optimize joining, only compute the nested queries once.
  - setJoinedMappingIndexes_
```
public void setJoinedMappingIndexes_(Map joinedMappingIndexes)
```
    Set the joined mapping indexes, used to compute mapping row partitions.
  - setIsOuterJoinedAttributeQuery
```
protected void setIsOuterJoinedAttributeQuery(boolean isOuterJoinedAttribute)
```
    PERF: Set if the query uses any outer attribute joins, used to avoid null checks in building objects.
  - setIsToManyJoinQuery
```
public void setIsToManyJoinQuery(boolean isToManyJoin)
```
    Set if the query uses any -m joins, and thus return duplicate/multiple rows.
  - prepareJoinExpressions
```
public void prepareJoinExpressions(AbstractSession session)
```
    Validate and prepare join expressions.
  - addExpressionAndBaseToGroupedList
```
protected Expression addExpressionAndBaseToGroupedList(Expression expression,
                                                       List expressionlist,
                                                       Expression lastJoinedAttributeBaseExpression)
```
    adds expression and its base expressions recursively to the expressionList in groups, so that an expression is never listed before its base expression
  - prepareJoinExpression
```
protected Expression prepareJoinExpression(Expression expression,
                                           AbstractSession session)
```
    Validate and prepare the join expression.
  - processJoinedMappings
```
public void processJoinedMappings(AbstractSession session)
```
    This method collects the Joined Mappings from the descriptor and initializes them. Excludes the mapping that are not in the passed mappingsAllowedToJoin set (if it's not null).
  - addAndPrepareJoinedMapping
```
public Expression addAndPrepareJoinedMapping(ForeignReferenceMapping mapping,
                                             AbstractSession session)
```
    Add the mapping for join fetch, prepare and return the join expression being used.
  - reset
```
public void reset()
```
    Reset the JoinedAttributeManager. This will be called when the Query is re-prepared
  - setBaseQuery
```
public void setBaseQuery(ObjectLevelReadQuery query)
```
    This method is called from within this package it is used when initializing a report Item
  - setBaseExpressionBuilder
```
protected void setBaseExpressionBuilder(ExpressionBuilder builder)
```
    This method is called from within this package, it is used when initializing a ReportItem
  - getDataResultsByPrimaryKey
```
public Map<Object,List<AbstractRecord>> getDataResultsByPrimaryKey()
```
    Return all of the rows fetched by the query by cache-key, used for 1-m joining.
  - setDataResultsByPrimaryKey
```
protected void setDataResultsByPrimaryKey(Map<Object,List<AbstractRecord>> dataResultsByPrimaryKey)
```
    Set all of the rows fetched by the query by cache-key, used for 1-m joining.
  - setDataResults
```
public void setDataResults(List dataResults,
                           AbstractSession session)
```
    Set all of the rows fetched by the query, used for 1-m joining.
  - processDataResults
```
protected void processDataResults(AbstractSession session)
```
    Process the data-results for joined data for a 1-m join. This allows all the data to be processed once, instead of n times for each object.
  - clearDataResults
```
public void clearDataResults()
```
    Clear the data-results for joined data for a 1-m join.
  - processDataResults
```
public AbstractRecord processDataResults(AbstractRecord row,
                                         Cursor cursor,
                                         boolean forward)
```
    Process the data-results for joined data for a 1-m join. This allows incremental processing for a cursor.
  - setDescriptor
```
public void setDescriptor(ClassDescriptor descriptor)
```
    Called to set the descriptor on a Join Managerwith in a ReportItem, durring initialization, and durring DatabaseQuery.checkDescriptor.
  - setupLockingClauseForJoinedExpressions
```
public ForUpdateOfClause setupLockingClauseForJoinedExpressions(ForUpdateOfClause lockingClause,
                                                                AbstractSession session)
```
    Used for joining in conjunction with pessimistic locking. Iterate through a list of joined expressions and ensure expression is set on the locking clause for each expression that represents a pessimisically locked descriptor.
  - setParentResultIndex
```
public void setParentResultIndex(int parentsResultIndex)
```
  - getParentResultIndex
```
public int getParentResultIndex()
```
  - getJoinedMappingQueryClones
```
public Map<DatabaseMapping,ObjectLevelReadQuery> getJoinedMappingQueryClones()
```
  - setJoinedMappingQueryClones
```
public void setJoinedMappingQueryClones(Map joinedMappingQueryClones)
```

Class JoinedAttributeManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

joinedAggregateMappings

joinedAttributeMappings

joinedAttributeExpressions

joinedMappingExpressions

joinedAttributes

isToManyJoin

hasOuterJoinedAttribute

joinedMappingIndexes

joinedMappingQueries

joinedMappingQueryClones

dataResults

dataResultsByPrimaryKey

descriptor

baseExpressionBuilder

lastJoinedAttributeBaseExpression

baseQuery

parentResultIndex

shouldFilterDuplicates

orderByExpressions

additionalFieldExpressions

Constructor Detail

JoinedAttributeManager

JoinedAttributeManager

Method Detail

shouldFilterDuplicates

setShouldFilterDuplicates

addJoinedAttribute

addJoinedAttributeExpression

addJoinedMappingExpression

addJoinedMapping

clone

copyFrom

clear

computeJoiningMappingIndexes

computeNestedQueriesForJoinedExpressions

computeJoiningMappingQueries

computeIndexesForJoinedExpressions

getAdditionalFieldExpressions

getAdditionalFieldExpressions_

getBaseExpressionBuilder

getBaseQuery

getDataResults_

getDescriptor

hasAdditionalFieldExpressions

setAdditionalFieldExpressions_

getJoinedAggregateMappings

getJoinedAttributeExpressions

getJoinedAttributeMappings

getJoinedAttributes

getJoinedMappingExpressions

hasJoinedAttributeExpressions

hasJoinedExpressions

hasJoinedMappingExpressions

hasJoinedAttributes

hasOuterJoinedAttributeQuery

getOrderByExpressions

getOrderByExpressions_

getValueFromObjectForExpression

hasOrderByExpressions

setOrderByExpressions_

isToManyJoin

isAttributeJoined

isMappingInJoinedExpressionList

isAttributeNameInJoinedExpressionList

isAttributeExpressionJoined

isAttributeMappingJoined

setJoinedAttributeExpressions_

setJoinedMappingExpressions_

getJoinedMappingIndexes_

getJoinedMappingQueries_

getNestedJoinedMappingQuery

setJoinedMappingQueries_

setJoinedMappingIndexes_

setIsOuterJoinedAttributeQuery