org.hibernate.persister.collection

Class OneToManyPersister

java.lang.Object

org.hibernate.persister.collection.AbstractCollectionPersister

org.hibernate.persister.collection.OneToManyPersister

All Implemented Interfaces:

CollectionMetadata, CollectionPersister, QueryableCollection, SQLLoadableCollection, Joinable, PropertyMapping, CollectionDefinition

public class OneToManyPersister
extends AbstractCollectionPersister

Collection persister for one-to-many associations.

Author:

Gavin King, Brett Meyer

Field Summary

Fields inherited from class org.hibernate.persister.collection.AbstractCollectionPersister

batchSize, elementColumnAliases, elementColumnIsInPrimaryKey, elementColumnIsSettable, elementColumnNames, elementColumnReaders, elementColumnReaderTemplates, elementColumnWriters, elementFormulas, elementFormulaTemplates, elementIsPureFormula, elementType, hasIdentifier, hasIndex, hasWhere, identifierColumnName, indexColumnAliases, indexColumnIsGettable, indexColumnIsSettable, indexColumnNames, indexContainsFormula, indexFormulas, indexFormulaTemplates, isInverse, keyColumnAliases, keyColumnNames, qualifiedTableName, recreateBatchKey, sqlExceptionHelper, sqlWhereString

Constructor Summary

Constructors

Constructor and Description
OneToManyPersister(Collection collectionBinding, CollectionDataAccess cacheAccessStrategy, PersisterCreationContext creationContext)

Method Summary

Modifier and Type	Method and Description
boolean	consumesCollectionAlias() Very, very, very ugly...
boolean	consumesEntityAlias() Very, very, very ugly...
protected CollectionInitializer	createCollectionInitializer(LoadQueryInfluencers loadQueryInfluencers) Create the OneToManyLoader
protected CollectionInitializer	createSubselectInitializer(SubselectFetch subselect, SharedSessionContractImplementor session)
protected void	doProcessQueuedOps(PersistentCollection collection, Serializable id, SharedSessionContractImplementor session)
protected int	doUpdateRows(Serializable id, PersistentCollection collection, SharedSessionContractImplementor session)
String	filterFragment(String alias)
protected String	filterFragment(String alias, Set<String> treatAsDeclarations)
String	fromJoinFragment(String alias, boolean innerJoin, boolean includeSubclasses) Get the from clause part of any joins (optional operation)
String	fromJoinFragment(String alias, boolean innerJoin, boolean includeSubclasses, Set<String> treatAsDeclarations) Get the from clause part of any joins (optional operation)
protected String	generateDeleteRowString() Generate the SQL UPDATE that updates a particular row's foreign key to null
protected String	generateDeleteString() Generate the SQL UPDATE that updates all the foreign keys to null
protected String	generateInsertRowString() Generate the SQL UPDATE that updates a foreign key to a value
protected String	generateUpdateRowString() Generate the SQL UPDATE that inserts a collection index
Object	getElementByIndex(Serializable key, Object index, SharedSessionContractImplementor session, Object owner)
FilterAliasGenerator	getFilterAliasGenerator(String rootAlias)
String	getTableName() The table to join to.
void	insertRows(PersistentCollection collection, Serializable id, SharedSessionContractImplementor session) Insert the persistent state of any new collection elements
boolean	isCascadeDeleteEnabled() Is cascade delete handled by the database-level foreign key constraint definition?
boolean	isManyToMany() Is this a many-to-many association? Note that this is mainly a convenience feature as the single persister does not conatin 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?
protected boolean	isRowDeleteEnabled()
protected boolean	isRowInsertEnabled()
void	recreate(PersistentCollection collection, Serializable id, SharedSessionContractImplementor session) (Re)create the collection's persistent state
String	selectFragment(Joinable rhs, String rhsAlias, String lhsAlias, String entitySuffix, String collectionSuffix, boolean includeCollectionColumns) All columns to select, when loading.
String	whereJoinFragment(String alias, boolean innerJoin, boolean includeSubclasses) Get the where clause part of any joins (optional operation)
String	whereJoinFragment(String alias, boolean innerJoin, boolean includeSubclasses, Set<String> treatAsDeclarations) Get the where clause part of any joins (optional operation)

