Package org.hibernate.metamodel.mapping.internal

Class ManyToManyCollectionPart

java.lang.Object

org.hibernate.metamodel.mapping.internal.AbstractEntityCollectionPart

org.hibernate.metamodel.mapping.internal.ManyToManyCollectionPart

All Implemented Interfaces:

Association, Bindable, CollectionPart, EntityAssociationMapping, EntityValuedModelPart, EntityCollectionPart, JdbcMappingContainer, MappingModelExpressible, ModelPart, ModelPartContainer, SelectableMappings, ValuedModelPart, ValueMapping, TableGroupJoinProducer, TableGroupProducer, EntityValuedFetchable, Fetchable, FetchableContainer, FetchOptions, FetchStyleAccess, FetchTimingAccess, JavaTypedExpressible

public class ManyToManyCollectionPart
extends AbstractEntityCollectionPart
implements EntityAssociationMapping

Entity-valued collection-part mapped through a join table. Models both

• ManyToMany mappings
• OneToMany with JoinTable mappings

``` user( id, ... ) group( id, ... ) membership( user_fk, group_fk ) `Group.membership` table: membership key: group_fk element: user_fk ```

Nested Class Summary

Nested classes/interfaces inherited from interface org.hibernate.metamodel.mapping.Bindable

Bindable.JdbcValuesConsumer

Nested classes/interfaces inherited from interface org.hibernate.metamodel.mapping.CollectionPart

CollectionPart.Nature

Nested classes/interfaces inherited from interface org.hibernate.metamodel.mapping.internal.EntityCollectionPart

EntityCollectionPart.Cardinality

Nested classes/interfaces inherited from interface org.hibernate.metamodel.mapping.ModelPart

ModelPart.IndexedJdbcValueConsumer, ModelPart.JdbcValueConsumer

Constructor Summary

Constructors

Constructor	Description
ManyToManyCollectionPart(CollectionPart.Nature nature, Collection collectionBootDescriptor, CollectionPersister collectionDescriptor, EntityMappingType associatedEntityDescriptor, NotFoundAction notFoundAction, MappingModelCreationProcess creationProcess)
ManyToManyCollectionPart(CollectionPart.Nature nature, Collection collectionBootDescriptor, CollectionPersister collectionDescriptor, EntityMappingType associatedEntityDescriptor, MappingModelCreationProcess creationProcess)

Method Summary

Modifier and Type	Method	Description
void	breakDownJdbcValues(Object domainValue, ModelPart.JdbcValueConsumer valueConsumer, SharedSessionContractImplementor session)
LazyTableGroup	createRootTableGroupJoin(NavigablePath navigablePath, TableGroup lhs, String explicitSourceAlias, SqlAstJoinType requestedJoinType, boolean fetched, Consumer<Predicate> predicateConsumer, SqlAliasBaseGenerator aliasBaseGenerator, SqlExpressionResolver sqlExpressionResolver, FromClauseAccess fromClauseAccess, SqlAstCreationContext creationContext)	Create a TableGroupJoin as defined for this producer, but as root TableGroup.
TableGroupJoin	createTableGroupJoin(NavigablePath navigablePath, TableGroup collectionTableGroup, String explicitSourceAlias, SqlAstJoinType requestedJoinType, boolean fetched, boolean addsPredicate, SqlAliasBaseGenerator aliasBaseGenerator, SqlExpressionResolver sqlExpressionResolver, FromClauseAccess fromClauseAccess, SqlAstCreationContext creationContext)	Create a TableGroupJoin as defined for this producer The sqlAstJoinType may be null to signal that the join is for an implicit path.
void	decompose(Object domainValue, ModelPart.JdbcValueConsumer valueConsumer, SharedSessionContractImplementor session)
ModelPart	findSubPart(String name, EntityMappingType targetType)
boolean	finishInitialization(CollectionPersister collectionDescriptor, Collection bootCollectionDescriptor, String fkTargetModelPartName, MappingModelCreationProcess creationProcess)	Perform any delayed initialization.
int	forEachSelectable(int offset, SelectableConsumer consumer)	Visit each contained selectable mapping.
EntityCollectionPart.Cardinality	getCardinality()
String	getContainingTableExpression()	The table which contains the columns mapped by this value
SqlAstJoinType	getDefaultSqlAstJoinType(TableGroup parentTableGroup)
ForeignKeyDescriptor	getForeignKeyDescriptor()	The descriptor, allowing access to column(s), etc
ModelPart	getInclusionCheckPart()
ModelPart	getKeyTargetMatchPart()	The model sub-part relative to the associated entity type that is the target of this association's foreign-key
SelectableMapping	getSelectable(int columnIndex)	Get the selectable at the given position
ForeignKeyDescriptor.Nature	getSideNature()	Indicates which "side" of the foreign-key this association describes
boolean	hasPartitionedSelectionMapping()
boolean	isFkOptimizationAllowed()
boolean	isReferenceToPrimaryKey()
boolean	isSimpleJoinPredicate(Predicate predicate)	Returns whether the given predicate is a simple join predicate for this attribute.
protected AssociationKey	resolveFetchAssociationKey()

