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]