--- jsr166/src/main/java/util/AbstractQueue.java 2003/09/13 22:28:58 1.17 +++ jsr166/src/main/java/util/AbstractQueue.java 2003/10/05 22:59:21 1.19 @@ -21,7 +21,7 @@ package java.util; * insertion of null elements, along with methods {@link * Queue#peek}, {@link Queue#poll}, {@link Collection#size}, and a * {@link Collection#iterator} supporting {@link - * Iterator#remove}. Typically, additional methods will be overriden + * Iterator#remove}. Typically, additional methods will be overridden * as well. If these requirements cannot be met, consider instead * subclassing {@link AbstractCollection}. * @@ -101,4 +101,43 @@ public abstract class AbstractQueue while (poll() != null) ; } + + /** + * Adds all of the elements in the specified collection to this + * queue. Attempts to addAll of a queue to itself result in + * IllegalArgumentException. Further, the behavior of + * this operation is undefined if the specified collection is + * modified while the operation is in progress. + * + *

This implementation iterates over the specified collection, + * and adds each element returned by the iterator to this + * collection, in turn. A runtime exception encountered while + * trying to add an element (including, in particular, a + * null element) may result in only some of the elements + * having been successfully added when the associated exception is + * thrown. + * + * @param c collection whose elements are to be added to this collection. + * @return true if this collection changed as a result of the + * call. + * @throws NullPointerException if the specified collection, or + * any of its elements are null. + * @throws IllegalArgumentException if c is this queue. + * + * @see #add(Object) + */ + public boolean addAll(Collection c) { + if (c == null) + throw new NullPointerException(); + if (c == this) + throw new IllegalArgumentException(); + boolean modified = false; + Iterator e = c.iterator(); + while (e.hasNext()) { + if (add(e.next())) + modified = true; + } + return modified; + } + }