hudson.util

Class PersistedList<T>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<T>

hudson.util.PersistedList<T>

All Implemented Interfaces:

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

Direct Known Subclasses:

DescribableList

public class PersistedList<T>
extends AbstractList<T>

Collection whose change is notified to the parent object for persistence.

Since:

1.MULTISOURCE

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PersistedList.ConverterImpl Converter implementation for XStream.

Field Summary

Fields

Modifier and Type	Field and Description
protected CopyOnWriteList<T>	data
protected Saveable	owner

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PersistedList()
protected	PersistedList(Collection<? extends T> initialList)
	PersistedList(Saveable owner)

Method Summary

Modifier and Type	Method and Description
boolean	add(T item)
boolean	addAll(Collection<? extends T> items)
void	addAllTo(Collection<? super T> dst)
void	clear()
boolean	contains(Object item)
<U extends T> U	get(Class<U> type)
T	get(int index)
<U extends T> List<U>	getAll(Class<U> type) Gets all instances that matches the given type.
boolean	isEmpty()
Iterator<T>	iterator()
protected void	onModified() Called when a list is mutated.
void	remove(Class<? extends T> type) Removes an instance by its type.
boolean	remove(Object o)
void	removeAll(Class<? extends T> type)
void	replace(T from, T to) A convenience method to replace a single item.
void	replaceBy(Collection<? extends T> col)
void	setOwner(Saveable owner)
int	size()
<T> T[]	toArray(T[] array) Gets all the Describables in an array.
List<T>	toList() Returns the snapshot view of instances as list.
String	toString()

Methods inherited from class java.util.AbstractList

add, addAll, equals, hashCode, indexOf, lastIndexOf, listIterator, listIterator, remove, removeRange, set, subList

Methods inherited from class java.util.AbstractCollection

containsAll, removeAll, retainAll, toArray

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

containsAll, removeAll, replaceAll, retainAll, sort, spliterator, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

data

protected final CopyOnWriteList<T> data

owner

protected Saveable owner

Constructor Detail

PersistedList

protected PersistedList()

PersistedList

protected PersistedList(Collection<? extends T> initialList)

PersistedList

public PersistedList(Saveable owner)

Method Detail

setOwner

public void setOwner(Saveable owner)

add

@WithBridgeMethods(value=void.class)
public boolean add(T item)

Specified by:

add in interface Collection<T>

Specified by:

add in interface List<T>

Overrides:

add in class AbstractList<T>

addAll

@WithBridgeMethods(value=void.class)
public boolean addAll(Collection<? extends T> items)

Specified by:

addAll in interface Collection<T>

Specified by:

addAll in interface List<T>

Overrides:

addAll in class AbstractCollection<T>

replaceBy

public void replaceBy(Collection<? extends T> col)
               throws IOException

Throws:

IOException

get

public T get(int index)

Specified by:

get in interface List<T>

Specified by:

get in class AbstractList<T>

get

public <U extends T> U get(Class<U> type)

getAll

public <U extends T> List<U> getAll(Class<U> type)

Gets all instances that matches the given type.

size

public int size()

Specified by:

size in interface Collection<T>

Specified by:

size in interface List<T>

Specified by:

size in class AbstractCollection<T>

remove

public void remove(Class<? extends T> type)
            throws IOException

Removes an instance by its type.

Throws:

IOException

replace

public void replace(T from,
                    T to)
             throws IOException

A convenience method to replace a single item. This method shouldn't be used when you are replacing a lot of stuff as copy-on-write semantics make this rather slow.

Throws:

IOException

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<T>

Specified by:

remove in interface List<T>

Overrides:

remove in class AbstractCollection<T>

removeAll

public void removeAll(Class<? extends T> type)
               throws IOException

Throws:

IOException

clear

public void clear()

Specified by:

clear in interface Collection<T>

Specified by:

clear in interface List<T>

Overrides:

clear in class AbstractList<T>

iterator

public Iterator<T> iterator()

Specified by:

iterator in interface Iterable<T>

Specified by:

iterator in interface Collection<T>

Specified by:

iterator in interface List<T>

Overrides:

iterator in class AbstractList<T>

onModified

protected void onModified()
                   throws IOException

Called when a list is mutated.

Throws:

IOException

toList

public List<T> toList()

Returns the snapshot view of instances as list.

toArray

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

Gets all the Describables in an array.

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface List<T>

Overrides:

toArray in class AbstractCollection<T>

addAllTo

public void addAllTo(Collection<? super T> dst)

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<T>

Specified by:

isEmpty in interface List<T>

Overrides:

isEmpty in class AbstractCollection<T>

contains

public boolean contains(Object item)

Specified by:

contains in interface Collection<T>

Specified by:

contains in interface List<T>

Overrides:

contains in class AbstractCollection<T>

toString

public String toString()

Overrides:

toString in class AbstractCollection<T>