--- jsr166/src/main/java/util/AbstractQueue.java 2003/07/26 13:17:51 1.5 +++ jsr166/src/main/java/util/AbstractQueue.java 2003/08/04 01:50:33 1.11 @@ -7,24 +7,62 @@ package java.util; /** - * AbstractQueue provides default implementations of add, remove, and - * element based on offer, poll, and peek, respectively but that throw - * exceptions instead of indicating failure via false or null returns. - * The provided implementations all assume that the base implementation + * AbstractQueue provides default implementations of + * {@link #add add}, {@link #remove remove}, and {@link #element element} + * based on + * {@link #offer offer}, {@link #poll poll}, and {@link #peek peek}, + * respectively but that + * throw exceptions instead of indicating failure via false or + * null returns. + *
The provided implementations all assume that the base implementation
* does not allow null elements.
* @since 1.5
* @author Doug Lea
*/
-
-public abstract class AbstractQueue
+ * This implementation iterates over the specified collection, and adds
+ * each object returned by the iterator to this collection, in turn.
+ *
+ * @param c collection whose elements are to be added to this queue
+ * @return true if this collection changed as a result of the
+ * call.
+ * @throws NullPointerException if c or any element in c
+ * is null
+ *
+ */
+ public boolean addAll(Collection extends E> c) {
+ return super.addAll(c);
+ }
+
+ /** @throws NoSuchElementException {@inheritDoc} */
public E remove() {
E x = poll();
if (x != null)
@@ -33,6 +71,7 @@ public abstract class AbstractQueue This implementation repeatedly invokes {@link #poll poll} until it
+ * returns null.
+ */
public void clear() {
while (poll() != null)
;
}
+ // XXX Remove this redundant declaration, pending response from Neal Gafter.
public abstract Iterator