--- /dev/null
+/*
+ * @(#)AbstractList.java 1.46 04/02/10
+ *
+ * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
+ * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
+ */
+
+package instrumented.java15.util;
+
+/**
+ * This class provides a skeletal implementation of the <tt>List</tt>
+ * interface to minimize the effort required to implement this interface
+ * backed by a "random access" data store (such as an array). For sequential
+ * access data (such as a linked list), <tt>AbstractSequentialList</tt> should
+ * be used in preference to this class.<p>
+ *
+ * To implement an unmodifiable list, the programmer needs only to extend this
+ * class and provide implementations for the <tt>get(int index)</tt> and
+ * <tt>size()</tt> methods.<p>
+ *
+ * To implement a modifiable list, the programmer must additionally override
+ * the <tt>set(int index, Object element)</tt> method (which otherwise throws
+ * an <tt>UnsupportedOperationException</tt>. If the list is variable-size
+ * the programmer must additionally override the <tt>add(int index, Object
+ * element)</tt> and <tt>remove(int index)</tt> methods.<p>
+ *
+ * The programmer should generally provide a void (no argument) and collection
+ * constructor, as per the recommendation in the <tt>Collection</tt> interface
+ * specification.<p>
+ *
+ * Unlike the other abstract collection implementations, the programmer does
+ * <i>not</i> have to provide an iterator implementation; the iterator and
+ * list iterator are implemented by this class, on top the "random access"
+ * methods: <tt>get(int index)</tt>, <tt>set(int index, Object element)</tt>,
+ * <tt>set(int index, Object element)</tt>, <tt>add(int index, Object
+ * element)</tt> and <tt>remove(int index)</tt>.<p>
+ *
+ * The documentation for each non-abstract methods in this class describes its
+ * implementation in detail. Each of these methods may be overridden if the
+ * collection being implemented admits a more efficient implementation.<p>
+ *
+ * This class is a member of the
+ * <a href="{@docRoot}/../guide/collections/index.html">
+ * Java Collections Framework</a>.
+ *
+ * @author Josh Bloch
+ * @author Neal Gafter
+ * @version 1.37, 01/18/03
+ * @see Collection
+ * @see List
+ * @see AbstractSequentialList
+ * @see AbstractCollection
+ * @since 1.2
+ */
+
+public abstract class AbstractList<E> extends AbstractCollection<E> implements List<E> {
+ /**
+ * Sole constructor. (For invocation by subclass constructors, typically
+ * implicit.)
+ */
+ protected AbstractList() {
+ }
+
+ /**
+ * Appends the specified element to the end of this List (optional
+ * operation). <p>
+ *
+ * This implementation calls <tt>add(size(), o)</tt>.<p>
+ *
+ * Note that this implementation throws an
+ * <tt>UnsupportedOperationException</tt> unless <tt>add(int, Object)</tt>
+ * is overridden.
+ *
+ * @param o element to be appended to this list.
+ *
+ * @return <tt>true</tt> (as per the general contract of
+ * <tt>Collection.add</tt>).
+ *
+ * @throws UnsupportedOperationException if the <tt>add</tt> method is not
+ * supported by this Set.
+ *
+ * @throws ClassCastException if the class of the specified element
+ * prevents it from being added to this set.
+ *
+ * @throws IllegalArgumentException some aspect of this element prevents
+ * it from being added to this collection.
+ */
+ public boolean add(E o) {
+ add(size(), o);
+ return true;
+ }
+
+ /**
+ * Returns the element at the specified position in this list.
+ *
+ * @param index index of element to return.
+ *
+ * @return the element at the specified position in this list.
+ * @throws IndexOutOfBoundsException if the given index is out of range
+ * (<tt>index < 0 || index >= size()</tt>).
+ */
+ abstract public E get(int index);
+
+ /**
+ * Replaces the element at the specified position in this list with the
+ * specified element (optional operation). <p>
+ *
+ * This implementation always throws an
+ * <tt>UnsupportedOperationException</tt>.
+ *
+ * @param index index of element to replace.
+ * @param element element to be stored at the specified position.
+ * @return the element previously at the specified position.
+ *
+ * @throws UnsupportedOperationException if the <tt>set</tt> method is not
+ * supported by this List.
+ * @throws ClassCastException if the class of the specified element
+ * prevents it from being added to this list.
+ * @throws IllegalArgumentException if some aspect of the specified
+ * element prevents it from being added to this list.
+ *
+ * @throws IndexOutOfBoundsException if the specified index is out of
+ * range (<tt>index < 0 || index >= size()</tt>).
+ */
+
+ public E set(int index, E element) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * Inserts the specified element at the specified position in this list
+ * (optional operation). Shifts the element currently at that position
+ * (if any) and any subsequent elements to the right (adds one to their
+ * indices).<p>
+ *
+ * This implementation always throws an UnsupportedOperationException.
+ *
+ * @param index index at which the specified element is to be inserted.
+ * @param element element to be inserted.
+ *
+ * @throws UnsupportedOperationException if the <tt>add</tt> method is not
+ * supported by this list.
+ * @throws ClassCastException if the class of the specified element
+ * prevents it from being added to this list.
+ * @throws IllegalArgumentException if some aspect of the specified
+ * element prevents it from being added to this list.
+ * @throws IndexOutOfBoundsException index is out of range (<tt>index <
+ * 0 || index > size()</tt>).
+ */
+ public void add(int index, E element) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * Removes the element at the specified position in this list (optional
+ * operation). Shifts any subsequent elements to the left (subtracts one
+ * from their indices). Returns the element that was removed from the
+ * list.<p>
+ *
+ * This implementation always throws an
+ * <tt>UnsupportedOperationException</tt>.
+ *
+ * @param index the index of the element to remove.
+ * @return the element previously at the specified position.
+ *
+ * @throws UnsupportedOperationException if the <tt>remove</tt> method is
+ * not supported by this list.
+ * @throws IndexOutOfBoundsException if the specified index is out of
+ * range (<tt>index < 0 || index >= size()</tt>).
+ */
+ public E remove(int index) {
+ throw new UnsupportedOperationException();
+ }
+
+
+ // Search Operations
+
+ /**
+ * Returns the index in this list of the first occurence of the specified
+ * element, or -1 if the list does not contain this element. More
+ * formally, returns the lowest index <tt>i</tt> such that <tt>(o==null ?
+ * get(i)==null : o.equals(get(i)))</tt>, or -1 if there is no such
+ * index.<p>
+ *
+ * This implementation first gets a list iterator (with
+ * <tt>listIterator()</tt>). Then, it iterates over the list until the
+ * specified element is found or the end of the list is reached.
+ *
+ * @param o element to search for.
+ *
+ * @return the index in this List of the first occurence of the specified
+ * element, or -1 if the List does not contain this element.
+ */
+ public int indexOf(Object o) {
+ ListIterator<E> e = listIterator();
+ if (o==null) {
+ while (e.hasNext())
+ if (e.next()==null)
+ return e.previousIndex();
+ } else {
+ while (e.hasNext())
+ if (o.equals(e.next()))
+ return e.previousIndex();
+ }
+ return -1;
+ }
+
+ /**
+ * Returns the index in this list of the last occurence of the specified
+ * element, or -1 if the list does not contain this element. More
+ * formally, returns the highest index <tt>i</tt> such that <tt>(o==null ?
+ * get(i)==null : o.equals(get(i)))</tt>, or -1 if there is no such
+ * index.<p>
+ *
+ * This implementation first gets a list iterator that points to the end
+ * of the list (with listIterator(size())). Then, it iterates backwards
+ * over the list until the specified element is found, or the beginning of
+ * the list is reached.
+ *
+ * @param o element to search for.
+ *
+ * @return the index in this list of the last occurence of the specified
+ * element, or -1 if the list does not contain this element.
+ */
+ public int lastIndexOf(Object o) {
+ ListIterator<E> e = listIterator(size());
+ if (o==null) {
+ while (e.hasPrevious())
+ if (e.previous()==null)
+ return e.nextIndex();
+ } else {
+ while (e.hasPrevious())
+ if (o.equals(e.previous()))
+ return e.nextIndex();
+ }
+ return -1;
+ }
+
+
+ // Bulk Operations
+
+ /**
+ * Removes all of the elements from this collection (optional operation).
+ * The collection will be empty after this call returns (unless it throws
+ * an exception).<p>
+ *
+ * This implementation calls <tt>removeRange(0, size())</tt>.<p>
+ *
+ * Note that this implementation throws an
+ * <tt>UnsupportedOperationException</tt> unless <tt>remove(int
+ * index)</tt> or <tt>removeRange(int fromIndex, int toIndex)</tt> is
+ * overridden.
+ *
+ * @throws UnsupportedOperationException if the <tt>clear</tt> method is
+ * not supported by this Collection.
+ */
+ public void clear() {
+ removeRange(0, size());
+ }
+
+ /**
+ * Inserts all of the elements in the specified collection into this list
+ * at the specified position (optional operation). Shifts the element
+ * currently at that position (if any) and any subsequent elements to the
+ * right (increases their indices). The new elements will appear in the
+ * list in the order that they are returned by the specified collection's
+ * iterator. The behavior of this operation is unspecified if the
+ * specified collection is modified while the operation is in progress.
+ * (Note that this will occur if the specified collection is this list,
+ * and it's nonempty.)<p>
+ *
+ * This implementation gets an iterator over the specified collection and
+ * iterates over it, inserting the elements obtained from the iterator
+ * into this list at the appropriate position, one at a time, using
+ * <tt>add(int, Object)</tt>. Many implementations will override this
+ * method for efficiency.<p>
+ *
+ * Note that this implementation throws an
+ * <tt>UnsupportedOperationException</tt> unless <tt>add(int, Object)</tt>
+ * is overridden.
+ *
+ * @return <tt>true</tt> if this list changed as a result of the call.
+ * @param index index at which to insert the first element from the
+ * specified collection.
+ * @param c elements to be inserted into this List.
+ *
+ * @throws UnsupportedOperationException if the <tt>addAll</tt> method is
+ * not supported by this list.
+ *
+ * @throws ClassCastException if the class of an element of the specified
+ * collection prevents it from being added to this List.
+ *
+ * @throws IllegalArgumentException some aspect an element of the
+ * specified collection prevents it from being added to this
+ * List.
+ *
+ * @throws IndexOutOfBoundsException index out of range (<tt>index < 0
+ * || index > size()</tt>).
+ *
+ * @throws NullPointerException if the specified collection is null.
+ */
+ public boolean addAll(int index, Collection<? extends E> c) {
+ boolean modified = false;
+ Iterator<? extends E> e = c.iterator();
+ while (e.hasNext()) {
+ add(index++, e.next());
+ modified = true;
+ }
+ return modified;
+ }
+
+
+ // Iterators
+
+ /**
+ * Returns an iterator over the elements in this list in proper
+ * sequence. <p>
+ *
+ * This implementation returns a straightforward implementation of the
+ * iterator interface, relying on the backing list's <tt>size()</tt>,
+ * <tt>get(int)</tt>, and <tt>remove(int)</tt> methods.<p>
+ *
+ * Note that the iterator returned by this method will throw an
+ * <tt>UnsupportedOperationException</tt> in response to its
+ * <tt>remove</tt> method unless the list's <tt>remove(int)</tt> method is
+ * overridden.<p>
+ *
+ * This implementation can be made to throw runtime exceptions in the face
+ * of concurrent modification, as described in the specification for the
+ * (protected) <tt>modCount</tt> field.
+ *
+ * @return an iterator over the elements in this list in proper sequence.
+ *
+ * @see #modCount
+ */
+ public Iterator<E> iterator() {
+ return new Itr();
+ }
+
+ /**
+ * Returns an iterator of the elements in this list (in proper sequence).
+ * This implementation returns <tt>listIterator(0)</tt>.
+ *
+ * @return an iterator of the elements in this list (in proper sequence).
+ *
+ * @see #listIterator(int)
+ */
+ public ListIterator<E> listIterator() {
+ return listIterator(0);
+ }
+
+ /**
+ * Returns a list iterator of the elements in this list (in proper
+ * sequence), starting at the specified position in the list. The
+ * specified index indicates the first element that would be returned by
+ * an initial call to the <tt>next</tt> method. An initial call to
+ * the <tt>previous</tt> method would return the element with the
+ * specified index minus one.<p>
+ *
+ * This implementation returns a straightforward implementation of the
+ * <tt>ListIterator</tt> interface that extends the implementation of the
+ * <tt>Iterator</tt> interface returned by the <tt>iterator()</tt> method.
+ * The <tt>ListIterator</tt> implementation relies on the backing list's
+ * <tt>get(int)</tt>, <tt>set(int, Object)</tt>, <tt>add(int, Object)</tt>
+ * and <tt>remove(int)</tt> methods.<p>
+ *
+ * Note that the list iterator returned by this implementation will throw
+ * an <tt>UnsupportedOperationException</tt> in response to its
+ * <tt>remove</tt>, <tt>set</tt> and <tt>add</tt> methods unless the
+ * list's <tt>remove(int)</tt>, <tt>set(int, Object)</tt>, and
+ * <tt>add(int, Object)</tt> methods are overridden.<p>
+ *
+ * This implementation can be made to throw runtime exceptions in the
+ * face of concurrent modification, as described in the specification for
+ * the (protected) <tt>modCount</tt> field.
+ *
+ * @param index index of the first element to be returned from the list
+ * iterator (by a call to the <tt>next</tt> method).
+ *
+ * @return a list iterator of the elements in this list (in proper
+ * sequence), starting at the specified position in the list.
+ *
+ * @throws IndexOutOfBoundsException if the specified index is out of
+ * range (<tt>index < 0 || index > size()</tt>).
+ *
+ * @see #modCount
+ */
+ public ListIterator<E> listIterator(final int index) {
+ if (index<0 || index>size())
+ throw new IndexOutOfBoundsException("Index: "+index);
+
+ return new ListItr(index);
+ }
+
+ private class Itr implements Iterator<E> {
+ /**
+ * Index of element to be returned by subsequent call to next.
+ */
+ int cursor = 0;
+
+ /**
+ * Index of element returned by most recent call to next or
+ * previous. Reset to -1 if this element is deleted by a call
+ * to remove.
+ */
+ int lastRet = -1;
+
+ /**
+ * The modCount value that the iterator believes that the backing
+ * List should have. If this expectation is violated, the iterator
+ * has detected concurrent modification.
+ */
+ int expectedModCount = modCount;
+
+ public boolean hasNext() {
+ return cursor != size();
+ }
+
+ public E next() {
+ checkForComodification();
+ try {
+ E next = get(cursor);
+ lastRet = cursor++;
+ return next;
+ } catch(IndexOutOfBoundsException e) {
+ checkForComodification();
+ throw new NoSuchElementException();
+ }
+ }
+
+ public void remove() {
+ if (lastRet == -1)
+ throw new IllegalStateException();
+ checkForComodification();
+
+ try {
+ AbstractList.this.remove(lastRet);
+ if (lastRet < cursor)
+ cursor--;
+ lastRet = -1;
+ expectedModCount = modCount;
+ } catch(IndexOutOfBoundsException e) {
+ throw new ConcurrentModificationException();
+ }
+ }
+
+ final void checkForComodification() {
+ if (modCount != expectedModCount)
+ throw new ConcurrentModificationException();
+ }
+ }
+
+ private class ListItr extends Itr implements ListIterator<E> {
+ ListItr(int index) {
+ cursor = index;
+ }
+
+ public boolean hasPrevious() {
+ return cursor != 0;
+ }
+
+ public E previous() {
+ checkForComodification();
+ try {
+ int i = cursor - 1;
+ E previous = get(i);
+ lastRet = cursor = i;
+ return previous;
+ } catch(IndexOutOfBoundsException e) {
+ checkForComodification();
+ throw new NoSuchElementException();
+ }
+ }
+
+ public int nextIndex() {
+ return cursor;
+ }
+
+ public int previousIndex() {
+ return cursor-1;
+ }
+
+ public void set(E o) {
+ if (lastRet == -1)
+ throw new IllegalStateException();
+ checkForComodification();
+
+ try {
+ AbstractList.this.set(lastRet, o);
+ expectedModCount = modCount;
+ } catch(IndexOutOfBoundsException e) {
+ throw new ConcurrentModificationException();
+ }
+ }
+
+ public void add(E o) {
+ checkForComodification();
+
+ try {
+ AbstractList.this.add(cursor++, o);
+ lastRet = -1;
+ expectedModCount = modCount;
+ } catch(IndexOutOfBoundsException e) {
+ throw new ConcurrentModificationException();
+ }
+ }
+ }
+
+ /**
+ * Returns a view of the portion of this list between <tt>fromIndex</tt>,
+ * inclusive, and <tt>toIndex</tt>, exclusive. (If <tt>fromIndex</tt> and
+ * <tt>toIndex</tt> are equal, the returned list is empty.) The returned
+ * list is backed by this list, so changes in the returned list are
+ * reflected in this list, and vice-versa. The returned list supports all
+ * of the optional list operations supported by this list.<p>
+ *
+ * This method eliminates the need for explicit range operations (of the
+ * sort that commonly exist for arrays). Any operation that expects a
+ * list can be used as a range operation by operating on a subList view
+ * instead of a whole list. For example, the following idiom removes a
+ * range of elements from a list:
+ * <pre>
+ * list.subList(from, to).clear();
+ * </pre>
+ * Similar idioms may be constructed for <tt>indexOf</tt> and
+ * <tt>lastIndexOf</tt>, and all of the algorithms in the
+ * <tt>Collections</tt> class can be applied to a subList.<p>
+ *
+ * The semantics of the list returned by this method become undefined if
+ * the backing list (i.e., this list) is <i>structurally modified</i> in
+ * any way other than via the returned list. (Structural modifications are
+ * those that change the size of the list, or otherwise perturb it in such
+ * a fashion that iterations in progress may yield incorrect results.)<p>
+ *
+ * This implementation returns a list that subclasses
+ * <tt>AbstractList</tt>. The subclass stores, in private fields, the
+ * offset of the subList within the backing list, the size of the subList
+ * (which can change over its lifetime), and the expected
+ * <tt>modCount</tt> value of the backing list. There are two variants
+ * of the subclass, one of which implements <tt>RandomAccess</tt>.
+ * If this list implements <tt>RandomAccess</tt> the returned list will
+ * be an instance of the subclass that implements <tt>RandomAccess</tt>.<p>
+ *
+ * The subclass's <tt>set(int, Object)</tt>, <tt>get(int)</tt>,
+ * <tt>add(int, Object)</tt>, <tt>remove(int)</tt>, <tt>addAll(int,
+ * Collection)</tt> and <tt>removeRange(int, int)</tt> methods all
+ * delegate to the corresponding methods on the backing abstract list,
+ * after bounds-checking the index and adjusting for the offset. The
+ * <tt>addAll(Collection c)</tt> method merely returns <tt>addAll(size,
+ * c)</tt>.<p>
+ *
+ * The <tt>listIterator(int)</tt> method returns a "wrapper object" over a
+ * list iterator on the backing list, which is created with the
+ * corresponding method on the backing list. The <tt>iterator</tt> method
+ * merely returns <tt>listIterator()</tt>, and the <tt>size</tt> method
+ * merely returns the subclass's <tt>size</tt> field.<p>
+ *
+ * All methods first check to see if the actual <tt>modCount</tt> of the
+ * backing list is equal to its expected value, and throw a
+ * <tt>ConcurrentModificationException</tt> if it is not.
+ *
+ * @param fromIndex low endpoint (inclusive) of the subList.
+ * @param toIndex high endpoint (exclusive) of the subList.
+ * @return a view of the specified range within this list.
+ * @throws IndexOutOfBoundsException endpoint index value out of range
+ * <tt>(fromIndex < 0 || toIndex > size)</tt>
+ * @throws IllegalArgumentException endpoint indices out of order
+ * <tt>(fromIndex > toIndex)</tt> */
+ public List<E> subList(int fromIndex, int toIndex) {
+ return (this instanceof RandomAccess ?
+ new RandomAccessSubList<E>(this, fromIndex, toIndex) :
+ new SubList<E>(this, fromIndex, toIndex));
+ }
+
+ // Comparison and hashing
+
+ /**
+ * Compares the specified object with this list for equality. Returns
+ * <tt>true</tt> if and only if the specified object is also a list, both
+ * lists have the same size, and all corresponding pairs of elements in
+ * the two lists are <i>equal</i>. (Two elements <tt>e1</tt> and
+ * <tt>e2</tt> are <i>equal</i> if <tt>(e1==null ? e2==null :
+ * e1.equals(e2))</tt>.) In other words, two lists are defined to be
+ * equal if they contain the same elements in the same order.<p>
+ *
+ * This implementation first checks if the specified object is this
+ * list. If so, it returns <tt>true</tt>; if not, it checks if the
+ * specified object is a list. If not, it returns <tt>false</tt>; if so,
+ * it iterates over both lists, comparing corresponding pairs of elements.
+ * If any comparison returns <tt>false</tt>, this method returns
+ * <tt>false</tt>. If either iterator runs out of elements before the
+ * other it returns <tt>false</tt> (as the lists are of unequal length);
+ * otherwise it returns <tt>true</tt> when the iterations complete.
+ *
+ * @param o the object to be compared for equality with this list.
+ *
+ * @return <tt>true</tt> if the specified object is equal to this list.
+ */
+ public boolean equals(Object o) {
+ if (o == this)
+ return true;
+ if (!(o instanceof List))
+ return false;
+
+ ListIterator<E> e1 = listIterator();
+ ListIterator e2 = ((List) o).listIterator();
+ while(e1.hasNext() && e2.hasNext()) {
+ E o1 = e1.next();
+ Object o2 = e2.next();
+ if (!(o1==null ? o2==null : o1.equals(o2)))
+ return false;
+ }
+ return !(e1.hasNext() || e2.hasNext());
+ }
+
+ /**
+ * Returns the hash code value for this list. <p>
+ *
+ * This implementation uses exactly the code that is used to define the
+ * list hash function in the documentation for the <tt>List.hashCode</tt>
+ * method.
+ *
+ * @return the hash code value for this list.
+ */
+ public int hashCode() {
+ int hashCode = 1;
+ Iterator<E> i = iterator();
+ while (i.hasNext()) {
+ E obj = i.next();
+ hashCode = 31*hashCode + (obj==null ? 0 : obj.hashCode());
+ }
+ return hashCode;
+ }
+
+ /**
+ * Removes from this list all of the elements whose index is between
+ * <tt>fromIndex</tt>, inclusive, and <tt>toIndex</tt>, exclusive.
+ * Shifts any succeeding elements to the left (reduces their index). This
+ * call shortens the ArrayList by <tt>(toIndex - fromIndex)</tt>
+ * elements. (If <tt>toIndex==fromIndex</tt>, this operation has no
+ * effect.)<p>
+ *
+ * This method is called by the <tt>clear</tt> operation on this list
+ * and its subLists. Overriding this method to take advantage of
+ * the internals of the list implementation can <i>substantially</i>
+ * improve the performance of the <tt>clear</tt> operation on this list
+ * and its subLists.<p>
+ *
+ * This implementation gets a list iterator positioned before
+ * <tt>fromIndex</tt>, and repeatedly calls <tt>ListIterator.next</tt>
+ * followed by <tt>ListIterator.remove</tt> until the entire range has
+ * been removed. <b>Note: if <tt>ListIterator.remove</tt> requires linear
+ * time, this implementation requires quadratic time.</b>
+ *
+ * @param fromIndex index of first element to be removed.
+ * @param toIndex index after last element to be removed.
+ */
+ protected void removeRange(int fromIndex, int toIndex) {
+ ListIterator<E> it = listIterator(fromIndex);
+ for (int i=0, n=toIndex-fromIndex; i<n; i++) {
+ it.next();
+ it.remove();
+ }
+ }
+
+ /**
+ * The number of times this list has been <i>structurally modified</i>.
+ * Structural modifications are those that change the size of the
+ * list, or otherwise perturb it in such a fashion that iterations in
+ * progress may yield incorrect results.<p>
+ *
+ * This field is used by the iterator and list iterator implementation
+ * returned by the <tt>iterator</tt> and <tt>listIterator</tt> methods.
+ * If the value of this field changes unexpectedly, the iterator (or list
+ * iterator) will throw a <tt>ConcurrentModificationException</tt> in
+ * response to the <tt>next</tt>, <tt>remove</tt>, <tt>previous</tt>,
+ * <tt>set</tt> or <tt>add</tt> operations. This provides
+ * <i>fail-fast</i> behavior, rather than non-deterministic behavior in
+ * the face of concurrent modification during iteration.<p>
+ *
+ * <b>Use of this field by subclasses is optional.</b> If a subclass
+ * wishes to provide fail-fast iterators (and list iterators), then it
+ * merely has to increment this field in its <tt>add(int, Object)</tt> and
+ * <tt>remove(int)</tt> methods (and any other methods that it overrides
+ * that result in structural modifications to the list). A single call to
+ * <tt>add(int, Object)</tt> or <tt>remove(int)</tt> must add no more than
+ * one to this field, or the iterators (and list iterators) will throw
+ * bogus <tt>ConcurrentModificationExceptions</tt>. If an implementation
+ * does not wish to provide fail-fast iterators, this field may be
+ * ignored.
+ */
+ protected transient int modCount = 0;
+}
+
+class SubList<E> extends AbstractList<E> {
+ private AbstractList<E> l;
+ private int offset;
+ private int size;
+ private int expectedModCount;
+
+ SubList(AbstractList<E> list, int fromIndex, int toIndex) {
+ if (fromIndex < 0)
+ throw new IndexOutOfBoundsException("fromIndex = " + fromIndex);
+ if (toIndex > list.size())
+ throw new IndexOutOfBoundsException("toIndex = " + toIndex);
+ if (fromIndex > toIndex)
+ throw new IllegalArgumentException("fromIndex(" + fromIndex +
+ ") > toIndex(" + toIndex + ")");
+ l = list;
+ offset = fromIndex;
+ size = toIndex - fromIndex;
+ expectedModCount = l.modCount;
+ }
+
+ public E set(int index, E element) {
+ rangeCheck(index);
+ checkForComodification();
+ return l.set(index+offset, element);
+ }
+
+ public E get(int index) {
+ rangeCheck(index);
+ checkForComodification();
+ return l.get(index+offset);
+ }
+
+ public int size() {
+ checkForComodification();
+ return size;
+ }
+
+ public void add(int index, E element) {
+ if (index<0 || index>size)
+ throw new IndexOutOfBoundsException();
+ checkForComodification();
+ l.add(index+offset, element);
+ expectedModCount = l.modCount;
+ size++;
+ modCount++;
+ }
+
+ public E remove(int index) {
+ rangeCheck(index);
+ checkForComodification();
+ E result = l.remove(index+offset);
+ expectedModCount = l.modCount;
+ size--;
+ modCount++;
+ return result;
+ }
+
+ protected void removeRange(int fromIndex, int toIndex) {
+ checkForComodification();
+ l.removeRange(fromIndex+offset, toIndex+offset);
+ expectedModCount = l.modCount;
+ size -= (toIndex-fromIndex);
+ modCount++;
+ }
+
+ public boolean addAll(Collection<? extends E> c) {
+ return addAll(size, c);
+ }
+
+ public boolean addAll(int index, Collection<? extends E> c) {
+ if (index<0 || index>size)
+ throw new IndexOutOfBoundsException(
+ "Index: "+index+", Size: "+size);
+ int cSize = c.size();
+ if (cSize==0)
+ return false;
+
+ checkForComodification();
+ l.addAll(offset+index, c);
+ expectedModCount = l.modCount;
+ size += cSize;
+ modCount++;
+ return true;
+ }
+
+ public Iterator<E> iterator() {
+ return listIterator();
+ }
+
+ public ListIterator<E> listIterator(final int index) {
+ checkForComodification();
+ if (index<0 || index>size)
+ throw new IndexOutOfBoundsException(
+ "Index: "+index+", Size: "+size);
+
+ return new ListIterator<E>() {
+ private ListIterator<E> i = l.listIterator(index+offset);
+
+ public boolean hasNext() {
+ return nextIndex() < size;
+ }
+
+ public E next() {
+ if (hasNext())
+ return i.next();
+ else
+ throw new NoSuchElementException();
+ }
+
+ public boolean hasPrevious() {
+ return previousIndex() >= 0;
+ }
+
+ public E previous() {
+ if (hasPrevious())
+ return i.previous();
+ else
+ throw new NoSuchElementException();
+ }
+
+ public int nextIndex() {
+ return i.nextIndex() - offset;
+ }
+
+ public int previousIndex() {
+ return i.previousIndex() - offset;
+ }
+
+ public void remove() {
+ i.remove();
+ expectedModCount = l.modCount;
+ size--;
+ modCount++;
+ }
+
+ public void set(E o) {
+ i.set(o);
+ }
+
+ public void add(E o) {
+ i.add(o);
+ expectedModCount = l.modCount;
+ size++;
+ modCount++;
+ }
+ };
+ }
+
+ public List<E> subList(int fromIndex, int toIndex) {
+ return new SubList<E>(this, fromIndex, toIndex);
+ }
+
+ private void rangeCheck(int index) {
+ if (index<0 || index>=size)
+ throw new IndexOutOfBoundsException("Index: "+index+
+ ",Size: "+size);
+ }
+
+ private void checkForComodification() {
+ if (l.modCount != expectedModCount)
+ throw new ConcurrentModificationException();
+ }
+}
+
+class RandomAccessSubList<E> extends SubList<E> implements RandomAccess {
+ RandomAccessSubList(AbstractList<E> list, int fromIndex, int toIndex) {
+ super(list, fromIndex, toIndex);
+ }
+
+ public List<E> subList(int fromIndex, int toIndex) {
+ return new RandomAccessSubList<E>(this, fromIndex, toIndex);
+ }
+}