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.
Modifier and Type | Class and Description |
---|---|
protected class |
PredicatedList.PredicatedListIterator
Inner class Iterator for the PredicatedList
|
predicate
collection
Modifier | Constructor and Description |
---|---|
protected |
PredicatedList(List list,
Predicate predicate)
Constructor that wraps (not copies).
|
Modifier and Type | Method and Description |
---|---|
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) |
add, addAll, decorate, validate
clear, contains, containsAll, equals, getCollection, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString
protected PredicatedList(List list, Predicate predicate)
If there are any elements already in the list being decorated, they are validated.
list
- the list to decorate, must not be nullpredicate
- the predicate to use for validation, must not be nullIllegalArgumentException
- if list or predicate is nullIllegalArgumentException
- if the list contains invalid elementspublic static List decorate(List list, Predicate predicate)
If there are any elements already in the list being decorated, they are validated.
list
- the list to decorate, must not be nullpredicate
- the predicate to use for validation, must not be nullIllegalArgumentException
- if list or predicate is nullIllegalArgumentException
- if the list contains invalid elementsprotected List getList()
public int lastIndexOf(Object object)
lastIndexOf
in interface List
public boolean addAll(int index, Collection coll)
public ListIterator listIterator()
listIterator
in interface List
public ListIterator listIterator(int i)
listIterator
in interface List
Copyright © 2001–2015 The Apache Software Foundation. All rights reserved.