AbstractCollectionPersister (Hibernate Core Aggregator 3.6.9.Final API)

java.lang.Object
- org.hibernate.persister.collection.AbstractCollectionPersister

All Implemented Interfaces:

CollectionMetadata, CollectionPersister, QueryableCollection, SQLLoadableCollection, Joinable, PropertyMapping

Direct Known Subclasses:

BasicCollectionPersister, OneToManyPersister
```
public abstract class AbstractCollectionPersister
extends java.lang.Object
implements CollectionMetadata, SQLLoadableCollection
```
Base implementation of the QueryableCollection interface.

Author:

Gavin King

See Also:
BasicCollectionPersister, OneToManyPersister

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`batchSize`
`protected java.lang.String[]`	`elementColumnAliases`
`protected boolean[]`	`elementColumnIsInPrimaryKey`
`protected boolean[]`	`elementColumnIsSettable`
`protected java.lang.String[]`	`elementColumnNames`
`protected java.lang.String[]`	`elementColumnReaders`
`protected java.lang.String[]`	`elementColumnReaderTemplates`
`protected java.lang.String[]`	`elementColumnWriters`
`protected java.lang.String[]`	`elementFormulas`
`protected java.lang.String[]`	`elementFormulaTemplates`
`protected boolean`	`elementIsPureFormula`
`protected Type`	`elementType`
`protected boolean`	`hasIdentifier`
`protected boolean`	`hasIndex`
`protected boolean`	`hasWhere`
`protected java.lang.String`	`identifierColumnName`
`protected java.lang.String[]`	`indexColumnAliases`
`protected boolean[]`	`indexColumnIsSettable`
`protected java.lang.String[]`	`indexColumnNames`
`protected boolean`	`indexContainsFormula`
`protected java.lang.String[]`	`indexFormulas`
`protected java.lang.String[]`	`indexFormulaTemplates`
`protected java.lang.String[]`	`keyColumnAliases`
`protected java.lang.String[]`	`keyColumnNames`
`protected java.lang.String`	`qualifiedTableName`
`protected java.lang.String`	`sqlWhereString`

Constructor Summary

