sky.monome.sequence.factory
Class GenericSequenceIteratorFactory<S extends Sequencer<S,B>,B extends ButtonManager<B>>

java.lang.Object
  sky.monome.sequence.factory.GenericSequenceIteratorFactory<S,B>

Type Parameters:

S - Type of sequencers that use sequence iterators built by this factory.

B - Type of button managers used by the sequencers that use sequence iterators built by this factory.

All Implemented Interfaces:

SequenceIteratorFactory<S,B>

public class GenericSequenceIteratorFactory<S extends Sequencer<S,B>,B extends ButtonManager<B>>
extends java.lang.Object
implements SequenceIteratorFactory<S,B>

Generic sequence iterator factory which can produce serially sequence iterators of the class specified at construction.

Since:

SkyMonome v1.1

Author:

PJ Skyman

Constructor Summary

GenericSequenceIteratorFactory(java.lang.Class<? extends SequenceIterator<S,B>> sequenceIteratorClass, java.lang.Object... argumentsForSequenceIterator)
Constructs a generic sequence iterator factory which can produce sequence iterators of the specified class and with the specified arguments common to all produced sequence iterators.

Method Summary

static <S extends Sequencer<S,B>,B extends ButtonManager<B>> GenericSequenceIteratorFactory<S,B>	createGenericSequenceIteratorFactory(java.lang.Class<? extends SequenceIterator> sequenceIteratorClass, java.lang.Object... argumentsForSequenceIterator) Creates a generic sequence iterator factory of specified types, and with the specified (not paramtrized) sequence iterator class and specified arguments.
SequenceIterator<S,B>	createSequenceIterator(java.lang.Object... arguments) Creates a sequence iterator with the help of optional arguments.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericSequenceIteratorFactory

public GenericSequenceIteratorFactory(java.lang.Class<? extends SequenceIterator<S,B>> sequenceIteratorClass,
                                      java.lang.Object... argumentsForSequenceIterator)
                               throws MonomeException

Constructs a generic sequence iterator factory which can produce sequence iterators of the specified class and with the specified arguments common to all produced sequence iterators.

Parameters:

sequenceIteratorClass - Class object that denotes the type of sequence iterators that will be produced by this factory.s

argumentsForSequenceIterator - Optional arguments that can be used for the sequence iterators factoring. These arguments must be specified in a good order so that a constructor is defined for the specified sequence iterator class with specified arguments.

Throws:

MonomeException - When no constructor is found for the specified class and specified arguments in the same order.

Method Detail

createSequenceIterator

public SequenceIterator<S,B> createSequenceIterator(java.lang.Object... arguments)
                                                                                             throws MonomeException

Creates a sequence iterator with the help of optional arguments.

Specified by:

createSequenceIterator in interface SequenceIteratorFactory<S extends Sequencer<S,B>,B extends ButtonManager<B>>

Parameters:

arguments - Optional arguments that can help the sequence iterator factoring. Note that this kind of factory does not use these arguments.

Returns:

A sequence iterator freshly created.

Throws:

MonomeException - When the sequence iterator factoring can't operate successfully.

createGenericSequenceIteratorFactory

public static <S extends Sequencer<S,B>,B extends ButtonManager<B>> GenericSequenceIteratorFactory<S,B> createGenericSequenceIteratorFactory(java.lang.Class<? extends SequenceIterator> sequenceIteratorClass,
                                                                                                                                             java.lang.Object... argumentsForSequenceIterator)
                                                                                                                                throws MonomeException

Creates a generic sequence iterator factory of specified types, and with the specified (not paramtrized) sequence iterator class and specified arguments. See the constructor doc to know more about these arguments. This static method is a convenience method that can create correctly parametrized factories.

Type Parameters:

S - Type of sequencer that use sequence iterators built by this factory.

B - Type of button manager used by sequencers that use sequence iterators built by this factory.

Parameters:

sequenceIteratorClass - (Not parametrized) sequence iterator class that denotes future factored sequence iterators.

argumentsForSequenceIterator - Arguments used to create the factory.

Returns:

A freshly created generic sequence iterator factory ready to be used to create sequence iterators.

Throws:

MonomeException - When the factory can't be created.

See Also:

GenericSequenceIteratorFactory(Class,Object...)