Methods inherited from class org.hibernate.persister.collection.AbstractCollectionPersister

appendElementColumns, appendIdentifierColumns, appendIndexColumns, decrementIndexByBase, deleteRows, determineTableName, doProcessQueuedOps, elementExists, filterFragment, filterFragment, generateDetectRowByElementString, generateDetectRowByIndexString, generateSelectFragment, generateSelectRowByIndexString, generateSelectSizeString, getAppropriateInitializer, getBatchSize, getCacheAccessStrategy, getCacheEntryStructure, getCollectionMetadata, getCollectionPersister, getCollectionPropertyColumnAliases, getCollectionSpaces, getCollectionType, getDeleteAllCheckStyle, getDeleteCheckStyle, getDialect, getElementClass, getElementColumnAliases, getElementColumnNames, getElementColumnNames, getElementDefinition, getElementPersister, getElementType, getFactory, getFetchMode, getIdentifierColumnAlias, getIdentifierColumnName, getIdentifierGenerator, getIdentifierType, getIndexColumnAliases, getIndexColumnNames, getIndexColumnNames, getIndexDefinition, getIndexFormulas, getIndexType, getInitializer, getInsertCheckStyle, getKeyColumnAliases, getKeyColumnNames, getKeyType, getManyToManyFilterFragment, getManyToManyOrderByString, getMappedByProperty, getName, getNavigableRole, getOwnerEntityName, getOwnerEntityPersister, getRole, getSize, getSQLDeleteRowString, getSQLDeleteString, getSQLExceptionConverter, getSQLExceptionHelper, getSQLInsertRowString, getSQLOrderByString, getSQLUpdateRowString, getSQLWhereString, getType, getUpdateCheckStyle, hasCache, hasIndex, hasManyToManyOrdering, hasOrdering, hasOrphanDelete, hasWhere, incrementIndexByBase, indexExists, initCollectionPropertyMap, initialize, isAffectedByEnabledFilters, isArray, isCollection, isDeleteAllCallable, isDeleteCallable, isExtraLazy, isInsertCallable, isInverse, isLazy, isMutable, isPrimitiveArray, isSubselectLoadable, isUpdateCallable, isVersioned, logStaticSQL, oneToManyFilterFragment, oneToManyFilterFragment, postInstantiate, processQueuedOps, readElement, readIdentifier, readIndex, readKey, remove, selectFragment, toColumns, toColumns, toString, toType, updateRows, writeElement, writeElementToWhere, writeIdentifier, writeIndex, writeIndexToWhere, writeKey

Methods inherited from class java.lang.Object

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

Constructor Detail

OneToManyPersister

public OneToManyPersister(Collection collectionBinding,
                          CollectionDataAccess cacheAccessStrategy,
                          PersisterCreationContext creationContext)
                   throws MappingException,
                          CacheException

Throws:

MappingException

CacheException

Method Detail

isRowDeleteEnabled

protected boolean isRowDeleteEnabled()

Overrides:

isRowDeleteEnabled in class AbstractCollectionPersister

isRowInsertEnabled

protected boolean isRowInsertEnabled()

Overrides:

isRowInsertEnabled in class AbstractCollectionPersister

isCascadeDeleteEnabled

public boolean isCascadeDeleteEnabled()

Description copied from interface: CollectionPersister

Is cascade delete handled by the database-level foreign key constraint definition?

generateDeleteString

protected String generateDeleteString()

Generate the SQL UPDATE that updates all the foreign keys to null

Specified by:

generateDeleteString in class AbstractCollectionPersister

generateInsertRowString

protected String generateInsertRowString()

Generate the SQL UPDATE that updates a foreign key to a value

Specified by:

generateInsertRowString in class AbstractCollectionPersister

generateUpdateRowString

protected String generateUpdateRowString()

Generate the SQL UPDATE that inserts a collection index

Specified by:

generateUpdateRowString in class AbstractCollectionPersister

generateDeleteRowString

protected String generateDeleteRowString()

Generate the SQL UPDATE that updates a particular row's foreign key to null

Specified by:

generateDeleteRowString in class AbstractCollectionPersister

recreate

public void recreate(PersistentCollection collection,
                     Serializable id,
                     SharedSessionContractImplementor session)
              throws HibernateException

