rsitze 2004/10/06 11:40:57
Modified: discovery/src/java/org/apache/commons/discovery
ResourceNameIterator.java
Log:
Revision Changes Path
1.5 +12 -0
jakarta-commons/discovery/src/java/org/apache/commons/discovery/ResourceNameIterator.java
Index: ResourceNameIterator.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/discovery/src/java/org/apache/commons/discovery/ResourceNameIterator.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ResourceNameIterator.java 27 Feb 2004 23:36:54 -0000 1.4
+++ ResourceNameIterator.java 6 Oct 2004 18:40:57 -0000 1.5
@@ -17,15 +17,27 @@
/**
+ * Iterate over resource names.
+ * The semantics are somewhat unusual, for better or worse.
+ * hasNext is presumed to be destructive to the current state,
+ * each call will 'move' the cursor.
+ * nextResourceName() MUST BE non-destructive,
+ * it does not change the state.
+ *
+ * TODO: FIX iterator logic/semantics, possibly add 'currentResourceName()'.
+ *
* @author Richard A. Sitze
*/
public interface ResourceNameIterator
{
/**
+ * hasNext()
*/
public boolean hasNext();
/**
+ * nextResourceName() returns the name of the next resource,
+ * and MUST be non-destructive. Repeated calls
*/
public String nextResourceName();
}
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
