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
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>
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()
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()
Glazed Lists, Copyright © 2003 publicobject.com, O'Dell Engineering.
Documentation build by buildd at 2012-05-30 10:36