Constructors
Constructor and Description
`AbstractCollectionPersister(Collection collection, CollectionRegionAccessStrategy cacheAccessStrategy, Configuration cfg, SessionFactoryImplementor factory)`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`appendElementColumns(SelectFragment frag, java.lang.String elemAlias)`
`protected void`	`appendIdentifierColumns(SelectFragment frag, java.lang.String alias)`
`protected void`	`appendIndexColumns(SelectFragment frag, java.lang.String alias)`
`protected abstract CollectionInitializer`	`createCollectionInitializer(LoadQueryInfluencers loadQueryInfluencers)`
`protected abstract CollectionInitializer`	`createSubselectInitializer(SubselectFetch subselect, SessionImplementor session)`
`protected java.lang.Object`	`decrementIndexByBase(java.lang.Object index)`
`void`	`deleteRows(PersistentCollection collection, java.io.Serializable id, SessionImplementor session)` Delete the persistent state of any elements that were removed from the collection
`protected abstract int`	`doUpdateRows(java.io.Serializable key, PersistentCollection collection, SessionImplementor session)`
`boolean`	`elementExists(java.io.Serializable key, java.lang.Object element, SessionImplementor session)`
`protected java.lang.String`	`filterFragment(java.lang.String alias)`
`java.lang.String`	`filterFragment(java.lang.String alias, java.util.Map enabledFilters)` Get the where clause filter, given a query alias and considering enabled session filters
`protected abstract java.lang.String`	`generateDeleteRowString()`
`protected abstract java.lang.String`	`generateDeleteString()`
`protected java.lang.String`	`generateDetectRowByElementString()`
`protected java.lang.String`	`generateDetectRowByIndexString()`
`protected abstract java.lang.String`	`generateInsertRowString()`
`protected SelectFragment`	`generateSelectFragment(java.lang.String alias, java.lang.String columnSuffix)`
`protected java.lang.String`	`generateSelectRowByIndexString()`
`protected java.lang.String`	`generateSelectSizeString(boolean isIntegerIndexed)`
`protected abstract java.lang.String`	`generateUpdateRowString()`
`protected CollectionInitializer`	`getAppropriateInitializer(java.io.Serializable key, SessionImplementor session)`
`CollectionRegionAccessStrategy`	`getCacheAccessStrategy()` Get the cache
`CacheEntryStructure`	`getCacheEntryStructure()` Get the cache structure
`CollectionMetadata`	`getCollectionMetadata()`
`java.lang.String[]`	`getCollectionPropertyColumnAliases(java.lang.String propertyName, java.lang.String suffix)`
`java.io.Serializable[]`	`getCollectionSpaces()` Get the "space" that holds the persistent state
`CollectionType`	`getCollectionType()` Get the associated `Type`
`protected ExecuteUpdateResultCheckStyle`	`getDeleteAllCheckStyle()`
`protected ExecuteUpdateResultCheckStyle`	`getDeleteCheckStyle()`
`protected Dialect`	`getDialect()`
`java.lang.Object`	`getElementByIndex(java.io.Serializable key, java.lang.Object index, SessionImplementor session, java.lang.Object owner)`
`java.lang.Class`	`getElementClass()` Return the element class of an array, or null otherwise
`java.lang.String[]`	`getElementColumnAliases(java.lang.String suffix)` Generates the collection's element column aliases, based on the given suffix.
`java.lang.String[]`	`getElementColumnNames()` Get the names of the collection element columns (or the primary key columns in the case of a one-to-many association)
`java.lang.String[]`	`getElementColumnNames(java.lang.String alias)` Get the names of the collection element columns (or the primary key columns in the case of a one-to-many association), aliased by the given table alias
`java.lang.String`	`getElementNodeName()`
`EntityPersister`	`getElementPersister()` Get the persister of the element class, if this is a collection of entities (optional operation).
`Type`	`getElementType()` The collection element type
`SessionFactoryImplementor`	`getFactory()`
`FetchMode`	`getFetchMode()` Should we load this collection role by outerjoining?
`java.lang.String`	`getIdentifierColumnAlias(java.lang.String suffix)` Generates the collection's identifier column aliases, based on the given suffix.
`java.lang.String`	`getIdentifierColumnName()`
`IdentifierGenerator`	`getIdentifierGenerator()` Get the surrogate key generation strategy (optional operation)
`Type`	`getIdentifierType()` Get the type of the surrogate key
`java.lang.String[]`	`getIndexColumnAliases(java.lang.String suffix)` Generates the collection's index column aliases, based on the given suffix.
`java.lang.String[]`	`getIndexColumnNames()` Get the names of the collection index columns if this is an indexed collection (optional operation)
`java.lang.String[]`	`getIndexColumnNames(java.lang.String alias)` Get the names of the collection index columns if this is an indexed collection (optional operation), aliased by the given table alias
`java.lang.String[]`	`getIndexFormulas()` Get the index formulas if this is an indexed collection (optional operation)
`java.lang.String`	`getIndexNodeName()`
`Type`	`getIndexType()` The collection index type (or null if the collection has no index)
`CollectionInitializer`	`getInitializer()` Intended for internal use only.
`protected ExecuteUpdateResultCheckStyle`	`getInsertCheckStyle()`
`java.lang.String[]`	`getKeyColumnAliases(java.lang.String suffix)` Generates the collection's key column aliases, based on the given suffix.
`java.lang.String[]`	`getKeyColumnNames()` The columns to join on
`Type`	`getKeyType()` The collection key type
`java.lang.String`	`getManyToManyFilterFragment(java.lang.String alias, java.util.Map enabledFilters)`
`java.lang.String`	`getManyToManyOrderByString(java.lang.String alias)` Get the order-by to be applied at the target table of a many to many
`java.lang.String`	`getName()` An identifying name; a class name or collection role name.
`java.lang.String`	`getNodeName()`
`java.lang.String`	`getOwnerEntityName()`
`EntityPersister`	`getOwnerEntityPersister()` Get the persister of the entity that "owns" this collection
`java.lang.String`	`getRole()` The name of this collection role
`int`	`getSize(java.io.Serializable key, SessionImplementor session)`
`protected java.lang.String`	`getSQLDeleteRowString()`
`protected java.lang.String`	`getSQLDeleteString()`
`protected SQLExceptionConverter`	`getSQLExceptionConverter()`
`protected java.lang.String`	`getSQLInsertRowString()`
`java.lang.String`	`getSQLOrderByString(java.lang.String alias)` Get the order by SQL
`protected java.lang.String`	`getSQLUpdateRowString()`
`protected java.lang.String`	`getSQLWhereString(java.lang.String alias)`
`java.lang.String`	`getTableName()` The table to join to.
`Type`	`getType()` Get the type of the thing containing the properties
`protected ExecuteUpdateResultCheckStyle`	`getUpdateCheckStyle()`
`boolean`	`hasCache()` Is this collection role cacheable
`boolean`	`hasIndex()` Is this collection indexed?
`boolean`	`hasManyToManyOrdering()`
`boolean`	`hasOrdering()` Is this an ordered collection? (An ordered collection is ordered by the initialization operation, not by sorting that happens in memory, as in the case of a sorted collection.)
`boolean`	`hasOrphanDelete()` Does this collection implement "orphan delete"?
`boolean`	`hasWhere()` Does this collection role have a where clause filter?
`protected java.lang.Object`	`incrementIndexByBase(java.lang.Object index)`
`boolean`	`indexExists(java.io.Serializable key, java.lang.Object index, SessionImplementor session)`
`void`	`initCollectionPropertyMap()`
`void`	`initialize(java.io.Serializable key, SessionImplementor session)` Initialize the given collection with the given key
`void`	`insertRows(PersistentCollection collection, java.io.Serializable id, SessionImplementor session)` Insert the persistent state of any new collection elements
`boolean`	`isAffectedByEnabledFilters(SessionImplementor session)`
`boolean`	`isArray()` Is the collection an array?
`boolean`	`isCollection()` Is this instance actually a CollectionPersister?
`protected boolean`	`isDeleteAllCallable()`
`protected boolean`	`isDeleteCallable()`
`boolean`	`isExtraLazy()`
`protected boolean`	`isInsertCallable()`
`boolean`	`isInverse()` Is this collection "inverse", so state changes are not propogated to the database.
`boolean`	`isLazy()` Is the collection lazily initialized?
`abstract 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`	`isMutable()` Can the elements of this collection change?
`boolean`	`isPrimitiveArray()` Is the collection a primitive array?
`protected boolean`	`isRowDeleteEnabled()`
`protected boolean`	`isRowInsertEnabled()`
`boolean`	`isSubselectLoadable()`
`protected boolean`	`isUpdateCallable()`
`boolean`	`isVersioned()` Does this collection cause version increment of the owning entity?
`protected void`	`logStaticSQL()`
`java.lang.String`	`oneToManyFilterFragment(java.lang.String alias)`
`void`	`postInstantiate()`
`java.lang.Object`	`readElement(java.sql.ResultSet rs, java.lang.Object owner, java.lang.String[] aliases, SessionImplementor session)` Read the element from a row of the JDBC `ResultSet`
`java.lang.Object`	`readIdentifier(java.sql.ResultSet rs, java.lang.String alias, SessionImplementor session)` Read the identifier from a row of the JDBC `ResultSet`
`java.lang.Object`	`readIndex(java.sql.ResultSet rs, java.lang.String[] aliases, SessionImplementor session)` Read the index from a row of the JDBC `ResultSet`
`java.lang.Object`	`readKey(java.sql.ResultSet rs, java.lang.String[] aliases, SessionImplementor session)` Read the key from a row of the JDBC `ResultSet`
`void`	`recreate(PersistentCollection collection, java.io.Serializable id, SessionImplementor session)` (Re)create the collection's persistent state
`void`	`remove(java.io.Serializable id, SessionImplementor session)` Completely remove the persistent state of the collection
`java.lang.String`	`selectFragment(java.lang.String alias, java.lang.String columnSuffix)` Generate a list of collection index, key and element columns
`java.lang.String[]`	`toColumns(java.lang.String propertyName)` Given a property path, return the corresponding column name(s).
`java.lang.String[]`	`toColumns(java.lang.String alias, java.lang.String propertyName)` Given a query alias and a property path, return the qualified column name
`java.lang.String`	`toString()`
`Type`	`toType(java.lang.String propertyName)` Given a component path expression, get the type of the property
`void`	`updateRows(PersistentCollection collection, java.io.Serializable id, SessionImplementor session)` Update the persistent state of any elements that were modified
`protected int`	`writeElement(java.sql.PreparedStatement st, java.lang.Object elt, int i, SessionImplementor session)` Write the element to a JDBC `PreparedStatement`
`protected int`	`writeElementToWhere(java.sql.PreparedStatement st, java.lang.Object elt, int i, SessionImplementor session)` Write the element to a JDBC `PreparedStatement`
`int`	`writeIdentifier(java.sql.PreparedStatement st, java.lang.Object id, int i, SessionImplementor session)` Write the identifier to a JDBC `PreparedStatement`
`protected int`	`writeIndex(java.sql.PreparedStatement st, java.lang.Object index, int i, SessionImplementor session)` Write the index to a JDBC `PreparedStatement`
`protected int`	`writeIndexToWhere(java.sql.PreparedStatement st, java.lang.Object index, int i, SessionImplementor session)` Write the index to a JDBC `PreparedStatement`
`protected int`	`writeKey(java.sql.PreparedStatement st, java.io.Serializable key, int i, SessionImplementor session)` Write the key to a JDBC `PreparedStatement`

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

