org.apache.commons.collections.list
public class PredicatedList extends PredicatedCollection implements List
List
to validate that all additions
match a specified predicate.
This list exists to provide validation for the decorated list. It is normally created to decorate an empty list. If an object cannot be added to the list, an IllegalArgumentException is thrown.
One usage would be to ensure that no null entries are added to the list.
List list = PredicatedList.decorate(new ArrayList(), NotNullPredicate.INSTANCE);
This class is Serializable from Commons Collections 3.1.
Since: Commons Collections 3.0
Version: $Revision: 155406 $ $Date: 2005-02-26 12:55:26 +0000 (Sat, 26 Feb 2005) $
Nested Class Summary | |
---|---|
protected class | PredicatedList.PredicatedListIterator
Inner class Iterator for the PredicatedList |
Constructor Summary | |
---|---|
protected | PredicatedList(List list, Predicate predicate)
Constructor that wraps (not copies).
|
Method Summary | |
---|---|
void | add(int index, Object object) |
boolean | addAll(int index, Collection coll) |
static List | decorate(List list, Predicate predicate)
Factory method to create a predicated (validating) list.
|
Object | get(int index) |
protected List | getList()
Gets the list being decorated.
|
int | indexOf(Object object) |
int | lastIndexOf(Object object) |
ListIterator | listIterator() |
ListIterator | listIterator(int i) |
Object | remove(int index) |
Object | set(int index, Object object) |
List | subList(int fromIndex, int toIndex) |
If there are any elements already in the list being decorated, they are validated.
Parameters: list the list to decorate, must not be null predicate the predicate to use for validation, must not be null
Throws: IllegalArgumentException if list or predicate is null IllegalArgumentException if the list contains invalid elements
If there are any elements already in the list being decorated, they are validated.
Parameters: list the list to decorate, must not be null predicate the predicate to use for validation, must not be null
Throws: IllegalArgumentException if list or predicate is null IllegalArgumentException if the list contains invalid elements
Returns: the decorated list