站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Hibernate 3.2.3 正式版 API 英文文档

UserCollectionType (Hibernate API Documentation) - Hibernate 3.2.3 正式版 API 英文文档


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
 boolean contains(Object collection, Object entity)
          Optional operation.
 Iterator getElementsIterator(Object collection)
          Return an iterator over the elements of this collection - the passed collection instance may or may not be a wrapper
 Object indexOf(Object collection, Object entity)
          Optional operation.
 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
 Object replaceElements(Object original, Object target, CollectionPersister persister, Object owner, Map copyCache, SessionImplementor session)
          Replace the elements of a collection with the elements of another collection
 PersistentCollection wrap(SessionImplementor session, Object collection)
          Wrap an instance of a collection
 

Method Detail

instantiate

public PersistentCollection instantiate(SessionImplementor session,
                                        CollectionPersister persister)
                                 throws HibernateException
Instantiate an uninitialized instance of the collection wrapper

Throws:
HibernateException

wrap

public PersistentCollection wrap(SessionImplementor session,
                                 Object collection)
Wrap an instance of a collection


getElementsIterator

public Iterator getElementsIterator(Object collection)
Return an iterator over the elements of this collection - the passed collection instance may or may not be a wrapper


contains

public boolean contains(Object collection,
                        Object entity)
Optional operation. Does the collection contain the entity instance?


indexOf

public Object indexOf(Object collection,
                      Object entity)
Optional operation. Return the index of the entity in the collection.


replaceElements

public Object replaceElements(Object original,
                              Object target,
                              CollectionPersister persister,
                              Object owner,
                              Map copyCache,
                              SessionImplementor session)
                       throws HibernateException
Replace the elements of a collection with the elements of another collection

Throws:
HibernateException

instantiate

public 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).