Package org.hibernate.sql.ast.tree.from
Class LazyTableGroup
java.lang.Object
org.hibernate.sql.ast.tree.from.DelegatingTableGroup
org.hibernate.sql.ast.tree.from.LazyTableGroup
- All Implemented Interfaces:
DomainResultProducer
,SqmPathInterpretation
,SqlSelectionProducer
,Expression
,ColumnReferenceQualifier
,TableGroup
,SqlAstNode
The purpose of this table group is to defer creating the actual table group until it is really needed.
If it is not needed, we can safely skip rendering it. This is useful for ToOneAttributeMapping and EntityCollectionPart,
where we need a table group for the association, but aren't sure which columns are needed yet.
Deferring initialization enables getting away with fewer joins in case only foreign key columns are used.
-
Nested Class Summary
Nested Classes -
Constructor Summary
ConstructorsConstructorDescriptionLazyTableGroup
(boolean canUseInnerJoins, NavigablePath navigablePath, boolean fetched, Supplier<TableGroup> tableGroupSupplier, LazyTableGroup.ParentTableGroupUseChecker parentTableGroupUseChecker, TableGroupProducer tableGroupProducer, String sourceAlias, SqlAliasBase sqlAliasBase, SessionFactoryImplementor sessionFactory, TableGroup parentTableGroup) -
Method Summary
Modifier and TypeMethodDescriptionvoid
A nested table group join is a join against a table group, that is ensured to be joined against the primary table reference and table reference joins in isolation, prior to doing other table group joins e.g.void
void
applyAffectedTableNames
(Consumer<String> nameCollector) boolean
The type for this expressionIf we want to use CTE for TableGroup rendering we will need to know the alias we can use for the groupgetTableReference
(NavigablePath navigablePath, String tableExpression, boolean resolve) Returns the table reference for the table expression, or null if not found.getTableReference
(NavigablePath navigablePath, ValuedModelPart modelPart, String tableExpression, boolean resolve) boolean
boolean
If this is a lazy table group, it may report that it is not initialized, which would also mean that a join referring to this table group should not be rendered.boolean
boolean
void
setTableGroupInitializerCallback
(Consumer<TableGroup> tableGroupConsumer) void
visitNestedTableGroupJoins
(Consumer<TableGroupJoin> consumer) void
visitTableGroupJoins
(Consumer<TableGroupJoin> consumer) Methods inherited from class org.hibernate.sql.ast.tree.from.DelegatingTableGroup
accept, applySqlSelections, createDomainResult, createSqlSelection, getColumnReference, getPrimaryTableReference, getSqlExpression, prependTableGroupJoin
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.hibernate.sql.ast.tree.from.ColumnReferenceQualifier
getTableReference, getTableReference, resolveTableReference, resolveTableReference, resolveTableReference
Methods inherited from interface org.hibernate.sql.ast.tree.expression.Expression
createDomainResultSqlSelection
Methods inherited from interface org.hibernate.sql.ast.tree.from.TableGroup
findCompatibleJoin, findCompatibleJoinedGroup, findTableGroupJoin, findTableReference, hasRealJoins, isVirtual
-
Constructor Details
-
Method Details
-
isInitialized
public boolean isInitialized()Description copied from interface:TableGroup
If this is a lazy table group, it may report that it is not initialized, which would also mean that a join referring to this table group should not be rendered.- Specified by:
isInitialized
in interfaceTableGroup
- Overrides:
isInitialized
in classDelegatingTableGroup
-
getUnderlyingTableGroup
-
getTableGroup
- Specified by:
getTableGroup
in classDelegatingTableGroup
-
setTableGroupInitializerCallback
-
applyAffectedTableNames
- Specified by:
applyAffectedTableNames
in interfaceTableGroup
- Overrides:
applyAffectedTableNames
in classDelegatingTableGroup
-
getTableReferenceJoins
- Specified by:
getTableReferenceJoins
in interfaceTableGroup
- Overrides:
getTableReferenceJoins
in classDelegatingTableGroup
-
getTableGroupJoins
- Specified by:
getTableGroupJoins
in interfaceTableGroup
- Overrides:
getTableGroupJoins
in classDelegatingTableGroup
-
getNestedTableGroupJoins
- Specified by:
getNestedTableGroupJoins
in interfaceTableGroup
- Overrides:
getNestedTableGroupJoins
in classDelegatingTableGroup
-
addTableGroupJoin
- Specified by:
addTableGroupJoin
in interfaceTableGroup
- Overrides:
addTableGroupJoin
in classDelegatingTableGroup
-
addNestedTableGroupJoin
Description copied from interface:TableGroup
A nested table group join is a join against a table group, that is ensured to be joined against the primary table reference and table reference joins in isolation, prior to doing other table group joins e.g.select * from entity1 e left join ( collection_table c1 join association a on a.id = c1.target_id ) on c1.entity_id = e.id and c1.key = 1
is modeled asTableGroup( primaryTableReference = TableReference(entity1, e), tableGroupJoins = [ TableGroupJoin( TableGroup( primaryTableReference = TableReference(collection_table, c1), nestedTableGroupJoins = [ TableGroupJoin( TableGroup( primaryTableReference = TableReference(association, a) ) ) ] ) ) ] )
This is necessary to correctly retain the cardinality of an HQL join like e.g.from Entity1 e left join e.collectionAssociation c on key(c) = 1
- Specified by:
addNestedTableGroupJoin
in interfaceTableGroup
- Overrides:
addNestedTableGroupJoin
in classDelegatingTableGroup
-
visitTableGroupJoins
- Specified by:
visitTableGroupJoins
in interfaceTableGroup
- Overrides:
visitTableGroupJoins
in classDelegatingTableGroup
-
visitNestedTableGroupJoins
- Specified by:
visitNestedTableGroupJoins
in interfaceTableGroup
- Overrides:
visitNestedTableGroupJoins
in classDelegatingTableGroup
-
canUseInnerJoins
public boolean canUseInnerJoins()- Specified by:
canUseInnerJoins
in interfaceTableGroup
- Overrides:
canUseInnerJoins
in classDelegatingTableGroup
-
getGroupAlias
Description copied from interface:TableGroup
If we want to use CTE for TableGroup rendering we will need to know the alias we can use for the group- Specified by:
getGroupAlias
in interfaceTableGroup
- Overrides:
getGroupAlias
in classDelegatingTableGroup
-
getModelPart
- Specified by:
getModelPart
in interfaceTableGroup
- Overrides:
getModelPart
in classDelegatingTableGroup
-
getExpressionType
Description copied from interface:Expression
The type for this expression- Specified by:
getExpressionType
in interfaceExpression
- Specified by:
getExpressionType
in interfaceSqmPathInterpretation
- Overrides:
getExpressionType
in classDelegatingTableGroup
-
getSourceAlias
- Specified by:
getSourceAlias
in interfaceTableGroup
- Overrides:
getSourceAlias
in classDelegatingTableGroup
-
isRealTableGroup
public boolean isRealTableGroup()- Specified by:
isRealTableGroup
in interfaceTableGroup
- Overrides:
isRealTableGroup
in classDelegatingTableGroup
-
isFetched
public boolean isFetched()- Specified by:
isFetched
in interfaceTableGroup
- Overrides:
isFetched
in classDelegatingTableGroup
-
isLateral
public boolean isLateral()- Specified by:
isLateral
in interfaceTableGroup
- Overrides:
isLateral
in classDelegatingTableGroup
-