Methods inherited from interface org.hibernate.persister.entity.Joinable
consumesCollectionAlias, consumesEntityAlias, fromJoinFragment, selectFragment, whereJoinFragment

Methods inherited from interface org.hibernate.persister.collection.CollectionPersister
isCascadeDeleteEnabled, isOneToMany

- Field Detail
  - sqlWhereString
```
protected final java.lang.String sqlWhereString
```
  - hasWhere
```
protected final boolean hasWhere
```
  - indexContainsFormula
```
protected final boolean indexContainsFormula
```
  - elementIsPureFormula
```
protected final boolean elementIsPureFormula
```
  - elementType
```
protected final Type elementType
```
  - keyColumnNames
```
protected final java.lang.String[] keyColumnNames
```
  - indexColumnNames
```
protected final java.lang.String[] indexColumnNames
```
  - indexFormulaTemplates
```
protected final java.lang.String[] indexFormulaTemplates
```
  - indexFormulas
```
protected final java.lang.String[] indexFormulas
```
  - indexColumnIsSettable
```
protected final boolean[] indexColumnIsSettable
```
  - elementColumnNames
```
protected final java.lang.String[] elementColumnNames
```
  - elementColumnWriters
```
protected final java.lang.String[] elementColumnWriters
```
  - elementColumnReaders
```
protected final java.lang.String[] elementColumnReaders
```
  - elementColumnReaderTemplates
```
protected final java.lang.String[] elementColumnReaderTemplates
```
  - elementFormulaTemplates
```
protected final java.lang.String[] elementFormulaTemplates
```
  - elementFormulas
```
protected final java.lang.String[] elementFormulas
```
  - elementColumnIsSettable
```
protected final boolean[] elementColumnIsSettable
```
  - elementColumnIsInPrimaryKey
```
protected final boolean[] elementColumnIsInPrimaryKey
```
  - indexColumnAliases
```
protected final java.lang.String[] indexColumnAliases
```
  - elementColumnAliases
```
protected final java.lang.String[] elementColumnAliases
```
  - keyColumnAliases
```
protected final java.lang.String[] keyColumnAliases
```
  - identifierColumnName
```
protected final java.lang.String identifierColumnName
```
  - qualifiedTableName
```
protected final java.lang.String qualifiedTableName
```
  - hasIndex
```
protected final boolean hasIndex
```
  - hasIdentifier
```
protected final boolean hasIdentifier
```
  - batchSize
```
protected final int batchSize
```
- Constructor Detail
  - AbstractCollectionPersister
```
public AbstractCollectionPersister(Collection collection,
                           CollectionRegionAccessStrategy cacheAccessStrategy,
                           Configuration cfg,
                           SessionFactoryImplementor factory)
                            throws MappingException,
                                   CacheException
```
    Throws:
    
    MappingException
    
    CacheException
