public class

PersistentList

extends AbstractPersistentCollection
implements List<E>

java.lang.Object
↳	org.hibernate.collection.AbstractPersistentCollection
	↳	org.hibernate.collection.PersistentList

Class Overview

A persistent wrapper for a java.util.List. Underlying collection is an ArrayList.

Summary

Fields
protected List	list

[Expand]

Inherited Fields

From class org.hibernate.collection.AbstractPersistentCollection

Public Constructors
	PersistentList(SessionImplementor session)
	PersistentList(SessionImplementor session, List list)
	PersistentList()

Public Methods
boolean	add(Object object)
void	add(int index, Object value)
boolean	addAll(Collection values)
boolean	addAll(int index, Collection coll)
void	beforeInitialize(CollectionPersister persister, int anticipatedSize)
void	clear()
boolean	contains(Object object)
boolean	containsAll(Collection coll)
Serializable	disassemble(CollectionPersister persister)
boolean	empty() Is the initialized collection empty?
Iterator	entries(CollectionPersister persister)
boolean	entryExists(Object entry, int i)
boolean	equals(Object other)
boolean	equalsSnapshot(CollectionPersister persister)
Object	get(int index)
Iterator	getDeletes(CollectionPersister persister, boolean indexIsFormula)
Object	getElement(Object entry)
Object	getIndex(Object entry, int i, CollectionPersister persister)
Collection	getOrphans(Serializable snapshot, String entityName) get all "orphaned" elements
Serializable	getSnapshot(CollectionPersister persister)
Object	getSnapshotElement(Object entry, int i)
int	hashCode()
int	indexOf(Object value)
void	initializeFromCache(CollectionPersister persister, Serializable disassembled, Object owner)
boolean	isEmpty()
boolean	isSnapshotEmpty(Serializable snapshot)
boolean	isWrapper(Object collection)
Iterator	iterator()
int	lastIndexOf(Object value)
ListIterator	listIterator(int index)
ListIterator	listIterator()
boolean	needsInserting(Object entry, int i, Type elemType)
boolean	needsUpdating(Object entry, int i, Type elemType)
Object	readFrom(ResultSet rs, CollectionPersister persister, CollectionAliases descriptor, Object owner)
Object	remove(int index)
boolean	remove(Object value)
boolean	removeAll(Collection coll)
boolean	retainAll(Collection coll)
Object	set(int index, Object value)
int	size()
List	subList(int from, int to)
Object[]	toArray(Object[] array)
Object[]	toArray()
String	toString()

[Expand]

Inherited Methods

From class org.hibernate.collection.AbstractPersistentCollection

