fr.vergne.collection.util

Class ListIterator<T>

java.lang.Object

fr.vergne.collection.util.ListIterator<T>

Type Parameters:

T -

All Implemented Interfaces:

Iterator<List<T>>

public class ListIterator<T>
extends Object
implements Iterator<List<T>>

A ListIterator aims at providing a way to generate an exhaustive sequence of possible Lists. Each List has the same size and is consistent regarding the order of its elements: if the ListIterator is configured with a set of Integers, a set of Strings and a set of Booleans, then the Lists generated always have an Integer, a String and a Boolean in the same order.

Typically, a ListIterator can be used to generate a set of vectors or possible configurations, where each configuration uses the same pattern of (heterogeneous) parameters.

Additional methods are provided such as getAmountOfPossibleLists() or isPossibleList(List) to be able to evaluate a given List regarding the full set, without having to generate this full set.

Author:

Matthieu Vergne

Constructor Summary

Constructors

Constructor and Description
ListIterator(boolean allowEmpty, Collection<? extends T>... possibleValues)
ListIterator(Collection<? extends T>... possibleValues)
ListIterator(Map<ObjectType,? extends Collection<T>> possibleValues)
ListIterator(Map<ObjectType,? extends Collection<T>> possibleValues, Map<ObjectType,T> observedValues, Collection<ObjectType> elementsConsidered)
ListIterator(Map<ObjectType,? extends Collection<T>> possibleValues, Map<ObjectType,T> observedValues, Collection<ObjectType> elementsConsidered, boolean allowEmpty)

Method Summary

Methods

Modifier and Type	Method and Description
BigInteger	getAmountOFGeneratedLists()
BigInteger	getAmountOfPossibleLists()
boolean	hasNext()
boolean	isPossibleList(List<Object> list)
static void	main(String[] args)
List<T>	next()
void	remove()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ListIterator

public ListIterator(Collection<? extends T>... possibleValues)

ListIterator

public ListIterator(boolean allowEmpty,
            Collection<? extends T>... possibleValues)

ListIterator

public ListIterator(Map<ObjectType,? extends Collection<T>> possibleValues)

ListIterator

public ListIterator(Map<ObjectType,? extends Collection<T>> possibleValues,
            Map<ObjectType,T> observedValues,
            Collection<ObjectType> elementsConsidered)

ListIterator

public ListIterator(Map<ObjectType,? extends Collection<T>> possibleValues,
            Map<ObjectType,T> observedValues,
            Collection<ObjectType> elementsConsidered,
            boolean allowEmpty)

Method Detail

getAmountOfPossibleLists

public BigInteger getAmountOfPossibleLists()

getAmountOFGeneratedLists

public BigInteger getAmountOFGeneratedLists()

isPossibleList

public boolean isPossibleList(List<Object> list)

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<List<T>>

next

public List<T> next()

Specified by:

next in interface Iterator<List<T>>

remove

public void remove()

Specified by:

remove in interface Iterator<List<T>>

main

public static void main(String[] args)