Methods inherited from class org.hibernate.metamodel.mapping.internal.AbstractEntityCollectionPart

containsTableReference, createDomainResult, createTableGroupInternal, findContainingEntityMapping, generateFetch, getAssociatedEntityMappingType, getCollectionDescriptor, getFetchableKey, getFetchableName, getMappedFetchOptions, getMappedType, getNature, getNavigableRole, getNotFoundAction, getNumberOfFetchables, getSqlAliasStem, getStyle, getTargetKeyPropertyNames, getTiming, incrementFetchDepth, isOptional, isUnwrapProxy, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hibernate.metamodel.mapping.Bindable

forEachDisassembledJdbcValue, forEachJdbcType, forEachJdbcValue

Methods inherited from interface org.hibernate.metamodel.mapping.CollectionPart

getPartName

Methods inherited from interface org.hibernate.metamodel.mapping.EntityAssociationMapping

getAssociatedEntityMappingType, getFetchableName, incrementFetchDepth

Methods inherited from interface org.hibernate.metamodel.mapping.internal.EntityCollectionPart

getEntityMappingType, getExpressibleJavaType, getJavaType, getJdbcTypeCount, getPartMappingType

Methods inherited from interface org.hibernate.metamodel.mapping.EntityValuedModelPart

applySqlSelections, applySqlSelections, disassemble, findSubPart, forEachDisassembledJdbcValue, forEachJdbcType, forEachJdbcValue, forEachSubPart, visitSubParts

Methods inherited from interface org.hibernate.sql.results.graph.Fetchable

asAttributeMapping, getFetchableKey, getMappedFetchOptions, resolveCircularFetch

Methods inherited from interface org.hibernate.sql.results.graph.FetchableContainer

getFetchable, getKeyFetchable, getNumberOfFetchableKeys, getNumberOfKeyFetchables, getSelectableIndex, visitFetchables, visitFetchables, visitFetchables, visitKeyFetchables, visitKeyFetchables, visitKeyFetchables

Methods inherited from interface org.hibernate.metamodel.mapping.ModelPart

areEqual, findContainingEntityMapping, getNavigableRole, isVirtual

Methods inherited from interface org.hibernate.metamodel.mapping.ModelPartContainer

findByPath, forEachSubPart

Methods inherited from interface org.hibernate.sql.ast.tree.from.TableGroupJoinProducer

createRootTableGroupJoin, createTableGroupJoin

Methods inherited from interface org.hibernate.sql.ast.tree.from.TableGroupProducer

containsTableReference, getSqlAliasStem

Methods inherited from interface org.hibernate.metamodel.mapping.ValuedModelPart

forEachInsertable, forEachSelectable, forEachUpdatable, getJdbcMappings

Methods inherited from interface org.hibernate.metamodel.mapping.ValueMapping

treatAs

Constructor Detail

ManyToManyCollectionPart

public ManyToManyCollectionPart(CollectionPart.Nature nature,
                                Collection collectionBootDescriptor,
                                CollectionPersister collectionDescriptor,
                                EntityMappingType associatedEntityDescriptor,
                                MappingModelCreationProcess creationProcess)

ManyToManyCollectionPart

public ManyToManyCollectionPart(CollectionPart.Nature nature,
                                Collection collectionBootDescriptor,
                                CollectionPersister collectionDescriptor,
                                EntityMappingType associatedEntityDescriptor,
                                NotFoundAction notFoundAction,
                                MappingModelCreationProcess creationProcess)

Method Detail

getCardinality

public EntityCollectionPart.Cardinality getCardinality()

Specified by:

getCardinality in interface EntityCollectionPart

getInclusionCheckPart

public ModelPart getInclusionCheckPart()

Specified by:

getInclusionCheckPart in interface CollectionPart

resolveFetchAssociationKey

protected AssociationKey resolveFetchAssociationKey()

Specified by:

resolveFetchAssociationKey in class AbstractEntityCollectionPart

findSubPart

public ModelPart findSubPart(String name,
                             EntityMappingType targetType)

Specified by:

findSubPart in interface EntityValuedModelPart

Specified by:

findSubPart in interface ModelPartContainer

breakDownJdbcValues

public void breakDownJdbcValues(Object domainValue,
                                ModelPart.JdbcValueConsumer valueConsumer,
                                SharedSessionContractImplementor session)

Specified by:

breakDownJdbcValues in interface ModelPart

getSelectable

public SelectableMapping getSelectable(int columnIndex)

Description copied from interface: SelectableMappings

Get the selectable at the given position

Specified by:

getSelectable in interface SelectableMappings

getContainingTableExpression

public String getContainingTableExpression()

Description copied from interface: ValuedModelPart

The table which contains the columns mapped by this value

Specified by:

getContainingTableExpression in interface ValuedModelPart

forEachSelectable

public int forEachSelectable(int offset,
                             SelectableConsumer consumer)