- Method Detail
  - postInstantiate
```
public void postInstantiate()
                     throws MappingException
```
    Specified by:
    
    postInstantiate in interface CollectionPersister
    
    Throws:
    
    MappingException
  - logStaticSQL
```
protected void logStaticSQL()
```
  - initialize
```
public void initialize(java.io.Serializable key,
              SessionImplementor session)
                throws HibernateException
```
    Description copied from interface: CollectionPersister
    
    Initialize the given collection with the given key
    
    Specified by:
    
    initialize in interface CollectionPersister
    
    Throws:
    
    HibernateException
  - getAppropriateInitializer
```
protected CollectionInitializer getAppropriateInitializer(java.io.Serializable key,
                                              SessionImplementor session)
```
  - createSubselectInitializer
```
protected abstract CollectionInitializer createSubselectInitializer(SubselectFetch subselect,
                                               SessionImplementor session)
```
  - createCollectionInitializer
```
protected abstract CollectionInitializer createCollectionInitializer(LoadQueryInfluencers loadQueryInfluencers)
                                                              throws MappingException
```
    Throws:
    
    MappingException
  - getCacheAccessStrategy
```
public CollectionRegionAccessStrategy getCacheAccessStrategy()
```
    Description copied from interface: CollectionPersister
    
    Get the cache
    
    Specified by:
    
    getCacheAccessStrategy in interface CollectionPersister
  - hasCache
```
public boolean hasCache()
```
    Description copied from interface: CollectionPersister
    
    Is this collection role cacheable
    
    Specified by:
    
    hasCache in interface CollectionPersister
  - getCollectionType
```
public CollectionType getCollectionType()
```
    Description copied from interface: CollectionPersister
    
    Get the associated Type
    
    Specified by:
    
    getCollectionType in interface CollectionPersister
  - getSQLWhereString
```
protected java.lang.String getSQLWhereString(java.lang.String alias)
```
  - getSQLOrderByString
```
public java.lang.String getSQLOrderByString(java.lang.String alias)
```
    Description copied from interface: QueryableCollection
    
    Get the order by SQL
    
    Specified by:
    
    getSQLOrderByString in interface QueryableCollection
  - getManyToManyOrderByString
```
public java.lang.String getManyToManyOrderByString(java.lang.String alias)
```
    Description copied from interface: QueryableCollection
    
    Get the order-by to be applied at the target table of a many to many
    
    Specified by:
    
    getManyToManyOrderByString in interface QueryableCollection
    
    Parameters:
    alias - The alias for the many-to-many target table
    
    Returns:
    appropriate order-by fragment or empty string.
  - getFetchMode
```
public FetchMode getFetchMode()
```
    Description copied from interface: QueryableCollection
    
    Should we load this collection role by outerjoining?
    
    Specified by:
    
    getFetchMode in interface QueryableCollection
  - hasOrdering
```
public boolean hasOrdering()
```
    Description copied from interface: CollectionPersister
    
    Is this an ordered collection? (An ordered collection is ordered by the initialization operation, not by sorting that happens in memory, as in the case of a sorted collection.)
    
    Specified by:
    
    hasOrdering in interface CollectionPersister
  - hasManyToManyOrdering
```
public boolean hasManyToManyOrdering()
```
    Specified by:
    
    hasManyToManyOrdering in interface CollectionPersister
  - hasWhere
```
public boolean hasWhere()
```
    Description copied from interface: QueryableCollection
    
    Does this collection role have a where clause filter?
    
    Specified by:
    
    hasWhere in interface QueryableCollection
  - getSQLDeleteString
```
protected java.lang.String getSQLDeleteString()
```
  - getSQLInsertRowString
```
protected java.lang.String getSQLInsertRowString()
```
  - getSQLUpdateRowString
```
protected java.lang.String getSQLUpdateRowString()
```
  - getSQLDeleteRowString
```
protected java.lang.String getSQLDeleteRowString()
```
  - getKeyType
```
public Type getKeyType()
```
    Description copied from interface: CollectionMetadata
    
    The collection key type
    
    Specified by:
    
    getKeyType in interface CollectionMetadata
    
    Specified by:
    
    getKeyType in interface CollectionPersister
  - getIndexType
```
public Type getIndexType()
```
    Description copied from interface: CollectionMetadata
    
    The collection index type (or null if the collection has no index)
    
    Specified by:
    
    getIndexType in interface CollectionMetadata
    
    Specified by:
    
    getIndexType in interface CollectionPersister
  - getElementType
```
public Type getElementType()
```
    Description copied from interface: CollectionMetadata
    
    The collection element type
    
    Specified by:
    
    getElementType in interface CollectionMetadata
    
    Specified by:
    
    getElementType in interface CollectionPersister
  - getElementClass
```
public java.lang.Class getElementClass()
```
    Return the element class of an array, or null otherwise
    
    Specified by:
    
    getElementClass in interface CollectionPersister
  - readElement
```
public java.lang.Object readElement(java.sql.ResultSet rs,
                           java.lang.Object owner,
                           java.lang.String[] aliases,
                           SessionImplementor session)
                             throws HibernateException,
                                    java.sql.SQLException
```
    Description copied from interface: CollectionPersister
    
    Read the element from a row of the JDBC ResultSet
    
    Specified by:
    
    readElement in interface CollectionPersister
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - readIndex
```
public java.lang.Object readIndex(java.sql.ResultSet rs,
                         java.lang.String[] aliases,
                         SessionImplementor session)
                           throws HibernateException,
                                  java.sql.SQLException
```
    Description copied from interface: CollectionPersister
    
    Read the index from a row of the JDBC ResultSet
    
    Specified by:
    
    readIndex in interface CollectionPersister
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - decrementIndexByBase
```
protected java.lang.Object decrementIndexByBase(java.lang.Object index)
```
  - readIdentifier
