java.lang.Object | ||||
↳ | org.apache.commons.collections.collection.AbstractCollectionDecorator | |||
↳ | org.apache.commons.collections.collection.AbstractSerializableCollectionDecorator | |||
↳ | org.apache.commons.collections.collection.PredicatedCollection | |||
↳ | org.apache.commons.collections.buffer.PredicatedBuffer |
Decorates another Buffer
to validate that additions
match a specified predicate.
This buffer exists to provide validation for the decorated buffer. It is normally created to decorate an empty buffer. If an object cannot be added to the buffer, an IllegalArgumentException is thrown.
One usage would be to ensure that no null entries are added to the buffer.
Buffer buffer = PredicatedBuffer.decorate(new UnboundedFifoBuffer(), NotNullPredicate.INSTANCE);
This class is Serializable from Commons Collections 3.1.
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.collections.collection.PredicatedCollection
| |||||||||||
From class
org.apache.commons.collections.collection.AbstractCollectionDecorator
|
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructor that wraps (not copies).
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Factory method to create a predicated (validating) buffer.
| |||||||||||
Gets the next object from the buffer without removing it.
| |||||||||||
Gets and removes the next object from the buffer.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Gets the buffer being decorated.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.collections.collection.PredicatedCollection
| |||||||||||
From class
org.apache.commons.collections.collection.AbstractCollectionDecorator
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.lang.Iterable
| |||||||||||
From interface
java.util.Collection
| |||||||||||
From interface
org.apache.commons.collections.Buffer
|
Constructor that wraps (not copies).
If there are any elements already in the collection being decorated, they are validated.
buffer | the buffer to decorate, must not be null |
---|---|
predicate | the predicate to use for validation, must not be null |
IllegalArgumentException | if buffer or predicate is null |
---|---|
IllegalArgumentException | if the buffer contains invalid elements |
Factory method to create a predicated (validating) buffer.
If there are any elements already in the buffer being decorated, they are validated.
buffer | the buffer to decorate, must not be null |
---|---|
predicate | the predicate to use for validation, must not be null |
IllegalArgumentException | if buffer or predicate is null |
---|---|
IllegalArgumentException | if the buffer contains invalid elements |
Gets the next object from the buffer without removing it.
Gets and removes the next object from the buffer.