public class RangeList<E> extends TransformedList<E,E>
EventList
shows values from a continuous range of indices from a source
EventList
. It can be used to limit the length of a list to a desired size.
Warning: This class is thread ready but not thread
safe. See EventList
for an example of thread safe code.
EventList Overview | |
Writable: | yes |
Concurrency: | thread ready, not thread safe |
Performance: | reads: O(1), writes O(1), change range O(1) |
Memory: | 0 bytes per element |
Unit Tests: | N/A |
Issues: | 238 278 |
source
publisher, readWriteLock, updates
Modifier and Type | Method and Description |
---|---|
protected void |
adjustRange()
Adjust the range of the
RangeList in response to changes in the source list or the
desired start and end indices. |
int |
getEndIndex()
|
protected int |
getSourceIndex(int mutationIndex)
Gets the index in the source
EventList that corresponds to the specified index. |
int |
getStartIndex()
|
protected boolean |
isWritable()
Gets whether the source
EventList is writable via this API. |
void |
listChanged(ListEvent<E> listChanges)
When the underlying list changes, this notification allows the object to repaint itself or
update itself as necessary.
|
void |
setHeadRange(int startIndex,
int endIndex)
Set the range of values displayed by this
RangeList . |
void |
setMiddleRange(int startIndex,
int endIndex)
|
void |
setRange(int startIndex,
int endIndex)
Deprecated.
2/15/2006 use
setHeadRange(int, int) instead. The introduction of
setMiddleRange(int, int) caused us to want a consistent naming scheme for
all set*Range methods. |
void |
setTailRange(int startIndex,
int endIndex)
Set the range to include the specified indices, offset from the end of the source
EventList . |
int |
size()
Returns the number of elements in this list.
|
add, addAll, clear, dispose, get, remove, removeAll, retainAll, set
add, addAll, addListEventListener, contains, containsAll, equals, getPublisher, getReadWriteLock, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, removeListEventListener, subList, toArray, toArray, toString
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
replaceAll, sort, spliterator
parallelStream, removeIf, stream
public final void listChanged(ListEvent<E> listChanges)
It is mandatory that the calling thread has obtained the write lock on the source list. This is because the calling thread will have written to the source list to cause this event. This condition guarantees that no writes can occur while the listener is handling this event. It is an error to write to the source list while processing an event.
listChanged
in interface ListEventListener<E>
listChanged
in class TransformedList<E,E>
listChanges
- a ListEvent
describing the changes to the list@Deprecated public void setRange(int startIndex, int endIndex)
setHeadRange(int, int)
instead. The introduction of
setMiddleRange(int, int)
caused us to want a consistent naming scheme for
all set*Range methods.RangeList
.public void setHeadRange(int startIndex, int endIndex)
RangeList
.public void setMiddleRange(int startIndex, int endIndex)
EventList
and the endIndex offset from the end of the source EventList
.
For example, to include everything but the first element, use
RangeList.setMiddleRange(1, 0);
.
For example, to include everything but the last element, use
RangeList.setMiddleRange(0, 1);
.
public void setTailRange(int startIndex, int endIndex)
EventList
. For example, to show the last five values, use:
RangeList.setTailRange(5, 0);
To include the 3rd last and 2nd last values, use: RangeList.setTailRange(3, 1);
.
protected final void adjustRange()
RangeList
in response to changes in the source list or the
desired start and end indices.public final int size()
Integer.MAX_VALUE
elements, returns Integer.MAX_VALUE
.size
in interface Collection<E>
size
in interface List<E>
size
in class TransformedList<E,E>
protected final int getSourceIndex(int mutationIndex)
EventList
that corresponds to the specified index. More
formally, returns the index such that this.get(i) == source.get(getSourceIndex(i))
for all legal values of
i
.getSourceIndex
in class TransformedList<E,E>
protected final boolean isWritable()
EventList
is writable via this API.
Extending classes must override this method in order to make themselves writable.
isWritable
in class TransformedList<E,E>
public int getStartIndex()
public int getEndIndex()
Copyright © 2024 levigo holding gmbh. All rights reserved.