Description copied from interface: SelectableMappings

Visit each contained selectable mapping. As the selectables are iterated, we call `SelectionConsumer` passing along `offset` + our current iteration index. The return is the number of selectables we directly contain

Specified by:

forEachSelectable in interface ModelPart

Specified by:

forEachSelectable in interface SelectableMappings

Specified by:

forEachSelectable in interface ValuedModelPart

See Also:

SelectableConsumer.accept(int, SelectableMapping)

decompose

public void decompose(Object domainValue,
                      ModelPart.JdbcValueConsumer valueConsumer,
                      SharedSessionContractImplementor session)

Specified by:

decompose in interface ModelPart

getForeignKeyDescriptor

public ForeignKeyDescriptor getForeignKeyDescriptor()

Description copied from interface: Association

The descriptor, allowing access to column(s), etc

Specified by:

getForeignKeyDescriptor in interface Association

getSideNature

public ForeignKeyDescriptor.Nature getSideNature()

Description copied from interface: Association

Indicates which "side" of the foreign-key this association describes

Specified by:

getSideNature in interface Association

getDefaultSqlAstJoinType

public SqlAstJoinType getDefaultSqlAstJoinType(TableGroup parentTableGroup)

Specified by:

getDefaultSqlAstJoinType in interface TableGroupJoinProducer

isSimpleJoinPredicate

public boolean isSimpleJoinPredicate(Predicate predicate)

Description copied from interface: TableGroupJoinProducer

Returns whether the given predicate is a simple join predicate for this attribute. This is useful to understand if a predicate has additional conjunctions other than the FK related predicate.

Specified by:

isSimpleJoinPredicate in interface TableGroupJoinProducer

isReferenceToPrimaryKey

public boolean isReferenceToPrimaryKey()

Specified by:

isReferenceToPrimaryKey in interface EntityAssociationMapping

isFkOptimizationAllowed

public boolean isFkOptimizationAllowed()

Specified by:

isFkOptimizationAllowed in interface EntityAssociationMapping

getKeyTargetMatchPart

public ModelPart getKeyTargetMatchPart()

Description copied from interface: EntityAssociationMapping

The model sub-part relative to the associated entity type that is the target of this association's foreign-key

Specified by:

getKeyTargetMatchPart in interface EntityAssociationMapping

createTableGroupJoin

public TableGroupJoin createTableGroupJoin(NavigablePath navigablePath,
                                           TableGroup collectionTableGroup,
                                           String explicitSourceAlias,
                                           SqlAstJoinType requestedJoinType,
                                           boolean fetched,
                                           boolean addsPredicate,
                                           SqlAliasBaseGenerator aliasBaseGenerator,
                                           SqlExpressionResolver sqlExpressionResolver,
                                           FromClauseAccess fromClauseAccess,
                                           SqlAstCreationContext creationContext)

Description copied from interface: TableGroupJoinProducer

Create a TableGroupJoin as defined for this producer The sqlAstJoinType may be null to signal that the join is for an implicit path. When addsPredicate is true, the SQM join for the attribute contains an explicit ON clause, and is false otherwise.

Specified by:

createTableGroupJoin in interface TableGroupJoinProducer

createRootTableGroupJoin

public LazyTableGroup createRootTableGroupJoin(NavigablePath navigablePath,
                                               TableGroup lhs,
                                               String explicitSourceAlias,
                                               SqlAstJoinType requestedJoinType,
                                               boolean fetched,
                                               Consumer<Predicate> predicateConsumer,
                                               SqlAliasBaseGenerator aliasBaseGenerator,
                                               SqlExpressionResolver sqlExpressionResolver,
                                               FromClauseAccess fromClauseAccess,
                                               SqlAstCreationContext creationContext)

Description copied from interface: TableGroupJoinProducer

Create a TableGroupJoin as defined for this producer, but as root TableGroup. The main purpose of this is for correlating an association in a subquery i.e. `... alias where exists (select 1 from SomeEntity e where alias.association.attr = 1)`. The sqlAstJoinType may be null to signal that the join is for an implicit path.

Specified by:

createRootTableGroupJoin in interface TableGroupJoinProducer

hasPartitionedSelectionMapping

public boolean hasPartitionedSelectionMapping()

Specified by:

hasPartitionedSelectionMapping in interface ModelPart

finishInitialization

public boolean finishInitialization(CollectionPersister collectionDescriptor,
                                    Collection bootCollectionDescriptor,
                                    String fkTargetModelPartName,
                                    MappingModelCreationProcess creationProcess)

Description copied from interface: EntityCollectionPart

Perform any delayed initialization.

The initialization is considered successful if the result is true. It is considered unsuccessful if the result is false or an exception is thrown. Unsuccessful initializations are generally retried "later", to allow waiting for model-parts being available e.g.

If the exception is something that will just never succeed, consider throwing an exception with the NonTransientException marker to allow the creation process to stop immediately

Specified by:

finishInitialization in interface EntityCollectionPart