Description copied from interface: CollectionPersister

(Re)create the collection's persistent state

Specified by:

recreate in interface CollectionPersister

Overrides:

recreate in class AbstractCollectionPersister

Throws:

HibernateException

insertRows

public void insertRows(PersistentCollection collection,
                       Serializable id,
                       SharedSessionContractImplementor session)
                throws HibernateException

Description copied from interface: CollectionPersister

Insert the persistent state of any new collection elements

Specified by:

insertRows in interface CollectionPersister

Overrides:

insertRows in class AbstractCollectionPersister

Throws:

HibernateException

doProcessQueuedOps

protected void doProcessQueuedOps(PersistentCollection collection,
                                  Serializable id,
                                  SharedSessionContractImplementor session)
                           throws HibernateException

Specified by:

doProcessQueuedOps in class AbstractCollectionPersister

Throws:

HibernateException

consumesEntityAlias

public boolean consumesEntityAlias()

Description copied from interface: Joinable

Very, very, very ugly...

Returns:

Does this persister "consume" entity column aliases in the result set?

consumesCollectionAlias

public boolean consumesCollectionAlias()

Description copied from interface: Joinable

Very, very, very ugly...

Returns:

Does this persister "consume" collection column aliases in the result set?

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 conatin 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

doUpdateRows

protected int doUpdateRows(Serializable id,
                           PersistentCollection collection,
                           SharedSessionContractImplementor session)

Specified by:

doUpdateRows in class AbstractCollectionPersister

selectFragment

public String selectFragment(Joinable rhs,
                             String rhsAlias,
                             String lhsAlias,
                             String entitySuffix,
                             String collectionSuffix,
                             boolean includeCollectionColumns)

Description copied from interface: Joinable

All columns to select, when loading.

createCollectionInitializer

protected CollectionInitializer createCollectionInitializer(LoadQueryInfluencers loadQueryInfluencers)
                                                     throws MappingException

Create the OneToManyLoader

Specified by:

createCollectionInitializer in class AbstractCollectionPersister

Throws:

MappingException

See Also:

OneToManyLoader

fromJoinFragment

public String fromJoinFragment(String alias,
                               boolean innerJoin,
                               boolean includeSubclasses)

Description copied from interface: Joinable

Get the from clause part of any joins (optional operation)

fromJoinFragment

public String fromJoinFragment(String alias,
                               boolean innerJoin,
                               boolean includeSubclasses,
                               Set<String> treatAsDeclarations)

Description copied from interface: Joinable

Get the from clause part of any joins (optional operation)

whereJoinFragment

public String whereJoinFragment(String alias,
                                boolean innerJoin,
                                boolean includeSubclasses)

Description copied from interface: Joinable

Get the where clause part of any joins (optional operation)

whereJoinFragment

public String whereJoinFragment(String alias,
                                boolean innerJoin,
                                boolean includeSubclasses,
                                Set<String> treatAsDeclarations)

Description copied from interface: Joinable

Get the where clause part of any joins (optional operation)

getTableName

public String getTableName()

Description copied from interface: Joinable

The table to join to.

Specified by:

getTableName in interface Joinable

Overrides:

getTableName in class AbstractCollectionPersister

filterFragment

public String filterFragment(String alias)
                      throws MappingException

Overrides:

filterFragment in class AbstractCollectionPersister

Throws:

MappingException

filterFragment

protected String filterFragment(String alias,
                                Set<String> treatAsDeclarations)
                         throws MappingException

Overrides:

filterFragment in class AbstractCollectionPersister

Throws:

MappingException

createSubselectInitializer

protected CollectionInitializer createSubselectInitializer(SubselectFetch subselect,
                                                           SharedSessionContractImplementor session)

Specified by:

createSubselectInitializer in class AbstractCollectionPersister

getElementByIndex

public Object getElementByIndex(Serializable key,
                                Object index,
                                SharedSessionContractImplementor session,
                                Object owner)

Specified by:

getElementByIndex in interface CollectionPersister

Overrides:

getElementByIndex in class AbstractCollectionPersister

getFilterAliasGenerator

public FilterAliasGenerator getFilterAliasGenerator(String rootAlias)

Specified by:

getFilterAliasGenerator in class AbstractCollectionPersister