Skip navigation links

org.eclipse.persistence.indirection
Class IndirectList

java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractList<E>
java.util.Vector
org.eclipse.persistence.indirection.IndirectList

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess, ChangeTracker, CollectionChangeTracker, IndirectCollection, IndirectContainer

public class IndirectList

extends java.util.Vector

implements CollectionChangeTracker, IndirectCollection

IndirectList allows a domain class to take advantage of TopLink indirection without having to declare its instance variable as a ValueHolderInterface.

To use an IndirectList:

• Declare the appropriate instance variable with type IndirectList (jdk1.1) or Collection/List/Vector (jdk1.2).
• Send the message #useTransparentCollection() to the appropriate CollectionMapping.

TopLink will place an IndirectList in the instance variable when the containing domain object is read from the datatabase. With the first message sent to the IndirectList, the contents are fetched from the database and normal Collection/List/Vector behavior is resumed.

Since:

TOPLink/Java 2.5

Author:

Big Country

See Also:

CollectionMapping, IndirectMap, Serialized Form

Field Summary

private java.util.List	addedElements Store added elements to avoid instantiation on add.
private java.lang.String	attributeName The mapping attribute name, used to raise change events.
private java.beans.PropertyChangeListener	changeListener Change tracking listener.
protected java.util.Vector	delegate Reduce type casting.
protected int	initialCapacity Store initial size for lazy init.
private boolean	isListOrderBrokenInDb If the mapping using IndirectList has listOrderfield !
protected boolean	isRegistered PERF: Quick check flag if has been registered in a unit of work.
private java.util.List	removedElements Store removed elements to avoid instantiation on remove.
private boolean	useLazyInstantiation This value is used to determine if we should attempt to do adds and removes from the list without actually instantiating the list from the database.
protected ValueHolderInterface	valueHolder Delegate indirection behavior to a value holder.

Fields inherited from class java.util.Vector

capacityIncrement, elementCount, elementData

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

IndirectList()
PUBLIC: Construct an empty IndirectList so that its internal data array has size 10 and its standard capacity increment is zero.

IndirectList(java.util.Collection collection)
PUBLIC: Construct an IndirectList containing the elements of the specified collection, in the order they are returned by the collection's iterator.

IndirectList(int initialCapacity)
PUBLIC: Construct an empty IndirectList with the specified initial capacity and with its capacity increment equal to zero.

IndirectList(int initialCapacity, int capacityIncrement)
PUBLIC: Construct an empty IndirectList with the specified initial capacity and capacity increment.

Method Summary

