org.apache.river.concurrent

Class ReferenceList<T>

java.lang.Object

java.util.AbstractCollection<T>

org.apache.river.concurrent.ReferenceCollection<T>

org.apache.river.concurrent.ReferenceList<T>

All Implemented Interfaces:

Serializable, Iterable<T>, Collection<T>, List<T>

class ReferenceList<T>
extends ReferenceCollection<T>
implements List<T>

A List implementation that uses References. This enables a Collection or List to contain, softly, weakly or strongly referenced objects. Objects that are no longer reachable will simply vanish from the Collection. For example, this could be used as an Object cache containing softly reachable objects which are only collected when the jvm is experiencing low memory conditions. Synchronisation must be performed by the underlying List, it cannot be performed externally, since every read is also potentially a mutable change, caused by removal of garbage collected Objects. Removal of garbage collected objects is performed before iteration, but not during, instead some Object's returned during iteration may be null.

Author:

Peter Firmstone.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	ReferenceList.ReferenceListIterator<T>

Field Summary

Fields

Modifier and Type	Field and Description
private List<Referrer<T>>	list
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
ReferenceList(List<Referrer<T>> list, Ref type, boolean gcThreads, long gcCycle)
ReferenceList(List<Referrer<T>> list, ReferenceQueuingFactory<T,Referrer<T>> rqf, Ref type)

Method Summary

Modifier and Type	Method and Description
void	add(int index, T element)
boolean	addAll(int index, Collection<? extends T> c)
boolean	equals(Object o) Implemented as per the List interface definition of equals.
T	get(int index)
int	hashCode() Implemented as per List interface definition.
int	indexOf(Object o)
int	lastIndexOf(Object o)
ListIterator<T>	listIterator()
ListIterator<T>	listIterator(int index)
private void	readObject(ObjectInputStream stream)
T	remove(int index)
T	set(int index, T element)
List<T>	subList(int fromIndex, int toIndex)

Methods inherited from class org.apache.river.concurrent.ReferenceCollection

add, addAll, clear, contains, containsAll, getRef, getRQF, isEmpty, iterator, processQueue, remove, size, toString, wrapObj, writeReplace

Methods inherited from class java.util.AbstractCollection

removeAll, retainAll, toArray, toArray

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, removeAll, replaceAll, retainAll, size, sort, spliterator, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

list

private final List<Referrer<T>> list

Constructor Detail

ReferenceList

ReferenceList(List<Referrer<T>> list,
              Ref type,
              boolean gcThreads,
              long gcCycle)

ReferenceList

ReferenceList(List<Referrer<T>> list,
              ReferenceQueuingFactory<T,Referrer<T>> rqf,
              Ref type)

Method Detail

readObject

private void readObject(ObjectInputStream stream)
                 throws InvalidObjectException

Throws:

InvalidObjectException

equals

public boolean equals(Object o)

Implemented as per the List interface definition of equals.

Specified by:

equals in interface Collection<T>

Specified by:

equals in interface List<T>

Overrides:

equals in class ReferenceCollection<T>

Parameters:

o -

Returns:

See Also:

List.equals(java.lang.Object)

hashCode

public int hashCode()

Implemented as per List interface definition.

Specified by:

hashCode in interface Collection<T>

Specified by:

hashCode in interface List<T>

Overrides:

hashCode in class ReferenceCollection<T>

Returns:

See Also:

List.hashCode()

addAll

public boolean addAll(int index,
                      Collection<? extends T> c)

Specified by:

addAll in interface List<T>

get

public T get(int index)

Specified by:

get in interface List<T>

set

public T set(int index,
             T element)

Specified by:

set in interface List<T>

add

public void add(int index,
                T element)

Specified by:

add in interface List<T>

remove

public T remove(int index)

Specified by:

remove in interface List<T>

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List<T>

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<T>

listIterator

public ListIterator<T> listIterator()

Specified by:

listIterator in interface List<T>

listIterator

public ListIterator<T> listIterator(int index)

Specified by:

listIterator in interface List<T>

subList

public List<T> subList(int fromIndex,
                       int toIndex)

Specified by:

subList in interface List<T>