```
public java.lang.Object readIdentifier(java.sql.ResultSet rs,
                              java.lang.String alias,
                              SessionImplementor session)
                                throws HibernateException,
                                       java.sql.SQLException
```
    Description copied from interface: CollectionPersister
    
    Read the identifier from a row of the JDBC ResultSet
    
    Specified by:
    
    readIdentifier in interface CollectionPersister
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - readKey
```
public java.lang.Object readKey(java.sql.ResultSet rs,
                       java.lang.String[] aliases,
                       SessionImplementor session)
                         throws HibernateException,
                                java.sql.SQLException
```
    Description copied from interface: CollectionPersister
    
    Read the key from a row of the JDBC ResultSet
    
    Specified by:
    
    readKey in interface CollectionPersister
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - writeKey
```
protected int writeKey(java.sql.PreparedStatement st,
           java.io.Serializable key,
           int i,
           SessionImplementor session)
                throws HibernateException,
                       java.sql.SQLException
```
    Write the key to a JDBC PreparedStatement
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - writeElement
```
protected int writeElement(java.sql.PreparedStatement st,
               java.lang.Object elt,
               int i,
               SessionImplementor session)
                    throws HibernateException,
                           java.sql.SQLException
```
    Write the element to a JDBC PreparedStatement
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - writeIndex
```
protected int writeIndex(java.sql.PreparedStatement st,
             java.lang.Object index,
             int i,
             SessionImplementor session)
                  throws HibernateException,
                         java.sql.SQLException
```
    Write the index to a JDBC PreparedStatement
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - incrementIndexByBase
```
protected java.lang.Object incrementIndexByBase(java.lang.Object index)
```
  - writeElementToWhere
```
protected int writeElementToWhere(java.sql.PreparedStatement st,
                      java.lang.Object elt,
                      int i,
                      SessionImplementor session)
                           throws HibernateException,
                                  java.sql.SQLException
```
    Write the element to a JDBC PreparedStatement
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - writeIndexToWhere
```
protected int writeIndexToWhere(java.sql.PreparedStatement st,
                    java.lang.Object index,
                    int i,
                    SessionImplementor session)
                         throws HibernateException,
                                java.sql.SQLException
```
    Write the index to a JDBC PreparedStatement
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - writeIdentifier
```
public int writeIdentifier(java.sql.PreparedStatement st,
                  java.lang.Object id,
                  int i,
                  SessionImplementor session)
                    throws HibernateException,
                           java.sql.SQLException
```
    Write the identifier to a JDBC PreparedStatement
    
    Throws:
    
    HibernateException
    
    java.sql.SQLException
  - isPrimitiveArray
```
public boolean isPrimitiveArray()
```
    Description copied from interface: CollectionMetadata
    
    Is the collection a primitive array?
    
    Specified by:
    
    isPrimitiveArray in interface CollectionMetadata
    
    Specified by:
    
    isPrimitiveArray in interface CollectionPersister
  - isArray
```
public boolean isArray()
```
    Description copied from interface: CollectionMetadata
    
    Is the collection an array?
    
    Specified by:
    
    isArray in interface CollectionMetadata
    
    Specified by:
    
    isArray in interface CollectionPersister
  - getKeyColumnAliases
```
public java.lang.String[] getKeyColumnAliases(java.lang.String suffix)
```
    Description copied from interface: CollectionPersister
    
    Generates the collection's key column aliases, based on the given suffix.
    
    Specified by:
    
    getKeyColumnAliases in interface CollectionPersister
    
    Parameters:
    suffix - The suffix to use in the key column alias generation.
    
    Returns:
    The key column aliases.
  - getElementColumnAliases
```
public java.lang.String[] getElementColumnAliases(java.lang.String suffix)
```
    Description copied from interface: CollectionPersister
    
    Generates the collection's element column aliases, based on the given suffix.
    
    Specified by:
    
    getElementColumnAliases in interface CollectionPersister
    
    Parameters:
    suffix - The suffix to use in the element column alias generation.
    
    Returns:
    The key column aliases.
  - getIndexColumnAliases
```
public java.lang.String[] getIndexColumnAliases(java.lang.String suffix)
```
    Description copied from interface: CollectionPersister
    
    Generates the collection's index column aliases, based on the given suffix.
    
    Specified by:
    
    getIndexColumnAliases in interface CollectionPersister
    
    Parameters:
    suffix - The suffix to use in the index column alias generation.
    
    Returns:
    The key column aliases, or null if not indexed.
  - getIdentifierColumnAlias
```
public java.lang.String getIdentifierColumnAlias(java.lang.String suffix)
```
    Description copied from interface: CollectionPersister
    
    Generates the collection's identifier column aliases, based on the given suffix.
    
    Specified by:
    
    getIdentifierColumnAlias in interface CollectionPersister
    
    Parameters:
    suffix - The suffix to use in the key column alias generation.
    
    Returns:
    The key column aliases.
  - getIdentifierColumnName
```
public java.lang.String getIdentifierColumnName()
```
    Specified by:
    
    getIdentifierColumnName in interface SQLLoadableCollection
  - selectFragment
