JML

org.jmlspecs.jmlunit.strategies
Class AbstractExtensibleStrategyDecorator

java.lang.Object
  extended byorg.jmlspecs.jmlunit.strategies.AbstractExtensibleStrategyDecorator
All Implemented Interfaces:
StrategyType
Direct Known Subclasses:
CloneableObjectAbstractExtensibleStrategyDecorator, ImmutableObjectExtensibleStrategyDecorator

public abstract class AbstractExtensibleStrategyDecorator
extends Object
implements StrategyType

A decorator for strategies that allows for easy extension to the test data of the underlying strategy.

This type provides an extension mechanism that is easier to use than a composite. To extend the test data, make a subclass that overrides the addData() method; this method provides the additional data for testing.

Author:
Gary T. Leavens

Field Summary
private  StrategyType addedData
          The added data, returned after the default data in the iterations.
private  StrategyType defaultData
          The default data, returned first in the iterations.
 
Constructor Summary
AbstractExtensibleStrategyDecorator(StrategyType strat)
           
 
Method Summary
protected  Object[] addData()
          Subclasses can override this to make simple extensions to the data used.
protected abstract  StrategyType addedDataStrategy(Object[] added)
           
 IndefiniteIterator iterator()
          Compute a fresh indefinite iterator, which can be used to provide test data of some reference type.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

defaultData

private final StrategyType defaultData
The default data, returned first in the iterations.


addedData

private final StrategyType addedData
The added data, returned after the default data in the iterations.

Constructor Detail

AbstractExtensibleStrategyDecorator

public AbstractExtensibleStrategyDecorator(StrategyType strat)
Method Detail

addedDataStrategy

protected abstract StrategyType addedDataStrategy(Object[] added)

iterator

public IndefiniteIterator iterator()
Description copied from interface: StrategyType
Compute a fresh indefinite iterator, which can be used to provide test data of some reference type. The indefinite iterator returned should be freshly created. Usually it should not be at its end. However, in rare cases it might make sense to have an empty iterator be computed (e.g., by filtering).

Specified by:
iterator in interface StrategyType

addData

protected Object[] addData()
Subclasses can override this to make simple extensions to the data used. This should only be called once when the object is being construted.


JML

JML is Copyright (C) 1998-2002 by Iowa State University and is distributed under the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This release depends on code from the MultiJava project and is based in part on the Kopi project Copyright (C) 1990-99 DMS Decision Management Systems Ges.m.b.H.