net.sf.javagimmicks.collections.Ring Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gimmicks Show documentation

Utility classes, APIs and tools for Java

There is a newer version: 0.99-alpha1

package net.sf.javagimmicks.collections;

import java.util.Collection;

/**
 * Defines a {@link Collection}-like data structure that organizes elements
 * within a ring structure, so there is a well-defined order but no index,
 * beginning or end.
 * 
 * The interface fully extends the {@link Collection} interface but additionally
 * extends {@link RingCursorProvider} that allows to create a {@link RingCursor}
 * for it which is a special kind of iterator that defines no beginning or end
 * but operations to modify or traverse the underlying data structure.
 * 
 * @param 
 *           the type of elements this {@link Ring} can contain
 */
public interface Ring extends Collection, RingCursorProvider
{}