org.eclipse.gemini.blueprint.service.importer.support.internal.collection

Class DynamicCollection<E>

java.lang.Object

java.util.AbstractCollection<E>

org.eclipse.gemini.blueprint.service.importer.support.internal.collection.DynamicCollection<E>

All Implemented Interfaces:

java.lang.Iterable<E>, java.util.Collection<E>

Direct Known Subclasses:

DynamicList, DynamicSet

public class DynamicCollection<E>
extends java.util.AbstractCollection<E>

Collection which can be increased or reduced at runtime while iterating. Iterators returned by this implementation are consistent - it is guaranteed that Iterator.next() will obey the result of the previously called Iterator.hasNext() even though the collection content has been modified. This collection is thread-safe with the condition that there is at most one writing thread at a point in time. There are no restrains on the number of readers.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DynamicCollection.DynamicIterator Dynamic consistent iterator.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<DynamicCollection.DynamicIterator,java.lang.Object>	iterators should have been a list but there is no 'WeakReference'-based implementation in the JDK
protected java.lang.Object	iteratorsLock If it interacts with the storage, the *storage* lock needs to be acquired first
protected java.util.List<E>	storage this list is not-synchronized by default

Constructor Summary

Constructors

Constructor and Description
DynamicCollection()
DynamicCollection(java.util.Collection<? extends E> c)
DynamicCollection(int size)

Method Summary

Modifier and Type	Method and Description
boolean	add(E o)
protected void	add(int index, E o)
boolean	addAll(java.util.Collection<? extends E> c)
void	clear()
boolean	contains(java.lang.Object o)
boolean	containsAll(java.util.Collection<?> c)
protected int	indexOf(java.lang.Object o) Hook used by wrapping collections to determine the position of the object being removed while iterating.
boolean	isEmpty()
java.util.Iterator<E>	iterator()
protected E	remove(int index)
boolean	remove(java.lang.Object o)
int	size()
java.lang.Object[]	toArray()
<T> T[]	toArray(T[] a)
java.lang.String	toString()

Methods inherited from class java.util.AbstractCollection

removeAll, retainAll

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

iteratorsLock

protected final java.lang.Object iteratorsLock

If it interacts with the storage, the *storage* lock needs to be acquired first

storage

protected final java.util.List<E> storage

this list is not-synchronized by default

iterators

protected final java.util.Map<DynamicCollection.DynamicIterator,java.lang.Object> iterators

should have been a list but there is no 'WeakReference'-based implementation in the JDK

Constructor Detail

DynamicCollection

public DynamicCollection()

DynamicCollection

public DynamicCollection(int size)

DynamicCollection

public DynamicCollection(java.util.Collection<? extends E> c)

Method Detail

iterator

public java.util.Iterator<E> iterator()

Specified by:

iterator in interface java.lang.Iterable<E>

Specified by:

iterator in interface java.util.Collection<E>

Specified by:

iterator in class java.util.AbstractCollection<E>

clear

public void clear()

Specified by:

clear in interface java.util.Collection<E>

Overrides:

clear in class java.util.AbstractCollection<E>

size

public int size()

Specified by:

size in interface java.util.Collection<E>

Specified by:

size in class java.util.AbstractCollection<E>

add

public boolean add(E o)

Specified by:

add in interface java.util.Collection<E>

Overrides:

add in class java.util.AbstractCollection<E>

addAll

public boolean addAll(java.util.Collection<? extends E> c)

Specified by:

addAll in interface java.util.Collection<E>

Overrides:

addAll in class java.util.AbstractCollection<E>

contains

public boolean contains(java.lang.Object o)

Specified by:

contains in interface java.util.Collection<E>

Overrides:

contains in class java.util.AbstractCollection<E>

containsAll

public boolean containsAll(java.util.Collection<?> c)

Specified by:

containsAll in interface java.util.Collection<E>

Overrides:

containsAll in class java.util.AbstractCollection<E>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Collection<E>

Overrides:

isEmpty in class java.util.AbstractCollection<E>

remove

public boolean remove(java.lang.Object o)

Specified by:

remove in interface java.util.Collection<E>

Overrides:

remove in class java.util.AbstractCollection<E>

remove

protected E remove(int index)

add

protected void add(int index,
                   E o)

toArray

public java.lang.Object[] toArray()

Specified by:

toArray in interface java.util.Collection<E>

Overrides:

toArray in class java.util.AbstractCollection<E>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface java.util.Collection<E>

Overrides:

toArray in class java.util.AbstractCollection<E>

toString

public java.lang.String toString()

Overrides:

toString in class java.util.AbstractCollection<E>

indexOf

protected int indexOf(java.lang.Object o)

Hook used by wrapping collections to determine the position of the object being removed while iterating.

Parameters:

o -

Returns: