public class PredicatedBuffer extends PredicatedCollection implements Buffer
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.
Modifier and Type | Method and Description |
---|---|
static Buffer |
decorate(Buffer buffer,
Predicate predicate)
Factory method to create a predicated (validating) buffer.
|
java.lang.Object |
get()
Gets the next object from the buffer without removing it.
|
java.lang.Object |
remove()
Gets and removes the next object from the buffer.
|
add, addAll, decorate
clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString
public static Buffer decorate(Buffer buffer, Predicate predicate)
If there are any elements already in the buffer being decorated, they are validated.
buffer
- the buffer to decorate, must not be nullpredicate
- the predicate to use for validation, must not be nulljava.lang.IllegalArgumentException
- if buffer or predicate is nulljava.lang.IllegalArgumentException
- if the buffer contains invalid elementspublic java.lang.Object get()
Buffer
Copyright © 2010 - 2020 Adobe. All Rights Reserved