org.hibernate.usertype

Interface UserCollectionType

public interface UserCollectionType

A custom type for mapping user-written classes that implement PersistentCollection

Author:

Gavin King

See Also:

PersistentCollection

Method Summary

Methods

Modifier and Type	Method and Description
boolean	contains(java.lang.Object collection, java.lang.Object entity) Optional operation.
java.util.Iterator	getElementsIterator(java.lang.Object collection) Return an iterator over the elements of this collection - the passed collection instance may or may not be a wrapper
java.lang.Object	indexOf(java.lang.Object collection, java.lang.Object entity) Optional operation.
java.lang.Object	instantiate(int anticipatedSize) Instantiate an empty instance of the "underlying" collection (not a wrapper), but with the given anticipated size (i.e.
PersistentCollection	instantiate(SessionImplementor session, CollectionPersister persister) Instantiate an uninitialized instance of the collection wrapper
java.lang.Object	replaceElements(java.lang.Object original, java.lang.Object target, CollectionPersister persister, java.lang.Object owner, java.util.Map copyCache, SessionImplementor session) Replace the elements of a collection with the elements of another collection
PersistentCollection	wrap(SessionImplementor session, java.lang.Object collection) Wrap an instance of a collection

Method Detail

instantiate

PersistentCollection instantiate(SessionImplementor session,
                               CollectionPersister persister)
                                 throws HibernateException

Instantiate an uninitialized instance of the collection wrapper

Throws:

HibernateException

wrap

PersistentCollection wrap(SessionImplementor session,
                        java.lang.Object collection)

Wrap an instance of a collection

getElementsIterator

java.util.Iterator getElementsIterator(java.lang.Object collection)

Return an iterator over the elements of this collection - the passed collection instance may or may not be a wrapper

contains

boolean contains(java.lang.Object collection,
               java.lang.Object entity)

Optional operation. Does the collection contain the entity instance?

indexOf

java.lang.Object indexOf(java.lang.Object collection,
                       java.lang.Object entity)

Optional operation. Return the index of the entity in the collection.

replaceElements

java.lang.Object replaceElements(java.lang.Object original,
                               java.lang.Object target,
                               CollectionPersister persister,
                               java.lang.Object owner,
                               java.util.Map copyCache,
                               SessionImplementor session)
                                 throws HibernateException

Replace the elements of a collection with the elements of another collection

Throws:

HibernateException

instantiate

java.lang.Object instantiate(int anticipatedSize)

Instantiate an empty instance of the "underlying" collection (not a wrapper), but with the given anticipated size (i.e. accounting for initial size and perhaps load factor).

Parameters:

anticipatedSize - The anticipated size of the instaniated collection after we are done populating it. Note, may be negative to indicate that we not yet know anything about the anticipated size (i.e., when initializing from a result set row by row).