```
public java.lang.String selectFragment(java.lang.String alias,
                              java.lang.String columnSuffix)
```
    Generate a list of collection index, key and element columns
    
    Specified by:
    
    selectFragment in interface QueryableCollection
  - generateSelectSizeString
```
protected java.lang.String generateSelectSizeString(boolean isIntegerIndexed)
```
  - generateDetectRowByIndexString
```
protected java.lang.String generateDetectRowByIndexString()
```
  - generateSelectRowByIndexString
```
protected java.lang.String generateSelectRowByIndexString()
```
  - generateDetectRowByElementString
```
protected java.lang.String generateDetectRowByElementString()
```
  - generateSelectFragment
```
protected SelectFragment generateSelectFragment(java.lang.String alias,
                                    java.lang.String columnSuffix)
```
  - appendElementColumns
```
protected void appendElementColumns(SelectFragment frag,
                        java.lang.String elemAlias)
```
  - appendIndexColumns
```
protected void appendIndexColumns(SelectFragment frag,
                      java.lang.String alias)
```
  - appendIdentifierColumns
```
protected void appendIdentifierColumns(SelectFragment frag,
                           java.lang.String alias)
```
  - getIndexColumnNames
```
public java.lang.String[] getIndexColumnNames()
```
    Description copied from interface: QueryableCollection
    
    Get the names of the collection index columns if this is an indexed collection (optional operation)
    
    Specified by:
    
    getIndexColumnNames in interface QueryableCollection
  - getIndexFormulas
```
public java.lang.String[] getIndexFormulas()
```
    Description copied from interface: QueryableCollection
    
    Get the index formulas if this is an indexed collection (optional operation)
    
    Specified by:
    
    getIndexFormulas in interface QueryableCollection
  - getIndexColumnNames
```
public java.lang.String[] getIndexColumnNames(java.lang.String alias)
```
    Description copied from interface: QueryableCollection
    
    Get the names of the collection index columns if this is an indexed collection (optional operation), aliased by the given table alias
    
    Specified by:
    
    getIndexColumnNames in interface QueryableCollection
  - getElementColumnNames
```
public java.lang.String[] getElementColumnNames(java.lang.String alias)
```
    Description copied from interface: QueryableCollection
    
    Get the names of the collection element columns (or the primary key columns in the case of a one-to-many association), aliased by the given table alias
    
    Specified by:
    
    getElementColumnNames in interface QueryableCollection
  - getElementColumnNames
```
public java.lang.String[] getElementColumnNames()
```
    Description copied from interface: QueryableCollection
    
    Get the names of the collection element columns (or the primary key columns in the case of a one-to-many association)
    
    Specified by:
    
    getElementColumnNames in interface QueryableCollection
  - getKeyColumnNames
```
public java.lang.String[] getKeyColumnNames()
```
    Description copied from interface: Joinable
    
    The columns to join on
    
    Specified by:
    
    getKeyColumnNames in interface Joinable
  - hasIndex
```
public boolean hasIndex()
```
    Description copied from interface: CollectionMetadata
    
    Is this collection indexed?
    
    Specified by:
    
    hasIndex in interface CollectionMetadata
    
    Specified by:
    
    hasIndex in interface CollectionPersister
  - isLazy
```
public boolean isLazy()
```
    Description copied from interface: CollectionMetadata
    
    Is the collection lazily initialized?
    
    Specified by:
    
    isLazy in interface CollectionMetadata
    
    Specified by:
    
    isLazy in interface CollectionPersister
  - isInverse
```
public boolean isInverse()
```
    Description copied from interface: CollectionPersister
    
    Is this collection "inverse", so state changes are not propogated to the database.
    
    Specified by:
    
    isInverse in interface CollectionPersister
  - getTableName
```
public java.lang.String getTableName()
```
    Description copied from interface: Joinable
    
    The table to join to.
    
    Specified by:
    
    getTableName in interface Joinable
  - remove
```
public void remove(java.io.Serializable id,
          SessionImplementor session)
            throws HibernateException
```
    Description copied from interface: CollectionPersister
    
    Completely remove the persistent state of the collection
    
    Specified by:
    
    remove in interface CollectionPersister
    
    Throws:
    
    HibernateException
  - recreate
```
public void recreate(PersistentCollection collection,
            java.io.Serializable id,
            SessionImplementor session)
              throws HibernateException
```
    Description copied from interface: CollectionPersister
    
    (Re)create the collection's persistent state
    
    Specified by:
    
    recreate in interface CollectionPersister
    
    Throws:
    
    HibernateException
  - isRowDeleteEnabled
```
protected boolean isRowDeleteEnabled()
```
  - deleteRows
```
public void deleteRows(PersistentCollection collection,
              java.io.Serializable id,
              SessionImplementor session)
                throws HibernateException
```
    Description copied from interface: CollectionPersister
    
    Delete the persistent state of any elements that were removed from the collection
    
    Specified by:
    
    deleteRows in interface CollectionPersister
    
    Throws:
    
    HibernateException
  - isRowInsertEnabled
```
protected boolean isRowInsertEnabled()
```
  - insertRows
```
public void insertRows(PersistentCollection collection,
              java.io.Serializable id,
              SessionImplementor session)
                throws HibernateException
```
    Description copied from interface: CollectionPersister
    
    Insert the persistent state of any new collection elements
    
    Specified by:
    
    insertRows in interface CollectionPersister
    
    Throws:
    
    HibernateException
  - getRole
```
public java.lang.String getRole()
```
    Description copied from interface: CollectionMetadata
    
    The name of this collection role
    
    Specified by:
    
    getRole in interface CollectionMetadata
    
    Specified by:
    
    getRole in interface CollectionPersister
  - getOwnerEntityName