java.beans.PropertyChangeListener	_persistence_getPropertyChangeListener() INTERNAL: Return the property change listener for change tracking.
void	_persistence_setPropertyChangeListener(java.beans.PropertyChangeListener changeListener) INTERNAL: Set the property change listener for change tracking.
void	add(int index, java.lang.Object element)
boolean	add(java.lang.Object element)
boolean	addAll(java.util.Collection c)
boolean	addAll(int index, java.util.Collection c)
void	addElement(java.lang.Object obj)
protected java.util.Vector	buildDelegate() INTERNAL: Return the freshly-built delegate.
int	capacity()
void	clear()
void	clearDeferredChanges() INTERNAL: clear any changes that have been deferred to instantiation.
java.lang.Object	clone() PUBLIC:
boolean	contains(java.lang.Object element) PUBLIC:
boolean	containsAll(java.util.Collection c)
void	copyInto(java.lang.Object[] anArray)
java.lang.Object	elementAt(int index)
java.util.Enumeration	elements()
void	ensureCapacity(int minCapacity)
boolean	equals(java.lang.Object o)
java.lang.Object	firstElement()
java.lang.Object	get(int index)
java.util.Collection	getAddedElements() INTERNAL: Return the elements that have been added before instantiation.
protected java.util.Vector	getDelegate() INTERNAL: Check whether the contents have been read from the database.
java.lang.Object	getDelegateObject() INTERNAL: Return the real collection object.
java.util.Collection	getRemovedElements() INTERNAL: Return the elements that have been removed before instantiation.
java.lang.String	getTrackedAttributeName() INTERNAL: Return the mapping attribute name, used to raise change events.
ValueHolderInterface	getValueHolder() INTERNAL: Return the valueHolder.
boolean	hasAddedElements() INTERNAL: Return if any elements that have been added before instantiation.
boolean	hasBeenRegistered() INTERNAL: return whether this IndirectList has been registered with the UnitOfWork
boolean	hasDeferredChanges() INTERNAL: Return if any elements that have been added or removed before instantiation.
int	hashCode() INTERNAL:
boolean	hasRemovedElements() INTERNAL: Return if any elements that have been removed before instantiation.
boolean	hasTrackedPropertyChangeListener() INTERNAL: Return if the collection has a property change listener for change tracking.
int	indexOf(java.lang.Object elem)
int	indexOf(java.lang.Object elem, int index)
void	insertElementAt(java.lang.Object obj, int index)
boolean	isEmpty()
boolean	isInstantiated() PUBLIC: Return whether the contents have been read from the database.
boolean	isListOrderBrokenInDb()
java.util.Iterator	iterator()
java.lang.Object	lastElement()
int	lastIndexOf(java.lang.Object elem)
int	lastIndexOf(java.lang.Object elem, int index)
java.util.ListIterator	listIterator()
java.util.ListIterator	listIterator(int index)
protected void	raiseAddChangeEvent(java.lang.Object element, java.lang.Integer index) Raise the add change event and relationship maintenance.
protected void	raiseAddChangeEvent(java.lang.Object element, java.lang.Integer index, boolean isSet)
protected void	raiseRemoveChangeEvent(java.lang.Object element, java.lang.Integer index) Raise the remove change event.
protected void	raiseRemoveChangeEvent(java.lang.Object element, java.lang.Integer index, boolean isSet)
java.lang.Object	remove(int index)
boolean	remove(java.lang.Object element)
boolean	removeAll(java.util.Collection c)
void	removeAllElements()
boolean	removeElement(java.lang.Object obj)
void	removeElementAt(int index)
boolean	retainAll(java.util.Collection c)
java.lang.Object	set(int index, java.lang.Object element)
void	setElementAt(java.lang.Object obj, int index)
void	setIsListOrderBrokenInDb(boolean isBroken)
void	setSize(int newSize)
void	setTrackedAttributeName(java.lang.String attributeName) INTERNAL: Set the mapping attribute name, used to raise change events.
void	setUseLazyInstantiation(boolean useLazyInstantiation) INTERNAL Set whether this collection should attempt do deal with adds and removes without retrieving the collection from the dB
void	setValueHolder(ValueHolderInterface valueHolder) INTERNAL: Set the value holder.
protected boolean	shouldAvoidInstantiation() INTERNAL: Return if add/remove should trigger instantiation or avoid.
protected boolean	shouldUseLazyInstantiation() Return whether this collection should attempt do deal with adds and removes without retrieving the collection from the dB
int	size()
java.util.List	subList(int fromIndex, int toIndex)
java.lang.Object[]	toArray()
java.lang.Object[]	toArray(java.lang.Object[] a)
java.lang.String	toString() PUBLIC: Use the java.util.Vector#toString(); but wrap it with braces to indicate there is a bit of indirection.
void	trimToSize()
protected boolean	usesListOrderField() INTERNAL: Returns whether the mapping has listOrderField.

Methods inherited from class java.util.Vector

removeRange

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

delegate

protected volatile java.util.Vector delegate

Reduce type casting.

valueHolder

protected ValueHolderInterface valueHolder

Delegate indirection behavior to a value holder.

changeListener

private transient java.beans.PropertyChangeListener changeListener

Change tracking listener.

attributeName

private transient java.lang.String attributeName

The mapping attribute name, used to raise change events.

addedElements