boolean	afterInitialize() Called after initializing from cache
void	afterRowInsert(CollectionPersister persister, Object entry, int i) Called after inserting a row, to fetch the natively generated id
void	beginRead() Called just before reading any rows from the JDBC result set
final void	clearDirty() Clear the dirty flag, after flushing changes to the database.
final void	dirty() Mark the collection as dirty
abstract boolean	empty() Is the initialized collection empty?
boolean	endRead() Called after reading all rows from the JDBC result set
final void	forceInitialization() To be called internally by the session, forcing immediate initialization.
int	getCachedSize()
Object	getIdentifier(Object entry, int i) Get the index of the given collection entry
final Serializable	getKey() Get the current collection key value
abstract Collection	getOrphans(Serializable snapshot, String entityName) get all "orphaned" elements
static Collection	getOrphans(Collection oldElements, Collection currentElements, String entityName, SessionImplementor session) Given a collection of entity instances that used to belong to the collection, and a collection of instances that currently belong, return a collection of orphans
Object	getOwner() Get the owning entity.
final Collection	getQueuedOrphans(String entityName) Iterate the "queued" additions
final String	getRole() Get the current role name
final SessionImplementor	getSession() Get the current session
final Serializable	getSnapshot() Get the current snapshot from the session
final Serializable	getStoredSnapshot() Get the snapshot cached by the collection instance
Object	getValue() return the user-visible collection (or array) instance
final boolean	hasQueuedOperations() Does this instance have any "queued" additions?
final void	initialize(boolean writing) Initialize the collection, if possible, wrapping any exceptions in a runtime exception
boolean	isClearQueueEnabled() Is this collection in a state that would allow us to "queue" clear? This is a special case, because of orphan delete.
boolean	isDirectlyAccessible() Could the application possibly have a direct reference to the underlying collection implementation?
final boolean	isDirty() Is the collection dirty? Note that this is only reliable during the flush cycle, after the collection elements are dirty checked against the snapshot.
boolean	isOperationQueueEnabled() Is this collection in a state that would allow us to "queue" operations?
boolean	isPutQueueEnabled() Is this collection in a state that would allow us to "queue" puts? This is a special case, because of orphan delete.
boolean	isRowUpdatePossible()
final boolean	isUnreferenced() Is the collection unreferenced?
boolean	needsRecreate(CollectionPersister persister) Do we need to completely recreate this collection when it changes?
final void	performQueuedOperations() After reading all existing elements from the database, add the queued elements to the underlying collection.
void	postAction() After flushing, clear any "queued" additions, since the database state is now synchronized with the memory state.
void	preInsert(CollectionPersister persister) Called before inserting rows, to ensure that any surrogate keys are fully generated
final void	queueOperation(Object element) Queue an addition
final Iterator	queuedAdditionIterator() Iterate the "queued" additions
final void	read() Called by any read-only method of the collection interface
Object	readElementByIndex(Object index)
Boolean	readElementExistence(Object element)
Boolean	readIndexExistence(Object index)
boolean	readSize() Called by the `size()` method
final boolean	setCurrentSession(SessionImplementor session) Associate the collection with the given session.
final void	setDirectlyAccessible(boolean directlyAccessible)
final void	setInitialized()
void	setOwner(Object owner) Set the reference to the owning entity
void	setSnapshot(Serializable key, String role, Serializable snapshot) After flushing, re-init snapshot state.
final boolean	unsetSession(SessionImplementor currentSession) Disassociate this collection from the given session.
final boolean	wasInitialized() Is this instance initialized?
final void	write() Called by any writer method of the collection interface

From class java.lang.Object

From interface java.lang.Iterable

From interface java.util.Collection

abstract boolean	add(E arg0)
abstract boolean	addAll(Collection<? extends E> arg0)
abstract void	clear()
abstract boolean	contains(Object arg0)
abstract boolean	containsAll(Collection<?> arg0)
abstract boolean	equals(Object arg0)
abstract int	hashCode()
abstract boolean	isEmpty()
abstract Iterator<E>	iterator()
abstract boolean	remove(Object arg0)
abstract boolean	removeAll(Collection<?> arg0)
abstract boolean	retainAll(Collection<?> arg0)
abstract int	size()
abstract <T> T[]	toArray(T[] arg0)
abstract Object[]	toArray()

From interface java.util.List

abstract boolean	add(E arg0)
abstract void	add(int arg0, E arg1)
abstract boolean	addAll(Collection<? extends E> arg0)
abstract boolean	addAll(int arg0, Collection<? extends E> arg1)
abstract void	clear()
abstract boolean	contains(Object arg0)
abstract boolean	containsAll(Collection<?> arg0)
abstract boolean	equals(Object arg0)
abstract E	get(int arg0)
abstract int	hashCode()
abstract int	indexOf(Object arg0)
abstract boolean	isEmpty()
abstract Iterator<E>	iterator()
abstract int	lastIndexOf(Object arg0)
abstract ListIterator<E>	listIterator(int arg0)
abstract ListIterator<E>	listIterator()
abstract E	remove(int arg0)
abstract boolean	remove(Object arg0)
abstract boolean	removeAll(Collection<?> arg0)
abstract boolean	retainAll(Collection<?> arg0)
abstract E	set(int arg0, E arg1)
abstract int	size()
abstract List<E>	subList(int arg0, int arg1)
abstract <T> T[]	toArray(T[] arg0)
abstract Object[]	toArray()

From interface org.hibernate.collection.PersistentCollection