```
public java.lang.String getOwnerEntityName()
```
  - getOwnerEntityPersister
```
public EntityPersister getOwnerEntityPersister()
```
    Description copied from interface: CollectionPersister
    
    Get the persister of the entity that "owns" this collection
    
    Specified by:
    
    getOwnerEntityPersister in interface CollectionPersister
  - getIdentifierGenerator
```
public IdentifierGenerator getIdentifierGenerator()
```
    Description copied from interface: CollectionPersister
    
    Get the surrogate key generation strategy (optional operation)
    
    Specified by:
    
    getIdentifierGenerator in interface CollectionPersister
  - getIdentifierType
```
public Type getIdentifierType()
```
    Description copied from interface: CollectionPersister
    
    Get the type of the surrogate key
    
    Specified by:
    
    getIdentifierType in interface CollectionPersister
  - hasOrphanDelete
```
public boolean hasOrphanDelete()
```
    Description copied from interface: CollectionPersister
    
    Does this collection implement "orphan delete"?
    
    Specified by:
    
    hasOrphanDelete in interface CollectionPersister
  - toType
```
public Type toType(java.lang.String propertyName)
            throws QueryException
```
    Description copied from interface: PropertyMapping
    
    Given a component path expression, get the type of the property
    
    Specified by:
    
    toType in interface PropertyMapping
    
    Throws:
    
    QueryException
  - isManyToMany
```
public abstract 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
  - getManyToManyFilterFragment
```
public java.lang.String getManyToManyFilterFragment(java.lang.String alias,
                                           java.util.Map enabledFilters)
```
    Specified by:
    
    getManyToManyFilterFragment in interface CollectionPersister
  - toColumns
```
public java.lang.String[] toColumns(java.lang.String alias,
                           java.lang.String propertyName)
                             throws QueryException
```
    Given a query alias and a property path, return the qualified column name
    
    Specified by:
    
    toColumns in interface PropertyMapping
    
    Throws:
    
    QueryException
  - toColumns
```
public java.lang.String[] toColumns(java.lang.String propertyName)
                             throws QueryException
```
    Given a property path, return the corresponding column name(s).
    
    Specified by:
    
    toColumns in interface PropertyMapping
    
    Throws:
    
    QueryException
  - getType
```
public Type getType()
```
    Description copied from interface: PropertyMapping
    
    Get the type of the thing containing the properties
    
    Specified by:
    
    getType in interface PropertyMapping
  - getName
```
public java.lang.String getName()
```
    Description copied from interface: Joinable
    
    An identifying name; a class name or collection role name.
    
    Specified by:
    
    getName in interface Joinable
  - getElementPersister
```
public EntityPersister getElementPersister()
```
    Description copied from interface: QueryableCollection
    
    Get the persister of the element class, if this is a collection of entities (optional operation). Note that for a one-to-many association, the returned persister must be OuterJoinLoadable.
    
    Specified by:
    
    getElementPersister in interface QueryableCollection
  - isCollection
```
public boolean isCollection()
```
    Description copied from interface: Joinable
    
    Is this instance actually a CollectionPersister?
    
    Specified by:
    
    isCollection in interface Joinable
  - getCollectionSpaces
```
public java.io.Serializable[] getCollectionSpaces()
```
    Description copied from interface: CollectionPersister
    
    Get the "space" that holds the persistent state
    
    Specified by:
    
    getCollectionSpaces in interface CollectionPersister
  - generateDeleteString
```
protected abstract java.lang.String generateDeleteString()
```
  - generateDeleteRowString
```
protected abstract java.lang.String generateDeleteRowString()
```
  - generateUpdateRowString
```
protected abstract java.lang.String generateUpdateRowString()
```
  - generateInsertRowString
```
protected abstract java.lang.String generateInsertRowString()
```
  - updateRows
```
public void updateRows(PersistentCollection collection,
              java.io.Serializable id,
              SessionImplementor session)
                throws HibernateException
```
    Description copied from interface: CollectionPersister
    
    Update the persistent state of any elements that were modified
    
    Specified by:
    
    updateRows in interface CollectionPersister
    
    Throws:
    
    HibernateException
  - doUpdateRows
```
protected abstract int doUpdateRows(java.io.Serializable key,
               PersistentCollection collection,
               SessionImplementor session)
                             throws HibernateException
```
    Throws:
    
    HibernateException
  - getCollectionMetadata
```
public CollectionMetadata getCollectionMetadata()
```
    Specified by:
    
    getCollectionMetadata in interface CollectionPersister
  - getFactory
```
public SessionFactoryImplementor getFactory()
```
    Specified by:
    
    getFactory in interface CollectionPersister
  - filterFragment
```
protected java.lang.String filterFragment(java.lang.String alias)
                                   throws MappingException
```
    Throws:
    
    MappingException
  - filterFragment
```
public java.lang.String filterFragment(java.lang.String alias,
                              java.util.Map enabledFilters)
                                throws MappingException
```
    Description copied from interface: Joinable
    
    Get the where clause filter, given a query alias and considering enabled session filters
    
    Specified by:
    
    filterFragment in interface Joinable
    
    Throws:
    
    MappingException
  - oneToManyFilterFragment
```
public java.lang.String oneToManyFilterFragment(java.lang.String alias)
                                         throws MappingException
