java.io.Serializable
, java.lang.Iterable
, java.util.Collection
, Buffer
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.
collection
predicate
Modifier | Constructor | Description |
---|---|---|
protected |
PredicatedBuffer(Buffer buffer,
Predicate predicate) |
Constructor that wraps (not copies).
|
Modifier and Type | Method | 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.
|
protected Buffer |
getBuffer() |
Gets the buffer being decorated.
|
java.lang.Object |
remove() |
Gets and removes the next object from the buffer.
|
clear, contains, containsAll, equals, getCollection, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
add, addAll, decorate, validate
protected PredicatedBuffer(Buffer buffer, Predicate predicate)
If there are any elements already in the collection 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 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 elementsprotected Buffer getBuffer()
public java.lang.Object get()
Buffer
Copyright © 2001-2017 Apache Software Foundation. All Rights Reserved.