abstract boolean	afterInitialize() Called after initializing from cache
abstract void	afterRowInsert(CollectionPersister persister, Object entry, int i) Called after inserting a row, to fetch the natively generated id
abstract void	beforeInitialize(CollectionPersister persister, int anticipatedSize) Called before any elements are read into the collection, allowing appropriate initializations to occur.
abstract void	beginRead() Called just before reading any rows from the JDBC result set
abstract void	clearDirty() Clear the dirty flag, after flushing changes to the database.
abstract void	dirty() Mark the collection as dirty
abstract Serializable	disassemble(CollectionPersister persister) Disassemble the collection, ready for the cache
abstract boolean	empty() Is the collection empty? (don't try to initialize the collection)
abstract boolean	endRead() Called after reading all rows from the JDBC result set
abstract Iterator	entries(CollectionPersister persister) Iterate all collection entries, during update of the database
abstract boolean	entryExists(Object entry, int i) Does an element exist at this entry in the collection?
abstract boolean	equalsSnapshot(CollectionPersister persister) Does the current state exactly match the snapshot?
abstract void	forceInitialization() To be called internally by the session, forcing immediate initialization.
abstract Iterator	getDeletes(CollectionPersister persister, boolean indexIsFormula) Get all the elements that need deleting
abstract Object	getElement(Object entry) Get the value of the given collection entry
abstract Object	getIdentifier(Object entry, int i) Get the index of the given collection entry
abstract Object	getIndex(Object entry, int i, CollectionPersister persister) Get the index of the given collection entry
abstract Serializable	getKey() Get the current collection key value
abstract Collection	getOrphans(Serializable snapshot, String entityName) get all "orphaned" elements
abstract Object	getOwner() Get the owning entity.
abstract Collection	getQueuedOrphans(String entityName) Get the "queued" orphans
abstract String	getRole() Get the current role name
abstract Serializable	getSnapshot(CollectionPersister persister) Return a new snapshot of the current state of the collection
abstract Object	getSnapshotElement(Object entry, int i) Get the snapshot value of the given collection entry
abstract Serializable	getStoredSnapshot() Get the snapshot cached by the collection instance
abstract Object	getValue() return the user-visible collection (or array) instance
abstract boolean	hasQueuedOperations() Does this instance have any "queued" additions?
abstract void	initializeFromCache(CollectionPersister persister, Serializable disassembled, Object owner) Read the state of the collection from a disassembled cached value
abstract boolean	isDirectlyAccessible() Could the application possibly have a direct reference to the underlying collection implementation?
abstract boolean	isDirty() Is the collection dirty? Note that this is only reliable during the flush cycle, after the collection elements are dirty checked against the snapshot.
abstract boolean	isRowUpdatePossible()
abstract boolean	isSnapshotEmpty(Serializable snapshot) Is the snapshot empty?
abstract boolean	isUnreferenced() Is the collection unreferenced?
abstract boolean	isWrapper(Object collection) Is this the wrapper for the given underlying collection instance?
abstract boolean	needsInserting(Object entry, int i, Type elemType) Do we need to insert this element?
abstract boolean	needsRecreate(CollectionPersister persister) Do we need to completely recreate this collection when it changes?
abstract boolean	needsUpdating(Object entry, int i, Type elemType) Do we need to update this element?
abstract void	postAction() After flushing, clear any "queued" additions, since the database state is now synchronized with the memory state.
abstract void	preInsert(CollectionPersister persister) Called before inserting rows, to ensure that any surrogate keys are fully generated
abstract Iterator	queuedAdditionIterator() Iterate the "queued" additions
abstract Object	readFrom(ResultSet rs, CollectionPersister role, CollectionAliases descriptor, Object owner) Read a row from the JDBC result set
abstract boolean	setCurrentSession(SessionImplementor session) Associate the collection with the given session.
abstract void	setOwner(Object entity) Set the reference to the owning entity
abstract void	setSnapshot(Serializable key, String role, Serializable snapshot) After flushing, re-init snapshot state.
abstract boolean	unsetSession(SessionImplementor currentSession) Disassociate this collection from the given session.
abstract boolean	wasInitialized() Is this instance initialized?

Fields

protected List list

Public Constructors

public PersistentList (SessionImplementor session)

public PersistentList (SessionImplementor session, List list)

public PersistentList ()

Public Methods

public boolean add (Object object)

public void add (int index, Object value)

public boolean addAll (Collection values)

public boolean addAll (int index, Collection coll)

public void beforeInitialize (CollectionPersister persister, int anticipatedSize)

public void clear ()

public boolean contains (Object object)

public boolean containsAll (Collection coll)

public Serializable disassemble (CollectionPersister persister)

Throws

HibernateException

public boolean empty ()

Is the initialized collection empty?

public Iterator entries (CollectionPersister persister)

public boolean entryExists (Object entry, int i)

public boolean equals (Object other)

public boolean equalsSnapshot (CollectionPersister persister)

Throws

HibernateException

public Object get (int index)

public Iterator getDeletes (CollectionPersister persister, boolean indexIsFormula)

Throws

HibernateException

public Object getElement (Object entry)

public Object getIndex (Object entry, int i, CollectionPersister persister)

public Collection getOrphans (Serializable snapshot, String entityName)

get all "orphaned" elements

Throws

HibernateException

public Serializable getSnapshot (CollectionPersister persister)

Throws

HibernateException

public Object getSnapshotElement (Object entry, int i)

public int hashCode ()

public int indexOf (Object value)

public void initializeFromCache (CollectionPersister persister, Serializable disassembled, Object owner)

Throws

HibernateException

public boolean isEmpty ()

public boolean isSnapshotEmpty (Serializable snapshot)

public boolean isWrapper (Object collection)

public Iterator iterator ()

public int lastIndexOf (Object value)

public ListIterator listIterator (int index)

public ListIterator listIterator ()

public boolean needsInserting (Object entry, int i, Type elemType)

Throws

HibernateException

public boolean needsUpdating (Object entry, int i, Type elemType)

Throws

HibernateException

public Object readFrom (ResultSet rs, CollectionPersister persister, CollectionAliases descriptor, Object owner)

Throws

HibernateException
SQLException

Interfaces

Classes

PersistentList

Class Overview

See Also

Summary

Fields

protected List list

Public Constructors

public PersistentList (SessionImplementor session)

public PersistentList (SessionImplementor session, List list)

public PersistentList ()

Public Methods

public boolean add (Object object)

See Also

public void add (int index, Object value)

See Also

public boolean addAll (Collection values)

See Also

public boolean addAll (int index, Collection coll)

See Also

public void beforeInitialize (CollectionPersister persister, int anticipatedSize)

public void clear ()

See Also

public boolean contains (Object object)

See Also

public boolean containsAll (Collection coll)

See Also

public Serializable disassemble (CollectionPersister persister)

Throws

public boolean empty ()

public Iterator entries (CollectionPersister persister)

public boolean entryExists (Object entry, int i)

public boolean equals (Object other)

public boolean equalsSnapshot (CollectionPersister persister)

Throws

public Object get (int index)

See Also

public Iterator getDeletes (CollectionPersister persister, boolean indexIsFormula)

Throws

public Object getElement (Object entry)

public Object getIndex (Object entry, int i, CollectionPersister persister)

public Collection getOrphans (Serializable snapshot, String entityName)

Throws

public Serializable getSnapshot (CollectionPersister persister)

Throws

public Object getSnapshotElement (Object entry, int i)

public int hashCode ()

public int indexOf (Object value)

See Also

public void initializeFromCache (CollectionPersister persister, Serializable disassembled, Object owner)

Throws

public boolean isEmpty ()

See Also

public boolean isSnapshotEmpty (Serializable snapshot)

public boolean isWrapper (Object collection)

public Iterator iterator ()

See Also

public int lastIndexOf (Object value)

See Also

public ListIterator listIterator (int index)

See Also

public ListIterator listIterator ()

See Also

public boolean needsInserting (Object entry, int i, Type elemType)

Throws

public boolean needsUpdating (Object entry, int i, Type elemType)

Throws

public Object readFrom (ResultSet rs, CollectionPersister persister, CollectionAliases descriptor, Object owner)

Throws

public Object remove (int index)

See Also

public boolean remove (Object value)

See Also

public boolean removeAll (Collection coll)

See Also

public boolean retainAll (Collection coll)

See Also

public Object set (int index, Object value)

See Also