```
    Specified by:
    
    oneToManyFilterFragment in interface Joinable
    
    Throws:
    
    MappingException
  - isInsertCallable
```
protected boolean isInsertCallable()
```
  - getInsertCheckStyle
```
protected ExecuteUpdateResultCheckStyle getInsertCheckStyle()
```
  - isUpdateCallable
```
protected boolean isUpdateCallable()
```
  - getUpdateCheckStyle
```
protected ExecuteUpdateResultCheckStyle getUpdateCheckStyle()
```
  - isDeleteCallable
```
protected boolean isDeleteCallable()
```
  - getDeleteCheckStyle
```
protected ExecuteUpdateResultCheckStyle getDeleteCheckStyle()
```
  - isDeleteAllCallable
```
protected boolean isDeleteAllCallable()
```
  - getDeleteAllCheckStyle
```
protected ExecuteUpdateResultCheckStyle getDeleteAllCheckStyle()
```
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - isVersioned
```
public boolean isVersioned()
```
    Description copied from interface: CollectionPersister
    
    Does this collection cause version increment of the owning entity?
    
    Specified by:
    
    isVersioned in interface CollectionPersister
  - getNodeName
```
public java.lang.String getNodeName()
```
    Specified by:
    
    getNodeName in interface CollectionPersister
  - getElementNodeName
```
public java.lang.String getElementNodeName()
```
    Specified by:
    
    getElementNodeName in interface CollectionPersister
  - getIndexNodeName
```
public java.lang.String getIndexNodeName()
```
    Specified by:
    
    getIndexNodeName in interface CollectionPersister
  - getSQLExceptionConverter
```
protected SQLExceptionConverter getSQLExceptionConverter()
```
  - getCacheEntryStructure
```
public CacheEntryStructure getCacheEntryStructure()
```
    Description copied from interface: CollectionPersister
    
    Get the cache structure
    
    Specified by:
    
    getCacheEntryStructure in interface CollectionPersister
  - isAffectedByEnabledFilters
```
public boolean isAffectedByEnabledFilters(SessionImplementor session)
```
    Specified by:
    
    isAffectedByEnabledFilters in interface CollectionPersister
  - isSubselectLoadable
```
public boolean isSubselectLoadable()
```
  - isMutable
```
public boolean isMutable()
```
    Description copied from interface: CollectionPersister
    
    Can the elements of this collection change?
    
    Specified by:
    
    isMutable in interface CollectionPersister
  - getCollectionPropertyColumnAliases
```
public java.lang.String[] getCollectionPropertyColumnAliases(java.lang.String propertyName,
                                                    java.lang.String suffix)
```
    Specified by:
    
    getCollectionPropertyColumnAliases in interface SQLLoadableCollection
  - initCollectionPropertyMap
```
public void initCollectionPropertyMap()
```
  - getSize
```
public int getSize(java.io.Serializable key,
          SessionImplementor session)
```
    Specified by:
    
    getSize in interface CollectionPersister
  - indexExists
```
public boolean indexExists(java.io.Serializable key,
                  java.lang.Object index,
                  SessionImplementor session)
```
    Specified by:
    
    indexExists in interface CollectionPersister
  - elementExists
```
public boolean elementExists(java.io.Serializable key,
                    java.lang.Object element,
                    SessionImplementor session)
```
    Specified by:
    
    elementExists in interface CollectionPersister
  - getElementByIndex
```
public java.lang.Object getElementByIndex(java.io.Serializable key,
                                 java.lang.Object index,
                                 SessionImplementor session,
                                 java.lang.Object owner)
```
    Specified by:
    
    getElementByIndex in interface CollectionPersister
  - isExtraLazy
```
public boolean isExtraLazy()
```
    Specified by:
    
    isExtraLazy in interface CollectionPersister
  - getDialect
```
protected Dialect getDialect()
```
  - getInitializer
```
public CollectionInitializer getInitializer()
```
    Intended for internal use only. In fact really only currently used from test suite for assertion purposes.
    
    Returns:
    The default collection initializer for this persister/collection.

Class AbstractCollectionPersister

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.hibernate.persister.entity.Joinable

Methods inherited from interface org.hibernate.persister.collection.CollectionPersister

Field Detail

sqlWhereString

hasWhere

indexContainsFormula

elementIsPureFormula

elementType

keyColumnNames

indexColumnNames

indexFormulaTemplates

indexFormulas

indexColumnIsSettable

elementColumnNames

elementColumnWriters

elementColumnReaders

elementColumnReaderTemplates

elementFormulaTemplates

elementFormulas

elementColumnIsSettable

elementColumnIsInPrimaryKey

indexColumnAliases

elementColumnAliases

keyColumnAliases

identifierColumnName

qualifiedTableName

hasIndex

hasIdentifier

batchSize

Constructor Detail

AbstractCollectionPersister

Method Detail

postInstantiate

logStaticSQL

initialize

getAppropriateInitializer

createSubselectInitializer

createCollectionInitializer

getCacheAccessStrategy

hasCache

getCollectionType

getSQLWhereString

getSQLOrderByString

getManyToManyOrderByString

getFetchMode

hasOrdering

hasManyToManyOrdering

hasWhere

getSQLDeleteString

getSQLInsertRowString

getSQLUpdateRowString

getSQLDeleteRowString

getKeyType

getIndexType

getElementType

getElementClass

readElement

readIndex

decrementIndexByBase

readIdentifier

readKey

writeKey

writeElement

writeIndex

incrementIndexByBase

writeElementToWhere

writeIndexToWhere

writeIdentifier

isPrimitiveArray

isArray

getKeyColumnAliases

getElementColumnAliases

getIndexColumnAliases

getIdentifierColumnAlias

getIdentifierColumnName