Class BasicCollectionPersister

java.lang.Object

org.hibernate.persister.collection.AbstractCollectionPersister

org.hibernate.persister.collection.BasicCollectionPersister

All Implemented Interfaces:

CollectionMutationTarget, org.hibernate.engine.profile.internal.FetchProfileAffectee, FilterRestrictable, org.hibernate.metamodel.mapping.internal.InFlightCollectionMapping, org.hibernate.metamodel.mapping.internal.PluralAttributeMappingImpl.Aware, Restrictable, WhereRestrictable, CollectionPersister, Joinable, GraphMutationTarget<CollectionTableDescriptor>, LegacyMutationTarget<CollectionTableMapping>, MutationTarget<CollectionTableMapping, CollectionTableDescriptor>

@Internal
public class BasicCollectionPersister
extends AbstractCollectionPersister

A CollectionPersister for collections of values and many-to-many associations.

See Also:

• OneToManyPersister

Field Summary

Fields inherited from class AbstractCollectionPersister

batchSize, elementColumnAliases, elementColumnIsGettable, elementColumnIsSettable, elementColumnNames, elementColumnReaders, elementColumnReaderTemplates, elementColumnWriters, elementFormulas, elementFormulaTemplates, elementIsPureFormula, elementType, hasWhere, identifierColumnName, indexColumnAliases, indexColumnIsGettable, indexColumnIsSettable, indexColumnNames, indexContainsFormula, indexFormulas, indexFormulaTemplates, isInverse, keyColumnAliases, keyColumnNames, keyFormulas, keyFormulaTemplates, qualifiedTableName, sqlExceptionHelper, sqlWhereString

Constructor Summary

Constructors

Constructor	Description
BasicCollectionPersister(Collection collectionBinding, CollectionDataAccess cacheAccessStrategy, RuntimeModelCreationContext creationContext)

Method Summary

Modifier and Type	Method	Description
protected CollectionDecomposer	buildCollectionDecomposer()
protected RowMutationOperations	buildRowMutationOperations()
void	decompose(org.hibernate.action.internal.CollectionRecreateAction action, int ordinalBase, SharedSessionContractImplementor session, DecompositionContext decompositionContext, Consumer<FlushOperation> operationConsumer)	Decomposes a collection recreate action into planned operations.
void	decompose(org.hibernate.action.internal.CollectionRemoveAction action, int ordinalBase, SharedSessionContractImplementor session, DecompositionContext decompositionContext, Consumer<FlushOperation> operationConsumer)	Removes the collection: For collections with a collection-table, this will execute a DELETE based on the collection-key For one-to-many collections, this executes an UPDATE to unset the collection-key on the association table
void	decompose(org.hibernate.action.internal.CollectionUpdateAction action, int ordinalBase, SharedSessionContractImplementor session, DecompositionContext decompositionContext, Consumer<FlushOperation> operationConsumer)	Decomposes a collection update action into planned operations
void	decompose(org.hibernate.action.internal.QueuedOperationCollectionAction action, int ordinalBase, SharedSessionContractImplementor session, Consumer<FlushOperation> operationConsumer)	Decomposes a queued collection operation action into planned operations.
void	deleteRows(PersistentCollection<?> collection, Object id, SharedSessionContractImplementor session)	Delete the persistent state of any elements that were removed from the collection
protected void	doProcessQueuedOps(PersistentCollection<?> collection, Object id, SharedSessionContractImplementor session)
RestrictedTableMutation<JdbcMutationOperation>	generateDeleteAllAst(MutatingTableReference tableReference)
protected RestrictedTableMutation<JdbcMutationOperation>	generateSoftDeleteRowsAst(MutatingTableReference tableReference)
protected RestrictedTableMutation<JdbcMutationOperation>	generateTemporalDeleteAllAst(MutatingTableReference tableReference)
protected RestrictedTableMutation<JdbcMutationOperation>	generateTemporalDeleteRowsAst(MutatingTableReference tableReference)
InsertRowsCoordinator	getCreateEntryCoordinator()
DeleteRowsCoordinator	getDeleteRowsCoordinator()
FilterAliasGenerator	getFilterAliasGenerator(String rootAlias)
FilterAliasGenerator	getFilterAliasGenerator(TableGroup tableGroup)
InsertRowsCoordinator	getInsertRowsCoordinator()
RemoveCoordinator	getRemoveCoordinator()
DeleteRowsCoordinator	getRemoveEntryCoordinator()
RowMutationOperations	getRowMutationOperations()
UpdateRowsCoordinator	getUpdateEntryCoordinator()
UpdateRowsCoordinator	getUpdateRowsCoordinator()
void	insertRows(PersistentCollection<?> collection, Object id, SharedSessionContractImplementor session)	Insert the persistent state of any new collection elements
boolean	isManyToMany()	Is this a many-to-many association? Note that this is mainly a convenience feature as the single persister does not contain all the information needed to handle a many-to-many itself, as internally it is looked at as two many-to-ones.
boolean	isOneToMany()	Is this a one-to-many association?
boolean	isPerformingUpdates()
void	postInstantiate()
void	recreate(PersistentCollection<?> collection, Object id, SharedSessionContractImplementor session)	(Re)create the collection's persistent state
void	updateRows(PersistentCollection<?> collection, Object id, SharedSessionContractImplementor session)	Update the persistent state of any elements that were modified

