org.apache.ojb.broker.util.collections
Class ManageableArrayList

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractList<E>
          java.util.ArrayList
              org.apache.ojb.broker.util.collections.ManageableArrayList

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess, ManageableCollection

Direct Known Subclasses:

RemovalAwareList

public class ManageableArrayList
extends java.util.ArrayList
implements ManageableCollection

is a utility class. provides an ArrayList that addionally implements the ManageableCollection interface. This class may be used as a type for collection attributes.

Version:

$Id: ManageableArrayList.java 365232 2005-12-21 22:36:07Z tomdz $

Author:

Thomas Mahler

See Also:

Serialized Form

Constructor Summary

ManageableArrayList()

Method Summary

void	afterStore(PersistenceBroker broker) A callback method to implement 'removal-aware' (track removed objects and delete them by its own) collection implementations.
void	ojbAdd(java.lang.Object anObject) add a single Object to the Collection.
void	ojbAddAll(ManageableCollection otherCollection) adds a Collection to this collection.
java.util.Iterator	ojbIterator() returns an Iterator over all elements in the collection.

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, lastIndexOf, remove, remove, set, size, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode, iterator, listIterator, listIterator, subList

Methods inherited from class java.util.AbstractCollection

containsAll, removeAll, retainAll, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList

Constructor Detail

ManageableArrayList

public ManageableArrayList()

Method Detail

ojbAdd

public void ojbAdd(java.lang.Object anObject)

add a single Object to the Collection. This method is used during reading Collection elements from the database. Thus it is is save to cast anObject to the underlying element type of the collection.

Specified by:

ojbAdd in interface ManageableCollection

Parameters:

anObject - The object to add

ojbAddAll

public void ojbAddAll(ManageableCollection otherCollection)

adds a Collection to this collection. Used in reading Extents from the Database. Thus it is save to cast otherCollection to this.getClass().

Specified by:

ojbAddAll in interface ManageableCollection

Parameters:

otherCollection - The added collection

afterStore

public void afterStore(PersistenceBroker broker)
                throws PersistenceBrokerException

Description copied from interface: ManageableCollection

A callback method to implement 'removal-aware' (track removed objects and delete them by its own) collection implementations.

Specified by:

afterStore in interface ManageableCollection

Parameters:

broker - The persistence broker

Throws:

PersistenceBrokerException

ojbIterator

public java.util.Iterator ojbIterator()

returns an Iterator over all elements in the collection. Used during store and delete Operations. If the implementor does not return an iterator over ALL elements, OJB cannot store and delete all elements properly.

Specified by:

ojbIterator in interface ManageableCollection

Returns:

The iterator