private transient java.util.List addedElements

Store added elements to avoid instantiation on add.

removedElements

private transient java.util.List removedElements

Store removed elements to avoid instantiation on remove.

initialCapacity

protected int initialCapacity

Store initial size for lazy init.

isRegistered

protected boolean isRegistered

PERF: Quick check flag if has been registered in a unit of work.

isListOrderBrokenInDb

private boolean isListOrderBrokenInDb

If the mapping using IndirectList has listOrderfield != null then this flag indicates whether the list in the db has invalid order: either row(s) with null order value(s) or/and "holes" in order. The flag may be set to true when the objects are read from the db. When collection is updated the flag set to true causes updating of listOrderField of all rows in the db. After update is complete the flag is set back to false.

useLazyInstantiation

private boolean useLazyInstantiation

This value is used to determine if we should attempt to do adds and removes from the list without actually instantiating the list from the database. By default this is set to true.

Constructor Detail

IndirectList

public IndirectList()

PUBLIC: Construct an empty IndirectList so that its internal data array has size 10 and its standard capacity increment is zero.

IndirectList

public IndirectList(int initialCapacity)

PUBLIC: Construct an empty IndirectList with the specified initial capacity and with its capacity increment equal to zero.

Parameters:

initialCapacity - the initial capacity of the vector

Throws:

java.lang.IllegalArgumentException - if the specified initial capacity is negative

IndirectList

public IndirectList(int initialCapacity,
                    int capacityIncrement)

PUBLIC: Construct an empty IndirectList with the specified initial capacity and capacity increment.

Parameters:

initialCapacity - the initial capacity of the vector

capacityIncrement - the amount by which the capacity is increased when the vector overflows

Throws:

java.lang.IllegalArgumentException - if the specified initial capacity is negative

IndirectList

public IndirectList(java.util.Collection collection)

PUBLIC: Construct an IndirectList containing the elements of the specified collection, in the order they are returned by the collection's iterator.

Parameters:

collection - a collection containing the elements to construct this IndirectList with.

Method Detail

add

public void add(int index,
                java.lang.Object element)

Specified by:

add in interface java.util.List

Overrides:

add in class java.util.Vector

See Also:

Vector.add(int, java.lang.Object)

raiseAddChangeEvent

protected void raiseAddChangeEvent(java.lang.Object element,
                                   java.lang.Integer index)

Raise the add change event and relationship maintenance.

raiseAddChangeEvent

protected void raiseAddChangeEvent(java.lang.Object element,
                                   java.lang.Integer index,
                                   boolean isSet)

raiseRemoveChangeEvent

protected void raiseRemoveChangeEvent(java.lang.Object element,
                                      java.lang.Integer index)

Raise the remove change event.

raiseRemoveChangeEvent

protected void raiseRemoveChangeEvent(java.lang.Object element,
                                      java.lang.Integer index,
                                      boolean isSet)

add

public boolean add(java.lang.Object element)

Specified by:

add in interface java.util.Collection

Specified by:

add in interface java.util.List

Overrides:

add in class java.util.Vector

See Also:

Vector.add(java.lang.Object)

addAll

public boolean addAll(int index,
                      java.util.Collection c)

Specified by:

addAll in interface java.util.List

Overrides:

addAll in class java.util.Vector

See Also:

Vector.addAll(int, java.util.Collection)

addAll

public boolean addAll(java.util.Collection c)

Specified by:

addAll in interface java.util.Collection

Specified by:

addAll in interface java.util.List

Overrides:

addAll in class java.util.Vector

See Also:

Vector.addAll(java.util.Collection)

addElement

public void addElement(java.lang.Object obj)

Overrides:

addElement in class java.util.Vector

See Also:

Vector.addElement(java.lang.Object)

buildDelegate

protected java.util.Vector buildDelegate()

INTERNAL: Return the freshly-built delegate.

capacity

public int capacity()

Overrides:

capacity in class java.util.Vector

See Also:

Vector.capacity()