Methods inherited from class AbstractCollectionPersister

applyBaseManyToManyRestrictions, applyBaseRestrictions, applyFilterRestrictions, applyKeyRestrictions, applyWhereFragments, applyWhereRestrictions, buildDeleteAllOperation, createNamedQueryCollectionLoader, createSingleKeyCollectionLoader, createSubSelectLoader, determineLoaderToUse, determineTableName, elementExists, forEachMutableTable, forEachMutableTableDescriptor, forEachMutableTableDescriptorReverse, forEachMutableTableReverse, generateDetectRowByElementString, generateDetectRowByIndexString, generateSelectSizeString, getAttributeMapping, getBatchSize, getCacheAccessStrategy, getCacheEntryStructure, getCollectionLoader, getCollectionPropertyColumnAliases, getCollectionSemantics, getCollectionSpaces, getCollectionTableDescriptor, getCollectionTableMapping, getCollectionType, getDialect, getElementByIndex, getElementClass, getElementColumnAliases, getElementColumnIsSettable, getElementColumnNames, getElementFormulas, getElementPersister, getElementPersisterInternal, getElementType, getFactory, getGenerator, getIdentifierColumnAlias, getIdentifierColumnName, getIdentifierTableName, getIdentifierType, getIndexColumnAliases, getIndexColumnIsSettable, getIndexColumnNames, getIndexFormulas, getIndexIncrementer, getIndexType, getKeyColumnAliases, getKeyColumnNames, getKeyFormulas, getKeyType, getMappedByProperty, getNavigableRole, getOwnerEntityName, getOwnerEntityPersister, getRolePath, getSize, getSortingComparator, getSQLExceptionHelper, getSqlWhereString, getTableName, getTargetPart, hasCache, hasIndex, hasManyToManyOrdering, hasOrdering, hasOrphanDelete, hasPhysicalIndexColumn, hasWhereRestrictions, incrementIndexByBase, indexExists, initCollectionPropertyMap, initialize, injectAttributeMapping, isAffectedByEnabledFetchProfiles, isAffectedByEnabledFilters, isAffectedByEnabledFilters, isAffectedByEnabledFilters, isAffectedByEnabledFilters, isAffectedByEntityGraph, isArray, isCascadeDeleteEnabled, isExtraLazy, isInverse, isLazy, isMutable, isPrimitiveArray, isRowDeleteEnabled, isRowInsertEnabled, isSubselectLoadable, isVersioned, logStaticSQL, needsRemove, prepareMappingModel, processQueuedOps, registerAffectingFetchProfile, remove, selectFragment, toString, useShallowQueryCacheLayout

Methods inherited from class Object

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

Methods inherited from interface CollectionMutationTarget

getIdentifierTableDescriptor, getIdentifierTableMapping

Methods inherited from interface CollectionPersister

getRole, isBatchLoadable

Constructor Details

BasicCollectionPersister

public BasicCollectionPersister(Collection collectionBinding,
 CollectionDataAccess cacheAccessStrategy,
 RuntimeModelCreationContext creationContext)
                         throws MappingException,
CacheException

Throws:

MappingException

CacheException

Method Details

postInstantiate

public void postInstantiate()
                     throws MappingException

Specified by:

postInstantiate in interface CollectionPersister

Overrides:

postInstantiate in class AbstractCollectionPersister

Throws:

MappingException

buildCollectionDecomposer

protected CollectionDecomposer buildCollectionDecomposer()

getRowMutationOperations

public RowMutationOperations getRowMutationOperations()

Specified by:

getRowMutationOperations in interface CollectionPersister

Specified by:

getRowMutationOperations in class AbstractCollectionPersister

getCreateEntryCoordinator

public InsertRowsCoordinator getCreateEntryCoordinator()

getInsertRowsCoordinator

public InsertRowsCoordinator getInsertRowsCoordinator()

recreate

public void recreate(PersistentCollection<?> collection,
 Object id,
 SharedSessionContractImplementor session)

Description copied from interface: CollectionPersister

(Re)create the collection's persistent state

insertRows

