scolebourne 2004/05/22 04:32:06
Modified: collections/src/java/org/apache/commons/collections Tag:
COLLECTIONS_2_1_BRANCH IteratorUtils.java
Log:
Deprecate those methods that are incompatible with v3.0 and later
Revision Changes Path
No revision
No revision
1.4.2.1 +13 -5 jakarta-commons/collections/src/java/org/apache/commons/collections/IteratorUtils.java
Index: IteratorUtils.java
===================================================================
RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/IteratorUtils.java,v
retrieving revision 1.4
retrieving revision 1.4.2.1
diff -u -r1.4 -r1.4.2.1
--- IteratorUtils.java 12 Oct 2002 22:15:18 -0000 1.4
+++ IteratorUtils.java 22 May 2004 11:32:06 -0000 1.4.2.1
@@ -98,11 +98,13 @@
// public classes allow invalid states
/**
- * An iterator over no elements
+ * An iterator over no elements.
+ * @deprecated Use <code>EmptyIterator.INSTANCE</code>
*/
public static final Iterator EMPTY_ITERATOR = new EmptyIterator();
/**
* A list iterator over no elements
+ * @deprecated Use <code>EmptyListIterator.INSTANCE</code>
*/
public static final ListIterator EMPTY_LIST_ITERATOR = new EmptyListIterator();
@@ -119,6 +121,7 @@
* nothing.
*
* @return an iterator over nothing
+ * @deprecated Use <code>EmptyIterator.INSTANCE</code>
*/
public static Iterator emptyIterator() {
return EMPTY_ITERATOR;
@@ -131,6 +134,7 @@
* over nothing.
*
* @return a list iterator over nothing
+ * @deprecated Use <code>EmptyListIterator.INSTANCE</code>
*/
public static ListIterator emptyListIterator() {
return EMPTY_LIST_ITERATOR;
@@ -144,6 +148,7 @@
*
* @param object the single object over which to iterate
* @return a singleton iterator over the object
+ * @deprecated Use <code>new SingletonIterator(object)</code>
*/
public static Iterator singletonIterator(Object object) {
return new SingletonIterator(object);
@@ -168,6 +173,7 @@
* @param array the array over which to iterate
* @return an iterator over the array
* @throws NullPointerException if array is null
+ * @deprecated Use <code>new ArrayIterator(array)</code>
*/
public static Iterator arrayIterator(Object[] array) {
return new ArrayIterator(array);
@@ -181,6 +187,7 @@
* @return an iterator over part of the array
* @throws IllegalArgumentException if array bounds are invalid
* @throws NullPointerException if array is null
+ * @deprecated Use <code>new ArrayIterator(array,start)</code>
*/
public static Iterator arrayIterator(Object[] array, int start) {
return new ArrayIterator(array, start);
@@ -195,6 +202,7 @@
* @return an iterator over part of the array
* @throws IllegalArgumentException if array bounds are invalid
* @throws NullPointerException if array is null
+ * @deprecated Use <code>new ArrayIterator(array,start,end)</code>
*/
public static Iterator arrayIterator(Object[] array, int start, int end) {
return new ArrayIterator(array, start, end);
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
|