clear

public void clear()

Specified by:

clear in interface java.util.Collection

Specified by:

clear in interface java.util.List

Overrides:

clear in class java.util.Vector

See Also:

Vector.clear()

clearDeferredChanges

public void clearDeferredChanges()

INTERNAL: clear any changes that have been deferred to instantiation. Indirect collections with change tracking avoid instantiation on add/remove.

Specified by:

clearDeferredChanges in interface IndirectCollection

clone

public java.lang.Object clone()

PUBLIC:

Overrides:

clone in class java.util.Vector

See Also:

This will result in a database query if necessary.

contains

public boolean contains(java.lang.Object element)

PUBLIC:

Specified by:

contains in interface java.util.Collection

Specified by:

contains in interface java.util.List

Overrides:

contains in class java.util.Vector

See Also:

Vector.contains(java.lang.Object)

containsAll

public boolean containsAll(java.util.Collection c)

Specified by:

containsAll in interface java.util.Collection

Specified by:

containsAll in interface java.util.List

Overrides:

containsAll in class java.util.Vector

See Also:

Vector.containsAll(java.util.Collection)

copyInto

public void copyInto(java.lang.Object[] anArray)

Overrides:

copyInto in class java.util.Vector

See Also:

Vector.copyInto(java.lang.Object[])

elementAt

public java.lang.Object elementAt(int index)

Overrides:

elementAt in class java.util.Vector

See Also:

Vector.elementAt(int)

elements

public java.util.Enumeration elements()

Overrides:

elements in class java.util.Vector

See Also:

Vector.elements()

ensureCapacity

public void ensureCapacity(int minCapacity)

Overrides:

ensureCapacity in class java.util.Vector

See Also:

Vector.ensureCapacity(int)

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface java.util.Collection

Specified by:

equals in interface java.util.List

Overrides:

equals in class java.util.Vector

See Also:

Vector.equals(java.lang.Object)

firstElement

public java.lang.Object firstElement()

Overrides:

firstElement in class java.util.Vector

See Also:

Vector.firstElement()

get

public java.lang.Object get(int index)

Specified by:

get in interface java.util.List

Overrides:

get in class java.util.Vector

See Also:

Vector.get(int)

getDelegate

protected java.util.Vector getDelegate()

INTERNAL: Check whether the contents have been read from the database. If they have not, read them and set the delegate. This method used to be synchronized, which caused deadlock.

getDelegateObject

public java.lang.Object getDelegateObject()

INTERNAL: Return the real collection object. This will force instantiation.

Specified by:

getDelegateObject in interface IndirectCollection

getValueHolder

public ValueHolderInterface getValueHolder()

INTERNAL: Return the valueHolder. This method used to be synchronized, which caused deadlock.

Specified by:

getValueHolder in interface IndirectContainer

Returns:

org.eclipse.persistence.indirection.ValueHolderInterface A representation of the valueholder * which this container uses

hasBeenRegistered

public boolean hasBeenRegistered()

INTERNAL: return whether this IndirectList has been registered with the UnitOfWork

hashCode

public int hashCode()

INTERNAL:

Specified by:

hashCode in interface java.util.Collection

Specified by:

hashCode in interface java.util.List

Overrides:

hashCode in class java.util.Vector

See Also:

Vector.hashCode()

indexOf

public int indexOf(java.lang.Object elem)

Specified by:

indexOf in interface java.util.List

Overrides:

indexOf in class java.util.Vector

See Also:

Vector.indexOf(java.lang.Object)

indexOf

public int indexOf(java.lang.Object elem,
                   int index)

Overrides:

indexOf in class java.util.Vector

See Also:

Vector.indexOf(java.lang.Object, int)

insertElementAt

public void insertElementAt(java.lang.Object obj,
                            int index)

Overrides:

insertElementAt in class java.util.Vector

See Also:

Vector.insertElementAt(java.lang.Object, int)

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Collection

Specified by:

isEmpty in interface java.util.List