public void insertRows(PersistentCollection<?> collection,
 Object id,
 SharedSessionContractImplementor session)
                throws HibernateException

Description copied from interface: CollectionPersister

Insert the persistent state of any new collection elements

Throws:

HibernateException

getUpdateEntryCoordinator

public UpdateRowsCoordinator getUpdateEntryCoordinator()

getUpdateRowsCoordinator

public UpdateRowsCoordinator getUpdateRowsCoordinator()

updateRows

public void updateRows(PersistentCollection<?> collection,
 Object id,
 SharedSessionContractImplementor session)

Description copied from interface: CollectionPersister

Update the persistent state of any elements that were modified

getRemoveEntryCoordinator

public DeleteRowsCoordinator getRemoveEntryCoordinator()

getDeleteRowsCoordinator

public DeleteRowsCoordinator getDeleteRowsCoordinator()

deleteRows

public void deleteRows(PersistentCollection<?> collection,
 Object id,
 SharedSessionContractImplementor session)

Description copied from interface: CollectionPersister

Delete the persistent state of any elements that were removed from the collection

getRemoveCoordinator

public RemoveCoordinator getRemoveCoordinator()

Specified by:

getRemoveCoordinator in class AbstractCollectionPersister

doProcessQueuedOps

protected void doProcessQueuedOps(PersistentCollection<?> collection,
 Object id,
 SharedSessionContractImplementor session)

Specified by:

doProcessQueuedOps in class AbstractCollectionPersister

isPerformingUpdates

public boolean isPerformingUpdates()

generateDeleteAllAst

public RestrictedTableMutation<JdbcMutationOperation> generateDeleteAllAst(MutatingTableReference tableReference)

Overrides:

generateDeleteAllAst in class AbstractCollectionPersister

generateTemporalDeleteAllAst

protected RestrictedTableMutation<JdbcMutationOperation> generateTemporalDeleteAllAst(MutatingTableReference tableReference)

buildRowMutationOperations

protected RowMutationOperations buildRowMutationOperations()

generateSoftDeleteRowsAst

protected RestrictedTableMutation<JdbcMutationOperation> generateSoftDeleteRowsAst(MutatingTableReference tableReference)

generateTemporalDeleteRowsAst

protected RestrictedTableMutation<JdbcMutationOperation> generateTemporalDeleteRowsAst(MutatingTableReference tableReference)

isOneToMany

public boolean isOneToMany()

Description copied from interface: CollectionPersister

Is this a one-to-many association?

isManyToMany

public boolean isManyToMany()

Description copied from interface: CollectionPersister

Is this a many-to-many association? Note that this is mainly a convenience feature as the single persister does not contain all the information needed to handle a many-to-many itself, as internally it is looked at as two many-to-ones.

Specified by:

isManyToMany in interface CollectionPersister

Specified by:

isManyToMany in class AbstractCollectionPersister

getFilterAliasGenerator

public FilterAliasGenerator getFilterAliasGenerator(String rootAlias)

Specified by:

getFilterAliasGenerator in class AbstractCollectionPersister

getFilterAliasGenerator

public FilterAliasGenerator getFilterAliasGenerator(TableGroup tableGroup)

Specified by:

getFilterAliasGenerator in class AbstractCollectionPersister

decompose

public void decompose(org.hibernate.action.internal.CollectionRecreateAction action,
 int ordinalBase,
 SharedSessionContractImplementor session,
 DecompositionContext decompositionContext,
 Consumer<FlushOperation> operationConsumer)

Description copied from interface: CollectionPersister

Decomposes a collection recreate action into planned operations.

decompose

public void decompose(org.hibernate.action.internal.CollectionUpdateAction action,
 int ordinalBase,
 SharedSessionContractImplementor session,
 DecompositionContext decompositionContext,
 Consumer<FlushOperation> operationConsumer)

Description copied from interface: CollectionPersister

Decomposes a collection update action into planned operations

decompose

public void decompose(org.hibernate.action.internal.CollectionRemoveAction action,
 int ordinalBase,
 SharedSessionContractImplementor session,
 DecompositionContext decompositionContext,
 Consumer<FlushOperation> operationConsumer)

Description copied from interface: CollectionPersister

Removes the collection:

• For collections with a collection-table, this will execute a DELETE based on the collection-key
• For one-to-many collections, this executes an UPDATE to unset the collection-key on the association table

decompose

public void decompose(org.hibernate.action.internal.QueuedOperationCollectionAction action,
 int ordinalBase,
 SharedSessionContractImplementor session,
 Consumer<FlushOperation> operationConsumer)

Description copied from interface: CollectionPersister

Decomposes a queued collection operation action into planned operations.

Queued collection operations often have no SQL work of their own, but still need flush-time lifecycle cleanup after the plan reaches the action.