ca.odell.glazedlists.hibernate

Class PersistentEventList

java.lang.Object

PersistentList

ca.odell.glazedlists.hibernate.PersistentEventList

All Implemented Interfaces:

ListEventListener, EventList, java.lang.Iterable, java.util.Collection, java.util.EventListener, java.util.List

public final class PersistentEventList
extends PersistentList
implements EventList, ListEventListener

A Hibernate persistent wrapper for an EventList. Underlying collection implementation is BasicEventList.

Author:

Bruce Alspaugh, Holger Brands, James Lemieux

Field Summary

Fields

Modifier and Type	Field and Description
protected ListEventAssembler	updates the change event and notification system

Constructor Summary

Constructors

Constructor and Description
PersistentEventList(SessionImplementor session, EventList newList) Constructor with session and EventList.
PersistentEventList(SessionImplementor session, EventListFactory listFactory) Constructor with session.

Method Summary

Modifier and Type	Method and Description
void	addListEventListener(ListEventListener listChangeListener) Registers the specified listener to receive change updates for this list.
void	beforeInitialize(CollectionPersister persister) Kept for compatibility with older Hibernate versions.
void	beforeInitialize(CollectionPersister persister, int anticipatedSize)
void	dispose() Disposing an EventList will make it eligible for garbage collection.
ListEventPublisher	getPublisher() Get the publisher used to distribute ListEvents.
ReadWriteLock	getReadWriteLock() Gets the lock required to share this list between multiple threads.
void	listChanged(ListEvent listChanges) When the underlying list changes, this notification allows the object to repaint itself or update itself as necessary.
void	removeListEventListener(ListEventListener listChangeListener) Removes the specified listener from receiving change updates for this list.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

updates

protected transient ListEventAssembler updates

the change event and notification system

Constructor Detail

PersistentEventList

public PersistentEventList(SessionImplementor session,
                           EventListFactory listFactory)

Constructor with session.

Parameters:

session - the session

listFactory - factory for EventLists

PersistentEventList

public PersistentEventList(SessionImplementor session,
                           EventList newList)

Constructor with session and EventList.

Parameters:

session - the session

newList - the EventList

Method Detail

beforeInitialize

public void beforeInitialize(CollectionPersister persister)

Kept for compatibility with older Hibernate versions.

beforeInitialize

public void beforeInitialize(CollectionPersister persister,
                             int anticipatedSize)

getPublisher

public ListEventPublisher getPublisher()

Get the publisher used to distribute ListEvents. It's always defined.

Specified by:

getPublisher in interface EventList

getReadWriteLock

public ReadWriteLock getReadWriteLock()

Gets the lock required to share this list between multiple threads. It's always defined.

Specified by:

getReadWriteLock in interface EventList

Returns:

a re-entrant ReadWriteLock that guarantees thread safe access to this list.

addListEventListener

public void addListEventListener(ListEventListener listChangeListener)

Registers the specified listener to receive change updates for this list.

Specified by:

addListEventListener in interface EventList

Parameters:

listChangeListener - event listener != null

removeListEventListener

public void removeListEventListener(ListEventListener listChangeListener)

Removes the specified listener from receiving change updates for this list.

Specified by:

removeListEventListener in interface EventList

Parameters:

listChangeListener - event listener != null

listChanged

public void listChanged(ListEvent listChanges)

When the underlying list changes, this notification allows the object to repaint itself or update itself as necessary.

It is mandatory that the calling thread has obtained the write lock on the source list. This is because the calling thread will have written to the source list to cause this event. This condition guarantees that no writes can occur while the listener is handling this event. It is an error to write to the source list while processing an event.

Specified by:

listChanged in interface ListEventListener

Parameters:

listChanges - a ListEvent describing the changes to the list

dispose

public void dispose()

Disposing an EventList will make it eligible for garbage collection. Some EventLists install themselves as listeners to related objects so disposing them is necessary.

Warning: It is an error to call any method on an EventList after it has been disposed.

Specified by:

dispose in interface EventList