Overrides:

isEmpty in class java.util.Vector

See Also:

Vector.isEmpty()

isInstantiated

public boolean isInstantiated()

PUBLIC: Return whether the contents have been read from the database.

Specified by:

isInstantiated in interface IndirectContainer

iterator

public java.util.Iterator iterator()

Specified by:

iterator in interface java.lang.Iterable

Specified by:

iterator in interface java.util.Collection

Specified by:

iterator in interface java.util.List

Overrides:

iterator in class java.util.AbstractList

See Also:

AbstractList.iterator()

lastElement

public java.lang.Object lastElement()

Overrides:

lastElement in class java.util.Vector

See Also:

Vector.lastElement()

lastIndexOf

public int lastIndexOf(java.lang.Object elem)

Specified by:

lastIndexOf in interface java.util.List

Overrides:

lastIndexOf in class java.util.Vector

See Also:

Vector.lastIndexOf(java.lang.Object)

lastIndexOf

public int lastIndexOf(java.lang.Object elem,
                       int index)

Overrides:

lastIndexOf in class java.util.Vector

See Also:

Vector.lastIndexOf(java.lang.Object, int)

listIterator

public java.util.ListIterator listIterator()

Specified by:

listIterator in interface java.util.List

Overrides:

listIterator in class java.util.AbstractList

See Also:

AbstractList.listIterator()

listIterator

public java.util.ListIterator listIterator(int index)

Specified by:

listIterator in interface java.util.List

Overrides:

listIterator in class java.util.AbstractList

See Also:

AbstractList.listIterator(int)

remove

public java.lang.Object remove(int index)

Specified by:

remove in interface java.util.List

Overrides:

remove in class java.util.Vector

See Also:

Vector.remove(int)

remove

public boolean remove(java.lang.Object element)

Specified by:

remove in interface java.util.Collection

Specified by:

remove in interface java.util.List

Overrides:

remove in class java.util.Vector

See Also:

Vector.remove(java.lang.Object)

removeAll

public boolean removeAll(java.util.Collection c)

Specified by:

removeAll in interface java.util.Collection

Specified by:

removeAll in interface java.util.List

Overrides:

removeAll in class java.util.Vector

See Also:

Vector.removeAll(java.util.Collection)

removeAllElements

public void removeAllElements()

Overrides:

removeAllElements in class java.util.Vector

See Also:

Vector.removeAllElements()

removeElement

public boolean removeElement(java.lang.Object obj)

Overrides:

removeElement in class java.util.Vector

See Also:

Vector.removeElement(java.lang.Object)

removeElementAt

public void removeElementAt(int index)

Overrides:

removeElementAt in class java.util.Vector

See Also:

Vector.removeElementAt(int)

retainAll

public boolean retainAll(java.util.Collection c)

Specified by:

retainAll in interface java.util.Collection

Specified by:

retainAll in interface java.util.List

Overrides:

retainAll in class java.util.Vector

See Also:

Vector.retainAll(java.util.Collection)

set

public java.lang.Object set(int index,
                            java.lang.Object element)

Specified by:

set in interface java.util.List

Overrides:

set in class java.util.Vector

See Also:

Vector.set(int, java.lang.Object)

setElementAt

public void setElementAt(java.lang.Object obj,
                         int index)

Overrides:

setElementAt in class java.util.Vector

See Also:

Vector.setElementAt(java.lang.Object, int)

setSize

public void setSize(int newSize)

Overrides:

setSize in class java.util.Vector

See Also:

Vector.setSize(int)

setUseLazyInstantiation

public void setUseLazyInstantiation(boolean useLazyInstantiation)

INTERNAL Set whether this collection should attempt do deal with adds and removes without retrieving the collection from the dB

Specified by:

setUseLazyInstantiation in interface IndirectCollection

setValueHolder

public void setValueHolder(ValueHolderInterface valueHolder)

INTERNAL: Set the value holder.

Specified by:

setValueHolder in interface IndirectContainer

size

public int size()

Specified by:

size in interface java.util.Collection

Specified by:

size in interface java.util.List

Overrides:

size in class java.util.Vector

See Also:

Vector.size()

shouldUseLazyInstantiation

protected boolean shouldUseLazyInstantiation()

Return whether this collection should attempt do deal with adds and removes without retrieving the collection from the dB

Returns:

subList

public java.util.List subList(int fromIndex,
                              int toIndex)

Specified by:

subList in interface java.util.List

Overrides:

subList in class java.util.Vector

See Also:

Vector.subList(int, int)

toArray

public java.lang.Object[] toArray()

Specified by:

toArray in interface java.util.Collection

Specified by:

toArray in interface java.util.List

Overrides:

toArray in class java.util.Vector

See Also:

Vector.toArray()

toArray

public java.lang.Object[] toArray(java.lang.Object[] a)

Specified by:

toArray in interface java.util.Collection

Specified by:

toArray in interface java.util.List

Overrides:

toArray in class java.util.Vector

See Also:

Vector.toArray(java.lang.Object[])

toString

public java.lang.String toString()

PUBLIC: Use the java.util.Vector#toString(); but wrap it with braces to indicate there is a bit of indirection. Don't allow this method to trigger a database read.

Overrides:

toString in class java.util.Vector

See Also:

Vector.toString()

trimToSize

public void trimToSize()

Overrides:

trimToSize in class java.util.Vector

See Also:

Vector.trimToSize()

_persistence_getPropertyChangeListener

public java.beans.PropertyChangeListener _persistence_getPropertyChangeListener()

INTERNAL: Return the property change listener for change tracking.

Specified by:

_persistence_getPropertyChangeListener in interface ChangeTracker

hasTrackedPropertyChangeListener

public boolean hasTrackedPropertyChangeListener()

INTERNAL: Return if the collection has a property change listener for change tracking.

_persistence_setPropertyChangeListener

public void _persistence_setPropertyChangeListener(java.beans.PropertyChangeListener changeListener)

INTERNAL: Set the property change listener for change tracking.

Specified by:

_persistence_setPropertyChangeListener in interface ChangeTracker

getTrackedAttributeName

public java.lang.String getTrackedAttributeName()

INTERNAL: Return the mapping attribute name, used to raise change events.

Specified by:

getTrackedAttributeName in interface CollectionChangeTracker

setTrackedAttributeName

public void setTrackedAttributeName(java.lang.String attributeName)

INTERNAL: Set the mapping attribute name, used to raise change events. This is required if the change listener is set.

Specified by:

setTrackedAttributeName in interface CollectionChangeTracker

getRemovedElements

public java.util.Collection getRemovedElements()

INTERNAL: Return the elements that have been removed before instantiation.

Specified by:

getRemovedElements in interface IndirectCollection

getAddedElements

public java.util.Collection getAddedElements()

INTERNAL: Return the elements that have been added before instantiation.

Specified by:

getAddedElements in interface IndirectCollection

hasAddedElements

public boolean hasAddedElements()

INTERNAL: Return if any elements that have been added before instantiation.

hasRemovedElements

public boolean hasRemovedElements()

INTERNAL: Return if any elements that have been removed before instantiation.

hasDeferredChanges

public boolean hasDeferredChanges()

INTERNAL: Return if any elements that have been added or removed before instantiation.

Specified by:

hasDeferredChanges in interface IndirectCollection

shouldAvoidInstantiation

protected boolean shouldAvoidInstantiation()

INTERNAL: Return if add/remove should trigger instantiation or avoid. Current instantiation is avoided is using change tracking.

usesListOrderField

protected boolean usesListOrderField()

INTERNAL: Returns whether the mapping has listOrderField.

isListOrderBrokenInDb

public boolean isListOrderBrokenInDb()

setIsListOrderBrokenInDb

public void setIsListOrderBrokenInDb(boolean isBroken)

Skip navigation links